Skip to content

Conversation

@wolveix
Copy link
Contributor

@wolveix wolveix commented Oct 1, 2025

Hello!

We rely on this library for various automations and internal tools, so the announcement of Data Sources from Notion concerned me (with regards to when it may be implemented here).

This is my first time working directly with Notion's API (outside of webhooks), so my apologies if anything seems odd! I ran through the upgrade guide and implemented all of the changes I could see.

Do note that I haven't added all tests for data sources yet.

This closes #195.

Copy link

@y-kawawa y-kawawa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@wolveix Thanks for the PR! I’ve left a comment.


type DatabaseService interface {
Create(ctx context.Context, request *DatabaseCreateRequest) (*Database, error)
Query(context.Context, DatabaseID, *DatabaseQueryRequest) (*DatabaseQueryResponse, error)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

While this depends on the official Notion fix, removing it counts as a breaking change.
It might be a good idea to update the module path to v2, in line with semantic versioning.
Alternatively, if you’d prefer not to move to v2, another option could be to provide two notionVersions - 2022-06-28 and 2025-09-03 - and support both.
Of course, that would increase maintenance costs, so it also depends on the policy of this repository.

Copy link
Contributor Author

@wolveix wolveix Oct 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the comment! From reading Notion's release, it doesn't sound like they'll be supporting database querying at all moving forward (as I understood it, even querying with the old API version will outright fail with new databases).

I think moving to v2 makes the most sense. Though in saying that, I do believe this library has similarly had breaking changes in the past (the last commit in the repo).

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the response.
I also feel that moving to v2 would be a good option, but if this repository has followed a different approach in the past, it might be better to keep going that way.

Copy link

@y-kawawa y-kawawa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@wolveix Additional comment.

@JanRuettinger
Copy link

Does it get merged or should we fork it and maintain it ourselves?

@wolveix
Copy link
Contributor Author

wolveix commented Jan 19, 2026

Thanks for bumping this @JanRuettinger! As a last ditch effort, I've just emailed the author (@jomei) asking whether they'd consider taking on additional maintainers (I just went through this same process with Huma).

If I don't hear back soon, I'd be more than happy to switch the branches around on my repo and update package references accordingly :)

I have a lot of great ideas for this library, especially around ease-of-use. I've built an entire wrapper library around this one to help simplify working with Notion webhooks (introduced last year) as well as ease model translation between native Go types and Notion models. Frankly I think these should all be part of the library itself.

@wolveix wolveix deleted the branch jomei:main January 20, 2026 17:28
@wolveix wolveix closed this Jan 20, 2026
@wolveix wolveix deleted the main branch January 20, 2026 17:28
@wolveix wolveix restored the main branch January 20, 2026 17:28
@wolveix wolveix reopened this Jan 20, 2026
@wolveix wolveix deleted the branch jomei:main January 20, 2026 17:29
@wolveix wolveix closed this Jan 20, 2026
@wolveix wolveix deleted the main branch January 20, 2026 17:29
@wolveix wolveix restored the main branch January 20, 2026 17:30
@wolveix wolveix reopened this Jan 20, 2026
@wolveix
Copy link
Contributor Author

wolveix commented Jan 20, 2026

Sorry, not trying to close the PR, was just trying to rename the branch in my repo. Annoying.

@wolveix
Copy link
Contributor Author

wolveix commented Jan 20, 2026

I've updated package references, so you can now replace github.com/jomei/notionapi with github.com/wolveix/notion-go. I just created release v1.14.1, which applies a bunch of linting rules. I intend to further expand on the library's functionality as mentioned in a previous comment, and will also review the pending PRs in this repo :)

I will likely also rename all known abbreviations/acronyms to block capitals, e.g. baseUrl will become baseURL. This will therefore be a breaking change, so I may delay this for a v2.0.0 release. If there's anything in particular that people are after from Notion, let me know!

And I'd be happy to PR these back to this repo as and when @jomei has the time :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Do you have any plans to update API version from 2022-06-28 to 2025-09-03?

3 participants