@authhero/adapter-interfaces 3.2.0 → 3.4.0

package/dist/types/adapters/ActionVersions.d.ts

@@ -1,5 +1,6 @@
 import { ActionVersion, ActionVersionInsert, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListActionVersionsResponse extends Totals {
     versions: ActionVersion[];
 }
@@ -9,7 +10,7 @@ export interface ActionVersionsAdapter {
      * sequential `number` per action_id and clears the `deployed` flag on any
      * prior versions when the new one is created with `deployed: true`.
      */
-    create: (tenant_id: string, version: ActionVersionInsert) => Promise<ActionVersion>;
+    create: (tenant_id: string, version: ActionVersionInsert, options?: CreateOptions) => Promise<ActionVersion>;
     get: (tenant_id: string, action_id: string, version_id: string) => Promise<ActionVersion | null>;
     list: (tenant_id: string, action_id: string, params?: ListParams) => Promise<ListActionVersionsResponse>;
     /**

package/dist/types/adapters/Actions.d.ts

@@ -1,10 +1,11 @@
 import { Action, ActionInsert, ActionUpdate, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListActionsResponse extends Totals {
     actions: Action[];
 }
 export interface ActionsAdapter {
-    create: (tenant_id: string, action: ActionInsert) => Promise<Action>;
+    create: (tenant_id: string, action: ActionInsert, options?: CreateOptions) => Promise<Action>;
     get: (tenant_id: string, action_id: string) => Promise<Action | null>;
     update: (tenant_id: string, action_id: string, action: ActionUpdate) => Promise<boolean>;
     remove: (tenant_id: string, action_id: string) => Promise<boolean>;

package/dist/types/adapters/AuthenticationMethods.d.ts

@@ -1,6 +1,7 @@
 import { AuthenticationMethod, AuthenticationMethodInsert, AuthenticationMethodUpdate } from "../types/AuthenticationMethod";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface AuthenticationMethodsAdapter {
-    create: (tenant_id: string, method: AuthenticationMethodInsert) => Promise<AuthenticationMethod>;
+    create: (tenant_id: string, method: AuthenticationMethodInsert, options?: CreateOptions) => Promise<AuthenticationMethod>;
     get: (tenant_id: string, method_id: string) => Promise<AuthenticationMethod | null>;
     getByCredentialId: (tenant_id: string, credential_id: string) => Promise<AuthenticationMethod | null>;
     list: (tenant_id: string, user_id: string) => Promise<AuthenticationMethod[]>;

package/dist/types/adapters/ClientGrants.d.ts

@@ -1,10 +1,11 @@
 import { ListParams } from "../types/ListParams";
 import { ClientGrant, ClientGrantInsert, Totals } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListClientGrantsResponse extends Totals {
     client_grants: ClientGrant[];
 }
 export interface ClientGrantsAdapter {
-    create(tenant_id: string, params: ClientGrantInsert): Promise<ClientGrant>;
+    create(tenant_id: string, params: ClientGrantInsert, options?: CreateOptions): Promise<ClientGrant>;
     get(tenant_id: string, id: string): Promise<ClientGrant | null>;
     list(tenant_id: string, params?: ListParams): Promise<ListClientGrantsResponse>;
     update(tenant_id: string, id: string, clientGrant: Partial<ClientGrantInsert>): Promise<boolean>;

package/dist/types/adapters/Clients.d.ts

@@ -1,5 +1,6 @@
 import { Client, ClientInsert, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 /**
  * Result from getByClientId including tenant_id since client_id alone
  * is used to look up the client across all tenants
@@ -8,7 +9,7 @@ export interface ClientWithTenantId extends Client {
     tenant_id: string;
 }
 export interface ClientsAdapter {
-    create(tenant_id: string, params: ClientInsert): Promise<Client>;
+    create(tenant_id: string, params: ClientInsert, options?: CreateOptions): Promise<Client>;
     get(tenant_id: string, client_id: string): Promise<Client | null>;
     /**
      * Get a client by client_id only (without tenant_id).

package/dist/types/adapters/Connections.d.ts

@@ -1,10 +1,10 @@
-import { Connection, ConnectionInsert, Totals } from "../types";
+import { Connection, ConnectionInsert, CreateOptions, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
 export interface ListConnectionsResponse extends Totals {
     connections: Connection[];
 }
 export interface ConnectionsAdapter {
-    create(tenant_id: string, params: ConnectionInsert): Promise<Connection>;
+    create(tenant_id: string, params: ConnectionInsert, options?: CreateOptions): Promise<Connection>;
     remove(tenant_id: string, connection_id: string): Promise<boolean>;
     get(tenant_id: string, connection_id: string): Promise<Connection | null>;
     update(tenant_id: string, connection_id: string, params: Partial<ConnectionInsert>): Promise<boolean>;

package/dist/types/adapters/CustomDomains.d.ts

@@ -1,6 +1,7 @@
 import { CustomDomain, CustomDomainCertificateUpload, CustomDomainInsert, CustomDomainWithTenantId } from "../types/CustomDomain";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface CustomDomainsAdapter {
-    create: (tenant_id: string, custom_domain: CustomDomainInsert) => Promise<CustomDomain>;
+    create: (tenant_id: string, custom_domain: CustomDomainInsert, options?: CreateOptions) => Promise<CustomDomain>;
     get: (tenant_id: string, id: string) => Promise<CustomDomain | null>;
     getByDomain: (domain: string) => Promise<CustomDomainWithTenantId | null>;
     list: (tenant_id: string) => Promise<CustomDomain[]>;

package/dist/types/adapters/CustomText.d.ts

@@ -1,4 +1,5 @@
 import { CustomText, PromptScreen } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface CustomTextAdapter {
     /**
      * Get custom text for a specific prompt screen and language
@@ -7,7 +8,7 @@ export interface CustomTextAdapter {
     /**
      * Set custom text for a specific prompt screen and language
      */
-    set: (tenant_id: string, prompt: PromptScreen, language: string, customText: CustomText) => Promise<void>;
+    set: (tenant_id: string, prompt: PromptScreen, language: string, customText: CustomText, options?: CreateOptions) => Promise<void>;
     /**
      * Delete custom text for a specific prompt screen and language
      */

package/dist/types/adapters/EmailProviders.d.ts

@@ -1,7 +1,8 @@
 import { EmailProvider } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface EmailProvidersAdapter {
     update: (tenant_id: string, emailProvider: Partial<EmailProvider>) => Promise<void>;
-    create: (tenant_id: string, emailProvider: EmailProvider) => Promise<void>;
+    create: (tenant_id: string, emailProvider: EmailProvider, options?: CreateOptions) => Promise<void>;
     get: (tenant_id: string) => Promise<EmailProvider | null>;
     remove: (tenant_id: string) => Promise<void>;
 }

package/dist/types/adapters/EmailTemplates.d.ts

@@ -1,8 +1,9 @@
 import { EmailTemplate, EmailTemplateName } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface EmailTemplatesAdapter {
     get: (tenant_id: string, templateName: EmailTemplateName) => Promise<EmailTemplate | null>;
     list: (tenant_id: string) => Promise<EmailTemplate[]>;
-    create: (tenant_id: string, template: EmailTemplate) => Promise<EmailTemplate>;
+    create: (tenant_id: string, template: EmailTemplate, options?: CreateOptions) => Promise<EmailTemplate>;
     update: (tenant_id: string, templateName: EmailTemplateName, template: Partial<EmailTemplate>) => Promise<boolean>;
     remove: (tenant_id: string, templateName: EmailTemplateName) => Promise<boolean>;
 }

package/dist/types/adapters/Flows.d.ts

@@ -1,10 +1,11 @@
 import { Flow, FlowInsert, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListFlowsResponse extends Totals {
     flows: Flow[];
 }
 export interface FlowsAdapter {
-    create(tenant_id: string, params: FlowInsert): Promise<Flow>;
+    create(tenant_id: string, params: FlowInsert, options?: CreateOptions): Promise<Flow>;
     get(tenant_id: string, flow_id: string): Promise<Flow | null>;
     remove(tenant_id: string, flow_id: string): Promise<boolean>;
     update(tenant_id: string, flow_id: string, flow: Partial<FlowInsert>): Promise<Flow | null>;

package/dist/types/adapters/Forms.d.ts

@@ -1,10 +1,11 @@
 import { Form, FormInsert, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListFormsResponse extends Totals {
     forms: Form[];
 }
 export interface FormsAdapter {
-    create(tenant_id: string, params: FormInsert): Promise<Form>;
+    create(tenant_id: string, params: FormInsert, options?: CreateOptions): Promise<Form>;
     get(tenant_id: string, form_id: string): Promise<Form | null>;
     remove(tenant_id: string, form_id: string): Promise<boolean>;
     update(tenant_id: string, form_id: string, form: Partial<FormInsert>): Promise<boolean>;

package/dist/types/adapters/HookCode.d.ts

@@ -1,6 +1,7 @@
 import { HookCode, HookCodeInsert } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface HookCodeAdapter {
-    create: (tenant_id: string, hookCode: HookCodeInsert) => Promise<HookCode>;
+    create: (tenant_id: string, hookCode: HookCodeInsert, options?: CreateOptions) => Promise<HookCode>;
     get: (tenant_id: string, id: string) => Promise<HookCode | null>;
     update: (tenant_id: string, id: string, hookCode: Partial<HookCodeInsert>) => Promise<boolean>;
     remove: (tenant_id: string, id: string) => Promise<boolean>;

package/dist/types/adapters/Hooks.d.ts

@@ -1,10 +1,11 @@
 import { Hook, HookInsert, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListHooksResponse extends Totals {
     hooks: Hook[];
 }
 export interface HooksAdapter {
-    create: (tenant_id: string, hook: HookInsert) => Promise<Hook>;
+    create: (tenant_id: string, hook: HookInsert, options?: CreateOptions) => Promise<Hook>;
     remove: (tenant_id: string, hook_id: string) => Promise<boolean>;
     get: (tenant_id: string, hook_id: string) => Promise<Hook | null>;
     update: (tenant_id: string, hook_id: string, hook: Partial<HookInsert>) => Promise<boolean>;

package/dist/types/adapters/Invites.d.ts

@@ -1,10 +1,11 @@
 import { Invite, InviteInsert, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListInvitesResponse extends Totals {
     invites: Invite[];
 }
 export interface InvitesAdapter {
-    create(tenant_id: string, params: InviteInsert): Promise<Invite>;
+    create(tenant_id: string, params: InviteInsert, options?: CreateOptions): Promise<Invite>;
     get(tenant_id: string, id: string): Promise<Invite | null>;
     remove(tenant_id: string, id: string): Promise<boolean>;
     list(tenant_id: string, params?: ListParams): Promise<ListInvitesResponse>;

package/dist/types/adapters/Keys.d.ts

@@ -1,10 +1,11 @@
 import { SigningKey, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListKeysResponse extends Totals {
     signingKeys: SigningKey[];
 }
 export interface KeysAdapter {
-    create: (key: SigningKey) => Promise<void>;
+    create: (key: SigningKey, options?: CreateOptions) => Promise<void>;
     list: (params?: ListParams) => Promise<ListKeysResponse>;
     update: (kid: string, key: Partial<Omit<SigningKey, "kid">>) => Promise<boolean>;
 }

package/dist/types/adapters/LogStreams.d.ts

@@ -1,6 +1,7 @@
 import { LogStream, LogStreamInsert } from "../types/LogStream";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface LogStreamsAdapter {
-    create(tenant_id: string, params: LogStreamInsert): Promise<LogStream>;
+    create(tenant_id: string, params: LogStreamInsert, options?: CreateOptions): Promise<LogStream>;
     get(tenant_id: string, id: string): Promise<LogStream | null>;
     list(tenant_id: string): Promise<LogStream[]>;
     update(tenant_id: string, id: string, params: Partial<LogStream>): Promise<boolean>;

package/dist/types/adapters/MigrationSources.d.ts

@@ -1,6 +1,7 @@
 import { MigrationSource, MigrationSourceInsert } from "../types/MigrationSource";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface MigrationSourcesAdapter {
-    create: (tenant_id: string, migration_source: MigrationSourceInsert) => Promise<MigrationSource>;
+    create: (tenant_id: string, migration_source: MigrationSourceInsert, options?: CreateOptions) => Promise<MigrationSource>;
     get: (tenant_id: string, id: string) => Promise<MigrationSource | null>;
     list: (tenant_id: string) => Promise<MigrationSource[]>;
     remove: (tenant_id: string, id: string) => Promise<boolean>;

package/dist/types/adapters/OrganizationConnections.d.ts

@@ -1,6 +1,7 @@
 import { OrganizationConnection, OrganizationConnectionInsert } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface OrganizationConnectionsAdapter {
-    create(tenant_id: string, organization_id: string, params: OrganizationConnectionInsert): Promise<OrganizationConnection>;
+    create(tenant_id: string, organization_id: string, params: OrganizationConnectionInsert, options?: CreateOptions): Promise<OrganizationConnection>;
     list(tenant_id: string, organization_id: string): Promise<OrganizationConnection[]>;
     get(tenant_id: string, organization_id: string, connection_id: string): Promise<OrganizationConnection | null>;
     update(tenant_id: string, organization_id: string, connection_id: string, params: Partial<Omit<OrganizationConnectionInsert, "connection_id">>): Promise<OrganizationConnection | null>;

package/dist/types/adapters/Organizations.d.ts

@@ -1,10 +1,11 @@
 import { Organization, OrganizationInsert, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListOrganizationsResponse extends Totals {
     organizations: Organization[];
 }
 export interface OrganizationsAdapter {
-    create(tenant_id: string, params: OrganizationInsert): Promise<Organization>;
+    create(tenant_id: string, params: OrganizationInsert, options?: CreateOptions): Promise<Organization>;
     get(tenant_id: string, id: string): Promise<Organization | null>;
     remove(tenant_id: string, id: string): Promise<boolean>;
     list(tenant_id: string, params?: ListParams): Promise<ListOrganizationsResponse>;

package/dist/types/adapters/Passwords.d.ts

@@ -1,6 +1,7 @@
 import { Password, PasswordInsert } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface PasswordsAdapter {
-    create: (tenant_id: string, params: PasswordInsert) => Promise<Password>;
+    create: (tenant_id: string, params: PasswordInsert, options?: CreateOptions) => Promise<Password>;
     update: (tenant_id: string, params: PasswordInsert) => Promise<boolean>;
     get: (tenant_id: string, user_id: string) => Promise<Password | null>;
     list: (tenant_id: string, user_id: string, limit?: number) => Promise<Password[]>;

package/dist/types/adapters/ProxyRoutes.d.ts

@@ -1,4 +1,5 @@
 import { ProxyRoute, ProxyRouteInsert, ProxyRouteUpdate } from "../types/ProxyRoute";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListProxyRoutesParams {
     page?: number;
     per_page?: number;
@@ -11,7 +12,7 @@ export interface ListProxyRoutesResult {
     length: number;
 }
 export interface ProxyRoutesAdapter {
-    create(tenant_id: string, route: ProxyRouteInsert): Promise<ProxyRoute>;
+    create(tenant_id: string, route: ProxyRouteInsert, options?: CreateOptions): Promise<ProxyRoute>;
     get(tenant_id: string, id: string): Promise<ProxyRoute | null>;
     list(tenant_id: string, params?: ListProxyRoutesParams): Promise<ListProxyRoutesResult>;
     update(tenant_id: string, id: string, route: ProxyRouteUpdate): Promise<boolean>;

package/dist/types/adapters/ResourceServers.d.ts

@@ -1,10 +1,11 @@
 import { ListParams } from "../types/ListParams";
 import { ResourceServer, ResourceServerInsert, Totals } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListResourceServersResponse extends Totals {
     resource_servers: ResourceServer[];
 }
 export interface ResourceServersAdapter {
-    create(tenant_id: string, params: ResourceServerInsert): Promise<ResourceServer>;
+    create(tenant_id: string, params: ResourceServerInsert, options?: CreateOptions): Promise<ResourceServer>;
     get(tenant_id: string, id: string): Promise<ResourceServer | null>;
     list(tenant_id: string, params?: ListParams): Promise<ListResourceServersResponse>;
     update(tenant_id: string, id: string, resourceServer: Partial<ResourceServerInsert>): Promise<boolean>;

package/dist/types/adapters/RolePermissions.d.ts

@@ -1,7 +1,8 @@
 import { ListParams } from "../types/ListParams";
 import { RolePermissionInsert, RolePermissionList } from "../types/RolePermission";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface RolePermissionsAdapter {
-    assign(tenant_id: string, role_id: string, permissions: RolePermissionInsert[]): Promise<boolean>;
+    assign(tenant_id: string, role_id: string, permissions: RolePermissionInsert[], options?: CreateOptions): Promise<boolean>;
     remove(tenant_id: string, role_id: string, permissions: Pick<RolePermissionInsert, "resource_server_identifier" | "permission_name">[]): Promise<boolean>;
     list(tenant_id: string, role_id: string, params?: ListParams): Promise<RolePermissionList>;
 }

package/dist/types/adapters/Roles.d.ts

@@ -1,11 +1,12 @@
 import { Role, RoleInsert } from "../types";
 import { ListParams } from "../types/ListParams";
 import { Totals } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListRolesResponse extends Totals {
     roles: Role[];
 }
 export interface RolesAdapter {
-    create(tenantId: string, role: RoleInsert): Promise<Role>;
+    create(tenantId: string, role: RoleInsert, options?: CreateOptions): Promise<Role>;
     get(tenantId: string, roleId: string): Promise<Role | null>;
     list(tenantId: string, params?: ListParams): Promise<ListRolesResponse>;
     update(tenantId: string, roleId: string, updates: Partial<Role>): Promise<boolean>;

package/dist/types/adapters/Sessions.d.ts

@@ -4,9 +4,26 @@ export interface ListSesssionsResponse extends Totals {
     sessions: Session[];
 }
 export interface SessionsAdapter {
+    /**
+     * ADAPTER RESPONSIBILITY (footgun): when a session is created with an
+     * `expires_at`/`idle_expires_at`, the adapter MUST extend the parent
+     * `login_session` (referenced by `login_session_id`) so it lives at least as
+     * long as the session — never shortening it (only bump when the session's
+     * expiry is further out than the login_session's current expiry).
+     *
+     * If an adapter skips this, a long-lived session outlives its login_session
+     * and gets orphaned when cleanup reaps the login_session. The bump must be
+     * atomic with the insert. See `refreshTokens` for the equivalent contract.
+     */
     create: (tenant_id: string, session: SessionInsert) => Promise<Session>;
     get: (tenant_id: string, id: string) => Promise<Session | null>;
     list(tenantId: string, params?: ListParams): Promise<ListSesssionsResponse>;
+    /**
+     * ADAPTER RESPONSIBILITY (footgun): when an update moves `expires_at`/
+     * `idle_expires_at` forward (session renewal), the adapter MUST extend the
+     * parent `login_session` the same way `create` does (never shortening). See
+     * the note on `create` above.
+     */
     update: (tenant_id: string, id: string, session: Partial<Session>) => Promise<boolean>;
     remove: (tenant_id: string, id: string) => Promise<boolean>;
 }

package/dist/types/adapters/Tenants.d.ts

@@ -1,5 +1,6 @@
 import { Tenant, Totals } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface CreateTenantParams {
     friendly_name: string;
     audience?: string;
@@ -14,12 +15,20 @@ export interface CreateTenantParams {
     provisioning_state_changed_at?: string;
     bundle_configuration?: string;
     worker_version?: string;
+    database_version?: string;
     worker_script_name?: string;
     storage_kind?: "own_d1" | "existing_d1" | "shared_planetscale";
     d1_database_id?: string;
 }
 export interface TenantsDataAdapter {
-    create(params: CreateTenantParams): Promise<Tenant>;
+    /**
+     * Single source of truth for the new tenant id: `options.importMetadata.id`
+     * takes precedence, then `params.id`, then a generated id. The tenant
+     * importer relies on this by passing the *target* id via `params.id` and
+     * leaving `importMetadata.id` unset, so an export always lands under the
+     * requested tenant.
+     */
+    create(params: CreateTenantParams, options?: CreateOptions): Promise<Tenant>;
     get(id: string): Promise<Tenant | null>;
     list(params?: ListParams): Promise<{
         tenants: Tenant[];

package/dist/types/adapters/Themes.d.ts

@@ -1,7 +1,15 @@
 import { ThemeInsert, Theme } from "../types/Theme";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ThemesAdapter {
-    create: (tenant_id: string, theme: ThemeInsert, themeId?: string) => Promise<Theme>;
+    /**
+     * Single source of truth for the new row's id: `options.importMetadata.id`
+     * takes precedence, then the positional `themeId`, then a generated id. Every
+     * adapter must honor this same precedence so imports preserve source ids
+     * regardless of backend.
+     */
+    create: (tenant_id: string, theme: ThemeInsert, themeId?: string, options?: CreateOptions) => Promise<Theme>;
     remove: (tenant_id: string, themeId: string) => Promise<boolean>;
     get: (tenant_id: string, themeId: string) => Promise<Theme | null>;
+    list: (tenant_id: string) => Promise<Theme[]>;
     update: (tenant_id: string, themeId: any, theme: Partial<ThemeInsert>) => Promise<boolean>;
 }

package/dist/types/adapters/UniversalLoginTemplates.d.ts

@@ -1,8 +1,9 @@
+import { CreateOptions } from "../types/ImportMetadata";
 export interface UniversalLoginTemplate {
     body: string;
 }
 export interface UniversalLoginTemplatesAdapter {
     get: (tenant_id: string) => Promise<UniversalLoginTemplate | null>;
-    set: (tenant_id: string, template: UniversalLoginTemplate) => Promise<void>;
+    set: (tenant_id: string, template: UniversalLoginTemplate, options?: CreateOptions) => Promise<void>;
     delete: (tenant_id: string) => Promise<void>;
 }

package/dist/types/adapters/UserOrganizations.d.ts

@@ -2,8 +2,9 @@ import { Totals } from "../types";
 import { UserOrganization, UserOrganizationInsert } from "../types/UserOrganization";
 import { Organization } from "../types/Organization";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface UserOrganizationsAdapter {
-    create(tenantId: string, params: UserOrganizationInsert): Promise<UserOrganization>;
+    create(tenantId: string, params: UserOrganizationInsert, options?: CreateOptions): Promise<UserOrganization>;
     get(tenantId: string, id: string): Promise<UserOrganization | null>;
     remove(tenantId: string, id: string): Promise<boolean>;
     /**

package/dist/types/adapters/UserPermissions.d.ts

@@ -1,7 +1,8 @@
 import { ListParams } from "../types/ListParams";
 import { UserPermissionInsert, UserPermissionWithDetailsList } from "../types";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface UserPermissionsAdapter {
-    create(tenant_id: string, user_id: string, permission: UserPermissionInsert, organization_id?: string): Promise<boolean>;
+    create(tenant_id: string, user_id: string, permission: UserPermissionInsert, organization_id?: string, options?: CreateOptions): Promise<boolean>;
     remove(tenant_id: string, user_id: string, permission: Pick<UserPermissionInsert, "resource_server_identifier" | "permission_name">, organization_id?: string): Promise<boolean>;
     list(tenant_id: string, user_id: string, params?: ListParams, organization_id?: string): Promise<UserPermissionWithDetailsList>;
 }

package/dist/types/adapters/UserRoles.d.ts

@@ -1,5 +1,6 @@
 import { Role } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListUserRolesResponse {
     roles: Role[];
     start: number;
@@ -8,6 +9,6 @@ export interface ListUserRolesResponse {
 }
 export interface UserRolesAdapter {
     list(tenantId: string, userId: string, params?: ListParams, organizationId?: string): Promise<Role[]>;
-    create(tenantId: string, userId: string, roleId: string, organizationId?: string): Promise<boolean>;
+    create(tenantId: string, userId: string, roleId: string, organizationId?: string, options?: CreateOptions): Promise<boolean>;
     remove(tenantId: string, userId: string, roleId: string, organizationId?: string): Promise<boolean>;
 }

package/dist/types/adapters/Users.d.ts

@@ -1,11 +1,12 @@
 import { User, Totals, UserInsert } from "../types";
 import { ListParams } from "../types/ListParams";
+import { CreateOptions } from "../types/ImportMetadata";
 export interface ListUsersResponse extends Totals {
     users: User[];
 }
 export interface UserDataAdapter {
     get(tenant_id: string, id: string): Promise<User | null>;
-    create(tenantId: string, user: UserInsert): Promise<User>;
+    create(tenantId: string, user: UserInsert, options?: CreateOptions): Promise<User>;
     /**
      * Create a user without invoking any decorator-level hooks (pre/post
      * registration hooks, linking, webhooks, etc.). Intended to be called from

package/dist/types/types/ImportMetadata.d.ts

@@ -0,0 +1,27 @@
+import { z } from "@hono/zod-openapi";
+/**
+ * Import-only metadata for entity `create()` calls.
+ *
+ * These values are deliberately NOT part of any public `*InsertSchema` and are
+ * never accepted on the normal management-API write routes. They reach an
+ * adapter only through the dedicated `options.importMetadata` argument, which
+ * the HTTP layer never populates — so request bodies can never set a row's
+ * timestamps or primary id. The tenant export/import engine is the only caller
+ * that passes them, in order to reproduce a source tenant's rows faithfully.
+ *
+ * When omitted, `create()` keeps its existing behavior: generate the id and
+ * stamp `created_at`/`updated_at` with the current time.
+ */
+export declare const importMetadataSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ImportMetadata = z.infer<typeof importMetadataSchema>;
+/**
+ * Optional third argument accepted by every durable entity's `create()`.
+ * Reserved for import-only concerns; see {@link ImportMetadata}.
+ */
+export interface CreateOptions {
+    importMetadata?: ImportMetadata;
+}

package/dist/types/types/Tenant.d.ts

@@ -123,6 +123,7 @@ export declare const tenantInsertSchema: z.ZodObject<{
     provisioning_state_changed_at: z.ZodOptional<z.ZodString>;
     bundle_configuration: z.ZodOptional<z.ZodString>;
     worker_version: z.ZodOptional<z.ZodString>;
+    database_version: z.ZodOptional<z.ZodString>;
     worker_script_name: z.ZodOptional<z.ZodString>;
     storage_kind: z.ZodOptional<z.ZodEnum<{
         own_d1: "own_d1";
@@ -327,6 +328,7 @@ export declare const tenantSchema: z.ZodObject<{
     provisioning_state_changed_at: z.ZodOptional<z.ZodString>;
     bundle_configuration: z.ZodOptional<z.ZodString>;
     worker_version: z.ZodOptional<z.ZodString>;
+    database_version: z.ZodOptional<z.ZodString>;
     worker_script_name: z.ZodOptional<z.ZodString>;
     storage_kind: z.ZodOptional<z.ZodEnum<{
         own_d1: "own_d1";

package/dist/types/types/index.d.ts

@@ -53,3 +53,4 @@ export * from "./Analytics";
 export * from "./CustomText";
 export * from "./Strategy";
 export * from "./AuthenticationMethod";
+export * from "./ImportMetadata";

package/package.json

@@ -11,7 +11,7 @@
     "type": "git",
     "url": "https://github.com/markusahlstrand/authhero"
   },
-  "version": "3.2.0",
+  "version": "3.4.0",
   "files": [
     "dist"
   ],