norbix_hub library
Account-scoped Norbix Hub (https://hub.norbix.ai).
Resources are exposed directly on NorbixHub:
final hub = NorbixHub();
await hub.projects.getProjects();
await hub.database.getDatabaseSchemas();
Classes
- AccountsResource
- Account profile, team, licenses, regions, status, Stripe billing, AI chat.
- AiIntegrationsResource
- LLM and MCP integrations (configure, test, enable/disable).
- ApiKeysResource
- API keys for the current project / environment.
- AuthResource
- Authentication: API keys, access tokens, OAuth providers.
- ContactsResource
- Membership contacts: identities, merge and marketing consent.
- DatabaseResource
- Database schemas, taxonomies, aggregates, integrations, schema triggers.
- EchoResource
- Health-check / echo endpoint.
- EmailNotificationsResource
- Email templates, campaigns, integrations, signatures, footers, settings.
- EmailUnsubscribeResource
- RFC-8058 one-click unsubscribe endpoint.
- EnvironmentsResource
- Project environments: list, create, and delete the named environments a project owns (PROD plus any TEST/STAGING/… the user adds).
- FilesResource
- File storage integrations and triggers.
- HttpClientDriver
-
Default driver, backed by
package:http. - HttpDriver
-
Pluggable HTTP driver. Default is the standard
package:httpclient. Tests injectMockClient; Flutter apps can swap indioor a custom pinned-cert client by implementing this interface. - HttpDriverRequest
- HttpDriverResponse
- InternalsResource
- Internal Norbix utilities (typegen, debug).
- LogsResource
- Logging integrations.
- MembershipResource
- Membership integrations, roles, policies, triggers.
- NorbixConfig
- Base configuration for any Norbix SDK client.
- NorbixErrorItem
-
One error inside the gateway's
responseStatus.errorslist. - NorbixHub
- Norbix Hub client.
- PaymentsResource
- Payments integrations and triggers.
- ProjectsResource
- Account projects: CRUD, settings, notifications, tokens.
- PushNotificationsResource
- Push templates, integrations, devices.
- Resource
-
Base class for every resource module (e.g.
UsersResource,ProjectsResource). Holds the shared Transport so resources can be constructed lazily by the client. - ResourcesResource
- Reference resolution for cross-module resources.
- SchedulerResource
- Scheduled tasks.
- SmsNotificationsResource
- SMS notifications: integrations, templates and campaigns.
- Transport
-
Internal HTTP transport used by every resource. You should not construct
this directly — the per-host clients (
NorbixApi,NorbixHub) own one. - UserNotificationPreferencesResource
- Per-user notification opt-ins.
- WebhooksResource
- Outbound webhook destinations and integration settings.
Constants
- kNorbixHubDefaultBaseUrl → const String
- Default base URL for the public Norbix Hub host.
-
kNorbixRegionalDefaultBaseUrls
→ const Set<
String> -
SDK default hosts eligible for regional base-URL composition. A region
only rewrites these well-known hosts (
kNorbixApiDefaultBaseUrl,kNorbixHubDefaultBaseUrl); user-supplied base URLs are never touched.
Functions
-
composeRegionalBaseUrl(
String baseUrl, String region) → String -
Compose the regional base URL for
baseUrl: whenbaseUrlis one of the SDK defaults theregioncode becomes a subdomain prefix (e.g.https://nb-eu-germany.api.norbix.ai); any other base URL is returned unchanged. -
norbixBodySaysItFailed(
Object? body) → bool -
truewhen the body carriesresponseStatus.isSuccess == false.
Exceptions / Errors
- NorbixAuthError
- 401 / 403 — invalid or missing credentials.
- NorbixClientError
- 4xx other than 401/403/404/429.
- NorbixError
- Base exception thrown by every Norbix call.
- NorbixNotFoundError
- 404 — resource does not exist.
- NorbixRateLimitError
-
429 — rate limited.
Retry-After(seconds) is in details when present. - NorbixServerError
- 5xx — server-side failure.
- NorbixTransportError
- Network or timeout failure (no HTTP status).