export interface IdentityProfile { issuer: string; apiOrigin: string; clientId: string; serviceSubject: string; tenant: string; environment: string; product: string; audience: string; tokenProfile: 'keycloak-resource-v1'; } export interface ServiceConfiguration extends IdentityProfile { clientSecret: string; scopes: string[]; localDevelopment?: boolean; requestTimeoutMs?: number; maxResponseBytes?: number; maxTokenSeconds?: number; } export interface LocalZitadelServiceProfile extends Omit { tokenProfile: 'local-zitadel-service-api-v1'; policyFingerprint: string; } export interface LocalZitadelServiceConfiguration extends Omit { tokenProfile: 'local-zitadel-service-api-v1'; localDevelopment: true; environment: 'development'; tokenClientId: string; projectId: string; apiClientId: string; organizationId: string; accessTokenAudiences: string[]; clientClockSkewSeconds: 0; identityRegistryFingerprint: string; } export type ServiceTokenProfile = 'keycloak-resource-v1' | 'local-zitadel-service-api-v1'; export type ServiceClientProfile

= P extends 'local-zitadel-service-api-v1' ? LocalZitadelServiceProfile : IdentityProfile; export interface UserConfiguration extends Omit { scopes: string[]; localDevelopment?: boolean; requestTimeoutMs?: number; maxResponseBytes?: number; maxTokenSeconds?: number; } export interface LocalZitadelUserConfiguration extends Omit { tokenProfile: 'local-zitadel-resource-api-v1'; localDevelopment: true; environment: 'development'; projectId: string; idTokenAudiences: string[]; accessTokenAudiences: string[]; clientClockSkewSeconds: 0; } export interface OriginalSessionWitness { subject: string; brokerSessionId: string; authTime: number; expiresAt: number; } export interface OriginalPairConnectionInput { accessToken: string; idToken: string; expectedActor: OriginalSessionWitness; idempotencyKey: string; } export interface OriginalPairConnection { readonly connection: Readonly; /** Epoch seconds: the earlier verified original ID/access expiry. Not a new session or credential. */ readonly sessionExpiresAt: number; } export interface AccountStatus { product_subject: string; protocol: 'tracecove-lifecycle-v1'; state: 'active' | 'restricted' | 'disabled' | 'deletion_pending' | 'deleted'; security_epoch: number; account_sequence: number; invalid_before: number; revoked_session_refs: string[]; revocations_complete: true; observed_at: string; } export interface LifecycleEvent { event_id: string; product_subject: string; schema_version: 1; protocol: 'tracecove-lifecycle-v1'; type: string; account_sequence: number; security_epoch: number; occurred_at: string; state: AccountStatus['state']; invalid_before: number; invalidation_kind: 'account' | 'session' | 'status'; snapshot_required: boolean; revoked_session_ref?: string; method_kind?: string; [key: string]: unknown; } export interface LifecyclePage { items: LifecycleEvent[]; next_cursor: string; observed_at: string } export interface ProductConnection { product_id: string; product_subject: string; account_state: AccountStatus['state']; security_epoch: number; connected_at: string } export interface ClientOptions { fetch?: typeof fetch; now?: () => number } declare const userTransportOwnerBrand: unique symbol; export interface UserClientTransportOwner { readonly profile: 'local-zitadel-user-transport-owner-v1'; readonly [userTransportOwnerBrand]: true } export interface UserClientTransportStatus { readonly profile: 'local-zitadel-user-transport-owner-v1'; readonly phase: 'initializing' | 'ready' | 'failed' | 'closing' | 'closed'; readonly activeOperations: number; readonly transport: null | Readonly<{profile: 'identity-transport-read-custody-v1'; scope: 'tracked-read-promises-only'; activeCalls: number; scheduledOperations: number; ownedCallRecords: number; detachedSchedules: number; detachedLeases: number; unsettled: boolean; retainedLeases: number; pendingOperations: number; quiescent: boolean}>; } declare const serviceTransportOwnerBrand: unique symbol; export interface ServiceClientTransportOwner { readonly profile: 'local-zitadel-service-transport-owner-v1'; readonly [serviceTransportOwnerBrand]: true } export interface ServiceClientTransportStatus extends Omit { readonly profile: 'local-zitadel-service-transport-owner-v1' } export class IdentitySDKError extends Error { code: string; status?: number; retryAfterMs?: number; readonly owner?: UserClientTransportOwner | ServiceClientTransportOwner; constructor(code: string, status?: number, retryAfterMs?: number) } export function isIdentityAvailabilityError(error: unknown): boolean; export class IdentityServiceClient

{ private constructor(); static observeLocalTransport(owner: ServiceClientTransportOwner | IdentityServiceClient<'local-zitadel-service-api-v1'>): ServiceClientTransportStatus; static closeLocalTransport(owner: ServiceClientTransportOwner | IdentityServiceClient<'local-zitadel-service-api-v1'>): void; static connect(config: ServiceConfiguration, options?: ClientOptions): Promise; static connect(config: LocalZitadelServiceConfiguration, options?: ClientOptions): Promise>; static connect(config: ServiceConfiguration | LocalZitadelServiceConfiguration, options?: ClientOptions): Promise>; profile(): ServiceClientProfile

; status(subject: string): Promise; lifecycle(cursor?: string | null, options?: {limit?: number}): Promise; acknowledge(eventIds: string[], key: string): Promise<{acknowledged_event_ids: string[]}>; } export type UserTokenProfile = 'keycloak-resource-v1' | 'local-zitadel-resource-api-v1'; export class IdentityProductUserClient

{ private constructor(); static observeLocalTransport(owner: UserClientTransportOwner | IdentityProductUserClient<'local-zitadel-resource-api-v1'>): UserClientTransportStatus; static closeLocalTransport(owner: UserClientTransportOwner | IdentityProductUserClient<'local-zitadel-resource-api-v1'>): void; static connect(config: UserConfiguration, options?: ClientOptions): Promise; static connect(config: LocalZitadelUserConfiguration, options?: ClientOptions): Promise>; static connect(config: UserConfiguration | LocalZitadelUserConfiguration, options?: ClientOptions): Promise>; profile(): Omit & {tokenProfile: P}; connectProduct(input: P extends 'local-zitadel-resource-api-v1' ? OriginalPairConnectionInput : {accessToken: string; expectedActor: {subject: string; brokerSessionId: string; authTime: number}; idempotencyKey: string}): Promise; connectProductWithOriginalSession(input: P extends 'local-zitadel-resource-api-v1' ? OriginalPairConnectionInput : never): Promise; } export type OwnerScope = 'account:read' | 'sessions:read' | 'sessions:revoke' | 'operations:read'; export interface OwnerProfile extends Omit { audience: 'urn:tracecove:identity-api' } export interface OwnerConfiguration extends OwnerProfile { scopes: OwnerScope[]; localDevelopment?: boolean; requestTimeoutMs?: number; maxResponseBytes?: number; maxTokenSeconds?: number; recentAuthSeconds?: number; } export interface OwnerAuthority { accessToken: string; expectedActor: {subject: string; brokerSessionId: string; authTime: number}; isSessionActive: () => boolean; } export interface OwnerAccountView { account_id: string; state: AccountStatus['state']; security_epoch: number; products: readonly {product_id: string; display_name: string; connected_at: string}[]; } export interface OwnerSessionPage { items: readonly {session_id: string; product_id: string; state: 'active' | 'expired' | 'revoked' | 'revocation_pending'; created_at: string; expires_at: string}[]; next_cursor: string | null; observed_at: string; } export interface OwnerSessionOperation { operation_id: string; kind: 'revoke_session' | 'sign_out_everywhere'; state: 'pending' | 'completed' | 'failed'; created_at: string; failure_code?: string; } export class IdentityOwnerClient { private constructor(); static connect(config: OwnerConfiguration, options?: ClientOptions): Promise; profile(): OwnerProfile; account(authority: OwnerAuthority): Promise; sessions(authority: OwnerAuthority, page?: {cursor?: string | null; limit?: number}): Promise; revokeSession(authority: OwnerAuthority, command: {sessionId: string; idempotencyKey: string}): Promise; signOutEverywhere(authority: OwnerAuthority, command: {idempotencyKey: string}): Promise; operation(authority: OwnerAuthority, operationId: string): Promise; } export function validateOwnerConfiguration(input: OwnerConfiguration): OwnerConfiguration; export interface ConsumerProjection { snapshot: AccountStatus | null; checkedAt: number | null; valid: boolean } export interface ConsumerStore

{ profile(): ServiceClientProfile

; transaction(callback: (tx: ConsumerStore

) => T | Promise): Promise; subjects(): string[] | Promise; registerSubject(subject: string): void | Promise; projection(subject: string): ConsumerProjection | null | Promise; commitSnapshot(snapshot: AccountStatus, checkedAt: number): void | Promise; recordEvent(event: LifecycleEvent): void | Promise; cursor(): string | null | Promise; setCursor(cursor: string | null): void | Promise; enqueueAcknowledgement(command: {key: string; eventIds: string[]}): void | Promise; pendingAcknowledgements(): {key: string; eventIds: string[]; blocked?: boolean}[] | Promise<{key: string; eventIds: string[]; blocked?: boolean}[]>; removeAcknowledgement(key: string): void | Promise; markAcknowledgementBlocked(key: string): void | Promise; invalidateAll(): void | Promise; } export class IdentityConsumer

{ constructor(input: {client: IdentityServiceClient

; store: ConsumerStore

; now?: () => number; freshnessMs?: number}); registerSubject(subject: string): Promise<{state: AccountStatus['state']; securityEpoch: number}>; refreshSubject(subject: string): Promise<{state: AccountStatus['state']; securityEpoch: number}>; syncOnce(): Promise<{appliedEvents: number; refreshedSubjects: number; resynchronized: boolean; acknowledgementPending: boolean; acknowledgementBlocked: boolean}>; assertSession(input: {productSubject: string; authTime: number; sessionReference: string; securityEpoch: number}): Promise<{state: 'active'; sessionSecurityEpoch: number; observedSecurityEpoch: number}>; } export class SQLiteIdentityConsumerStore

implements ConsumerStore

{ constructor(path: string, options: {profile: Omit & {tokenProfile: P} & (P extends 'local-zitadel-service-api-v1' ? {policyFingerprint: string} : unknown); maxSubjects?: number; maxInboxEvents?: number; maxPendingAcknowledgements?: number}); profile(): ServiceClientProfile

; transaction(callback: (tx: ConsumerStore

) => T | Promise): Promise; subjects(): string[]; registerSubject(subject: string): void; projection(subject: string): ConsumerProjection | null; commitSnapshot(snapshot: AccountStatus, checkedAt: number): void; recordEvent(event: LifecycleEvent): void; cursor(): string | null; setCursor(cursor: string | null): void; enqueueAcknowledgement(command: {key: string; eventIds: string[]}): void; pendingAcknowledgements(): {key: string; eventIds: string[]; blocked?: boolean}[]; removeAcknowledgement(key: string): void; markAcknowledgementBlocked(key: string): void; invalidateAll(): void; close(): void; } export function validateServiceConfiguration(input: ServiceConfiguration): ServiceConfiguration; export function validateServiceConfiguration(input: LocalZitadelServiceConfiguration): LocalZitadelServiceConfiguration; export function validateUserConfiguration(input: UserConfiguration): UserConfiguration; export function validateUserConfiguration(input: LocalZitadelUserConfiguration): LocalZitadelUserConfiguration; export function productSessionReference(input: {tenant: string; environment: string; issuer: string; product: string; productSubject: string; brokerSessionId: string}): string; export function validateStatus(input: unknown, expectedSubject: string): AccountStatus; export function validateEvent(input: unknown): LifecycleEvent; export function validateLifecyclePage(input: unknown): LifecyclePage; export const LIFECYCLE_PROTOCOL: 'tracecove-lifecycle-v1';