@vrplatform/kysely 1.3.45-stage.7 → 1.3.45-stage.710

package/build/migrations-v2/0000000000056-journal-operation-failure-precedence.ts

@@ -0,0 +1,306 @@
+import { type Kysely, sql } from 'kysely';
+
+// The served `core.operation.failure_code` projection must agree with the
+// TypeScript classifier in `packages/repository/src/journal-freshness/load.ts`:
+// a governing accounting lock wins over a retained failure (CUS-2936), and a
+// retained unbalanced attempt is recognized by its message prefix as well as by
+// the typed result code (CUS-2894).
+const failureProjection = (ordering: 'lock-first' | 'failure-first') => sql`
+  create or replace function core.refresh_operation_state(
+    target_operation_id uuid
+  ) returns void
+  language plpgsql
+  as $$
+  declare
+    next_status core.operation_status;
+    next_started_at timestamptz;
+    next_finished_at timestamptz;
+    next_failure_code text;
+    next_failure_message text;
+    target_operation_type core.operation_type;
+    target_public_id_format core.operation_public_id_format;
+    target_action_id uuid;
+  begin
+    select
+      operation.type,
+      operation.public_id_format,
+      source.source_id
+    into
+      target_operation_type,
+      target_public_id_format,
+      target_action_id
+    from core.operation as operation
+    left join core.operation_source as source
+      on source.operation_id = operation.id
+      and source.source_type = 'audit-action'
+    where operation.id = target_operation_id;
+
+    select
+      case
+        when count(*) filter (where required) = 0 then 'queued'
+        when bool_and(status = 'completed') filter (where required)
+          then 'completed'
+        when bool_and(status in ('completed', 'failed')) filter (where required)
+          then 'failed'
+        when bool_or(status = 'running') filter (where required)
+          or bool_or(status in ('completed', 'failed')) filter (where required)
+          then 'running'
+        else 'queued'
+      end::core.operation_status,
+      min(started_at) filter (where required),
+      max(finished_at) filter (where required)
+    into next_status, next_started_at, next_finished_at
+    from core.operation_source
+    where operation_id = target_operation_id;
+
+    if next_status = 'failed' then
+      if target_operation_type = 'reservation-journal-refresh'
+        and target_action_id is not null then
+        select
+          case
+            ${sql.raw(
+              ordering === 'lock-first'
+                ? `when core.journal_refresh_all_outstanding_locked(
+                      bool_and(
+                        case
+                          when invalidation.id is not null
+                            and invalidation.applied_at is null
+                          then effect.status = 'completed'
+                            and attempt.status is not distinct from 'skipped_locked'
+                        end
+                      ),
+                      bool_and(
+                        case
+                          when invalidation.id is not null
+                            and invalidation.applied_at is null
+                          then core.journal_reservation_refresh_locked(
+                            invalidation.tenant_id,
+                            invalidation.reservation_id
+                          )
+                        end
+                      )
+                    ) then 'journalLocked'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code = 'journal_configuration_invalid'
+                    ) then 'journalConfigurationInvalid'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and (
+                        attempt.result_code = 'journal_unbalanced'
+                        or attempt.error_message like 'Journal refresh produced unbalanced%'
+                      )
+                    ) then 'journalUnbalanced'`
+                : `when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code = 'journal_unbalanced'
+                    ) then 'journalUnbalanced'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code = 'journal_configuration_invalid'
+                    ) then 'journalConfigurationInvalid'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code in (
+                        'statement_period_locked',
+                        'skipped_locked'
+                      )
+                    ) then 'journalLocked'`
+            )}
+            else 'journalRefreshFailed'
+          end,
+          case
+            ${sql.raw(
+              ordering === 'lock-first'
+                ? `when core.journal_refresh_all_outstanding_locked(
+                      bool_and(
+                        case
+                          when invalidation.id is not null
+                            and invalidation.applied_at is null
+                          then effect.status = 'completed'
+                            and attempt.status is not distinct from 'skipped_locked'
+                        end
+                      ),
+                      bool_and(
+                        case
+                          when invalidation.id is not null
+                            and invalidation.applied_at is null
+                          then core.journal_reservation_refresh_locked(
+                            invalidation.tenant_id,
+                            invalidation.reservation_id
+                          )
+                        end
+                      )
+                    ) then 'Journal refresh is blocked by accounting locks'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code = 'journal_configuration_invalid'
+                    ) then 'Journal configuration is invalid'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and (
+                        attempt.result_code = 'journal_unbalanced'
+                        or attempt.error_message like 'Journal refresh produced unbalanced%'
+                      )
+                    ) then 'Journal refresh produced unbalanced entries'`
+                : `when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code = 'journal_unbalanced'
+                    ) then 'Journal refresh produced unbalanced entries'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code = 'journal_configuration_invalid'
+                    ) then 'Journal configuration is invalid'
+                    when bool_or(
+                      invalidation.applied_at is null
+                      and attempt.result_code in (
+                        'statement_period_locked',
+                        'skipped_locked'
+                      )
+                    ) then 'Journal refresh is blocked by accounting locks'`
+            )}
+            else 'Journal refresh failed'
+          end
+        into next_failure_code, next_failure_message
+        from audit.effect as effect
+        left join accounting.reservation_journal_invalidation as invalidation
+          on invalidation.tenant_id = effect.tenant_id
+          and invalidation.effect_id = effect.id
+        left join lateral (
+          select
+            effect_attempt.status,
+            effect_attempt.result_code,
+            effect_attempt.error_message
+          from audit.effect_attempt as effect_attempt
+          where effect_attempt.tenant_id = effect.tenant_id
+            and effect_attempt.effect_id = effect.id
+          order by effect_attempt.attempt_num desc
+          limit 1
+        ) as attempt on true
+        where effect.action_id = target_action_id
+          and effect.effect_type = 'REFRESH_RESERVATION_JOURNAL'
+          and effect.entity_type = 'reservation';
+      else
+        next_failure_code := 'operation_failed';
+        next_failure_message := 'Operation failed';
+      end if;
+    else
+      next_failure_code := null;
+      next_failure_message := null;
+    end if;
+
+    update core.operation
+    set
+      status = next_status,
+      started_at = coalesce(core.operation.started_at, next_started_at),
+      finished_at = case
+        when next_status in ('completed', 'failed')
+          then coalesce(next_finished_at, now())
+        else null
+      end,
+      failure_code = next_failure_code,
+      failure_message = next_failure_message,
+      updated_at = now(),
+      source_version = source_version + 1
+    where id = target_operation_id
+      and (
+        status is distinct from next_status
+        or started_at is distinct from coalesce(started_at, next_started_at)
+        or finished_at is distinct from case
+          when next_status in ('completed', 'failed')
+            then coalesce(next_finished_at, finished_at, now())
+          else null
+        end
+        or failure_code is distinct from next_failure_code
+        or failure_message is distinct from next_failure_message
+      );
+  end;
+  $$
+`;
+
+// The reservation lock driver from `isReservationRefreshLocked`: the refresh is
+// locked when every active reservation entry sits in a published statement or
+// in closed books.
+const reservationRefreshLocked = sql`
+  create or replace function core.journal_reservation_refresh_locked(
+    target_tenant_id uuid,
+    target_reservation_id uuid
+  ) returns boolean
+  language sql
+  stable
+  as $$
+    select exists (
+      select 1
+      from accounting.journal_entry as entry
+      inner join public.tenant as tenant on tenant.id = entry.tenant_id
+      where entry.tenant_id = target_tenant_id
+        and entry.reservation_id = target_reservation_id
+        and entry.status = 'active'
+        and (entry.entity_type is null or entry.entity_type = 'reservation')
+        and (
+          entry.attached_to_owner_statement_id is not null
+          or entry.transfer_owner_statement_id is not null
+          or entry.txn_at < tenant.books_closed_at
+        )
+    )
+  $$
+`;
+
+// `bool_and` over no outstanding invalidation returns null; the classifier
+// treats that as "not locked".
+const allOutstandingLocked = sql`
+  create or replace function core.journal_refresh_all_outstanding_locked(
+    all_lock_skipped boolean,
+    all_reservations_locked boolean
+  ) returns boolean
+  language sql
+  immutable
+  as $$
+    select coalesce(all_lock_skipped, false) or coalesce(all_reservations_locked, false)
+  $$
+`;
+
+async function recomputeFailedJournalOperations(db: Kysely<unknown>) {
+  // Derived operation state only. Attempts, invalidations and journals are untouched.
+  await sql`
+    select core.refresh_operation_state(operation.id)
+    from core.operation as operation
+    where operation.type = 'reservation-journal-refresh'
+      and operation.status = 'failed'
+      and exists (
+        select 1 from core.operation_source as source
+        where source.operation_id = operation.id
+          and source.source_type = 'audit-action'
+      )
+  `.execute(db);
+}
+
+export async function up(db: Kysely<unknown>): Promise<void> {
+  await sql`
+    do $$
+    begin
+      if position(
+        'and target_public_id_format = ''action'''
+        in pg_get_functiondef('core.refresh_operation_state(uuid)'::regprocedure)
+      ) > 0 then
+        raise exception 'Journal operation failure projection has an unexpected definition';
+      end if;
+    end;
+    $$
+  `.execute(db);
+  await reservationRefreshLocked.execute(db);
+  await allOutstandingLocked.execute(db);
+  await failureProjection('lock-first').execute(db);
+  await recomputeFailedJournalOperations(db);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+  await failureProjection('failure-first').execute(db);
+  await recomputeFailedJournalOperations(db);
+  await sql`drop function if exists core.journal_refresh_all_outstanding_locked(boolean, boolean)`.execute(
+    db
+  );
+  await sql`drop function if exists core.journal_reservation_refresh_locked(uuid, uuid)`.execute(
+    db
+  );
+}

package/build/migrations-v2/0000000000057-journal-invalidation-failure-code.ts

@@ -0,0 +1,28 @@
+import type { Kysely } from 'kysely';
+import { sql } from 'kysely';
+
+// An inline reservation journal refresh has no effect row, so a refresh that
+// completes without writing the reservation's postings had nowhere to record
+// why. Storage only: nullable column, no default, no backfill, no rewrite.
+export async function up(db: Kysely<unknown>): Promise<void> {
+  await sql`
+    create type accounting.reservation_journal_invalidation_failure as enum (
+      'journal_configuration_invalid'
+    )
+  `.execute(db);
+  await sql`
+    alter table accounting.reservation_journal_invalidation
+      add column failure_code
+        accounting.reservation_journal_invalidation_failure
+  `.execute(db);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+  await sql`
+    alter table accounting.reservation_journal_invalidation
+      drop column if exists failure_code
+  `.execute(db);
+  await sql`
+    drop type if exists accounting.reservation_journal_invalidation_failure
+  `.execute(db);
+}

package/build/module/control-plane/index.d.ts

@@ -10,6 +10,11 @@ export type JsonPrimitive = boolean | number | string | null;
 export type JsonValue = JsonArray | JsonObject | JsonPrimitive;
 export type Int8 = ColumnType<string, number | string | bigint, number | string | bigint>;
 export type Timestamp = ColumnType<Date | string, Date | string, Date | string>;
+export type ControlPlaneOperationStatus = 'completed' | 'failed' | 'queued' | 'running';
+export type ControlPlaneOperationType = 'ach-verification' | 'bank-rule-run' | 'calendar-block' | 'calendar-unblock' | 'connection-archive' | 'connection-connect' | 'connection-extract' | 'connection-sync' | 'csv-import' | 'csv-import-preview' | 'export' | 'flow-run' | 'historical-gl-import' | 'historical-statement-import' | 'listing-journal-refresh' | 'plaid-initial-sync' | 'pms-cutover' | 'pms-cutover-preview' | 'provider-payment' | 'provider-payment-recovery' | 'recurring-transaction-run' | 'reservation-journal-refresh' | 'team-delete' | 'team-demo-data' | 'team-duplicate' | 'team-initialize' | 'transaction-journal-refresh' | 'vri-statement-import' | 'vri-team-migration' | 'webhook-test';
+export type ControlPlaneOperationResourceRole = 'result' | 'source' | 'target';
+export type ControlPlaneOperationResourceType = 'bank-rule' | 'connection' | 'contact' | 'file' | 'flow' | 'listing' | 'recurring-fee' | 'recurring-transaction-template' | 'reservation' | 'statement' | 'team' | 'transaction' | 'webhook';
+export type ControlPlaneOperationSourceType = 'destructive-job' | 'regional-operation';
 export interface ControlPlaneApp {
     authentication: Generated<Json>;
     category: string | null;
@@ -169,8 +174,8 @@ export interface ControlPlaneOperation {
     sourceRegion: TenantDataRegion | null;
     sourceVersion: Generated<number>;
     startedAt: Timestamp | null;
-    status: Generated<'completed' | 'failed' | 'queued' | 'running'>;
-    type: string;
+    status: Generated<ControlPlaneOperationStatus>;
+    type: ControlPlaneOperationType;
     updatedAt: Generated<Timestamp>;
 }
 export interface ControlPlaneOperationResource {
@@ -178,18 +183,18 @@ export interface ControlPlaneOperationResource {
     isPrimary: Generated<boolean>;
     operationId: string;
     resourceId: string;
-    resourceType: string;
-    role: 'result' | 'source' | 'target';
+    resourceType: ControlPlaneOperationResourceType;
+    role: ControlPlaneOperationResourceRole;
 }
 export interface ControlPlaneOperationSource {
     finishedAt: Timestamp | null;
     operationId: string;
     required: Generated<boolean>;
     sourceId: string;
-    sourceType: 'destructive-job' | 'regional-operation';
+    sourceType: ControlPlaneOperationSourceType;
     sourceVersion: Generated<number>;
     startedAt: Timestamp | null;
-    status: Generated<'completed' | 'failed' | 'queued' | 'running'>;
+    status: Generated<ControlPlaneOperationStatus>;
 }
 export interface ControlPlaneEvent {
     createdAt: Generated<Timestamp>;
@@ -370,6 +375,22 @@ export interface ControlPlanePartnerManagedTeamAssignment {
     partnerTenantId: string;
     userId: string;
 }
+export interface ControlPlaneOwnerPortal {
+    hostname: string;
+    tenantId: string;
+    status: Generated<'pending' | 'active' | 'disabled'>;
+    name: string;
+    logo: string | null;
+    colorPrimary: string;
+    showPlatformBranding: Generated<boolean>;
+    linksEnabled: Generated<boolean>;
+    sender: {
+        from: string;
+        replyTo: string;
+    } | null;
+    revision: Generated<number>;
+    updatedAt: Generated<Timestamp>;
+}
 export interface ControlPlaneTenant {
     billingPartnerId: string | null;
     billingPlan: string | null;
@@ -470,6 +491,7 @@ export interface ControlPlaneDB {
     'controlPlane.partnerManagedTeamAssignment': ControlPlanePartnerManagedTeamAssignment;
     'controlPlane.reservationLineDefault': ControlPlaneReservationLineDefault;
     'controlPlane.rolloutMonitorSnapshot': ControlPlaneRolloutMonitorSnapshot;
+    'controlPlane.ownerPortal': ControlPlaneOwnerPortal;
     'controlPlane.tenant': ControlPlaneTenant;
     'controlPlane.tenantRegionMigration': ControlPlaneTenantRegionMigration;
     'controlPlane.tenantUser': ControlPlaneTenantUser;

package/build/module/control-plane/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"src/","sources":["control-plane/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EAGd,wBAAwB,GAQzB,MAAM,QAAQ,CAAC;AA+hBhB,MAAM,6BAA8B,SAAQ,wBAAwB;IAEvD;IACA;IAFX,YACW,MAAc,EACd,2BAAmC;QAE5C,KAAK,EAAE,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,gCAA2B,GAA3B,2BAA2B,CAAQ;IAG9C,CAAC;IAEkB,4BAA4B,CAC7C,IAA6B,EAC7B,OAAgB;QAEhB,MAAM,WAAW,GAAG,KAAK,CAAC,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtE,IACE,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,cAAc;YAC3C,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,eAAe,EAC5C,CAAC;YACD,OAAO,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxE,CAAC;QACD,IACE,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,kBAAkB;YAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,oBAAoB,EACjD,CAAC;YACD,OAAO;gBACL,GAAG,WAAW;gBACd,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC;aAChE,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAEkB,iBAAiB,CAClC,IAAkB,EAClB,OAAgB;QAEhB,MAAM,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;YAC1C,CAAC,CAAC;gBACE,GAAG,WAAW;gBACd,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE;aACzE;YACH,CAAC,CAAC,WAAW,CAAC;IAClB,CAAC;CACF;AAED,MAAM,wBAAwB;IACnB,YAAY,CAAgC;IAErD,YAAY,MAAc,EAAE,2BAAmC;QAC7D,IAAI,CAAC,YAAY,GAAG,IAAI,6BAA6B,CACnD,MAAM,EACN,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,IAA8B;QAC3C,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,IAA+B;QAE/B,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CACpC,MAA8B,EAC9B,MAAc,EACd,2BAA2B,GAAG,MAAM;IAEpC,OAAO,MAAM,CAAC,UAAU,CACtB,IAAI,wBAAwB,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAClE,CAAC;AACJ,CAAC","sourcesContent":["import {\n  type ColumnType,\n  type FunctionNode,\n  IdentifierNode,\n  type Kysely,\n  type KyselyPlugin,\n  OperationNodeTransformer,\n  type PluginTransformQueryArgs,\n  type PluginTransformResultArgs,\n  type QueryId,\n  type QueryResult,\n  type RootOperationNode,\n  type SchemableIdentifierNode,\n  type UnknownRow,\n} from 'kysely';\nimport type { TenantDataRegion } from '../regional';\n\nexport type Generated<T> =\n  T extends ColumnType<infer S, infer I, infer U>\n    ? ColumnType<S, I | undefined, U>\n    : ColumnType<T, T | undefined, T>;\n\nexport type Json = JsonValue;\n\nexport type JsonArray = JsonValue[];\n\nexport type JsonObject = {\n  [x: string]: JsonValue | undefined;\n};\n\nexport type JsonPrimitive = boolean | number | string | null;\n\nexport type JsonValue = JsonArray | JsonObject | JsonPrimitive;\n\nexport type Int8 = ColumnType<\n  string,\n  number | string | bigint,\n  number | string | bigint\n>;\n\nexport type Timestamp = ColumnType<Date | string, Date | string, Date | string>;\n\nexport interface ControlPlaneApp {\n  authentication: Generated<Json>;\n  category: string | null;\n  color: string | null;\n  createdAt: Generated<Timestamp>;\n  icon: string | null;\n  iconRound: string | null;\n  id: Generated<string>;\n  info: Json | null;\n  name: string;\n  type: string;\n  version: Generated<number>;\n}\n\nexport interface ControlPlaneAccountingIntegrityEvaluation {\n  caseCount: Generated<Int8>;\n  completedAt: Timestamp | null;\n  completedRunCount: Generated<number>;\n  createdAt: Generated<Timestamp>;\n  environment: string;\n  error: Json | null;\n  expectedRunCount: number;\n  failedRunCount: Generated<number>;\n  findingRowCount: Generated<Int8>;\n  gitRevision: string;\n  id: string;\n  results: Generated<Json>;\n  rowsScanned: Generated<Int8>;\n  skippedRunCount: Generated<number>;\n  source: string;\n  startedAt: Timestamp;\n  status: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneAccountingIntegrityDefinitionDraft {\n  artifact: Json;\n  artifactHash: string;\n  code: string;\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  ownerId: string;\n  previewResult: Json | null;\n  rationale: string;\n  revision: Generated<number>;\n  status: string;\n  templateId: string;\n  templateVersion: number;\n  title: string;\n  updatedAt: Generated<Timestamp>;\n  validationResult: Json | null;\n}\n\nexport interface ControlPlaneAccountingIntegrityDefinitionVersion {\n  artifact: Json;\n  artifactHash: string;\n  code: string;\n  draftId: string;\n  id: Generated<string>;\n  publishedAt: Generated<Timestamp>;\n  publishedBy: string;\n  rollout: string;\n  templateId: string;\n  templateVersion: number;\n  version: number;\n}\n\nexport interface ControlPlaneBookingChannel {\n  channelRef: string | null;\n  color: string | null;\n  createdAt: Generated<Timestamp>;\n  icon: string | null;\n  iconProvider: string | null;\n  id: Generated<string>;\n  lastGenerateRun: Timestamp | null;\n  logo: string | null;\n  logoProvider: string | null;\n  selectedBookingChannelIconCandidateId: string | null;\n  selectedBookingChannelLogoCandidateId: string | null;\n  uniqueRef: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneBookingChannelIconCandidate {\n  bookingChannelId: string;\n  cloudflareImageId: string | null;\n  color: string | null;\n  comment: string | null;\n  createdAt: Generated<Timestamp>;\n  externalIcon: string | null;\n  height: number | null;\n  id: Generated<string>;\n  provider: Generated<string>;\n  source: string | null;\n  updatedAt: Generated<Timestamp>;\n  width: number | null;\n}\n\nexport interface ControlPlaneCurrency {\n  name: string;\n}\n\nexport type DestructiveJobStep =\n  | 'completed'\n  | 'completion_effects'\n  | 'control_plane_deleted'\n  | 'control_plane_deleting'\n  | 'queued'\n  | 'regional_deleted'\n  | 'regional_deleting'\n  | 'validated';\n\nexport interface ControlPlaneDestructiveJob {\n  attempts: Generated<number>;\n  authorizedByTenantId: string;\n  availableAt: Generated<Timestamp>;\n  claimedAt: Timestamp | null;\n  claimedBy: string | null;\n  completedAt: Timestamp | null;\n  completionData: Json | null;\n  completionWarningCode: string | null;\n  completionWarningDetails: Json | null;\n  createdAt: Generated<Timestamp>;\n  dataRegion: TenantDataRegion;\n  failureCode: string | null;\n  failureDetails: Json | null;\n  force: Generated<boolean>;\n  id: Generated<string>;\n  jobType: 'tenant.delete';\n  maxAttempts: Generated<number>;\n  requestId: string | null;\n  requestedByActorType: 'api_key' | 'system' | 'user';\n  requestedByTenantId: string;\n  requestedByUserId: string | null;\n  startedAt: Timestamp | null;\n  status: Generated<'canceled' | 'completed' | 'failed' | 'queued' | 'running'>;\n  step: Generated<DestructiveJobStep>;\n  targetId: string;\n  triggerRunId: string | null;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneDestructiveJobAttempt {\n  attemptNumber: number;\n  failureCode: string | null;\n  failureDetails: Json | null;\n  finishedAt: Timestamp | null;\n  id: Generated<string>;\n  jobId: string;\n  startedAt: Generated<Timestamp>;\n  status: Generated<'completed' | 'failed' | 'running' | 'superseded'>;\n  step: DestructiveJobStep;\n  triggerRunId: string | null;\n}\n\nexport interface ControlPlaneDestructiveJobOperation {\n  action: 'abandon' | 'cancel' | 'retry';\n  actor: string;\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  jobId: string;\n  previousStatus: string;\n  previousStep: string;\n  reasonCode: string;\n}\n\nexport interface ControlPlaneOperation {\n  createdAt: Generated<Timestamp>;\n  failureCode: string | null;\n  failureMessage: string | null;\n  finishedAt: Timestamp | null;\n  id: Generated<string>;\n  initiatedByUserId: string | null;\n  requesterTenantId: string;\n  retainUntil: Timestamp | null;\n  sourceRegion: TenantDataRegion | null;\n  sourceVersion: Generated<number>;\n  startedAt: Timestamp | null;\n  status: Generated<'completed' | 'failed' | 'queued' | 'running'>;\n  type: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneOperationResource {\n  createdAt: Generated<Timestamp>;\n  isPrimary: Generated<boolean>;\n  operationId: string;\n  resourceId: string;\n  resourceType: string;\n  role: 'result' | 'source' | 'target';\n}\n\nexport interface ControlPlaneOperationSource {\n  finishedAt: Timestamp | null;\n  operationId: string;\n  required: Generated<boolean>;\n  sourceId: string;\n  sourceType: 'destructive-job' | 'regional-operation';\n  sourceVersion: Generated<number>;\n  startedAt: Timestamp | null;\n  status: Generated<'completed' | 'failed' | 'queued' | 'running'>;\n}\n\nexport interface ControlPlaneEvent {\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  name: string;\n  packageName: string;\n  props: Json;\n  tenantId: string | null;\n  timestamp: Generated<Timestamp>;\n  trackedAt: Generated<Timestamp | null>;\n  userId: string | null;\n}\n\nexport interface ControlPlaneTrackingQueueFailure {\n  bodyFingerprint: string | null;\n  capturedAt: Generated<Timestamp>;\n  dispositionAt: Timestamp | null;\n  dispositionHistory: Generated<Json[]>;\n  dispositionReasonCode: string | null;\n  dispositionActor: string | null;\n  environment: 'production' | 'staging';\n  event: Json | null;\n  eventId: string | null;\n  expiresAt: Timestamp;\n  failureCode: string;\n  id: Generated<string>;\n  lastReplayedAt: Timestamp | null;\n  queueMessageId: string;\n  replayCount: Generated<number>;\n  recurrenceCount: Generated<number>;\n  status: Generated<'captured' | 'discarded' | 'replayed'>;\n  updatedAt: Generated<Timestamp>;\n  validationIssues: Json | null;\n}\n\nexport interface ControlPlaneConnectionRoute {\n  connectionId: string;\n  createdAt: Generated<Timestamp>;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneFeature {\n  createdAt: Generated<Timestamp>;\n  description: string | null;\n  id: Generated<string>;\n  issueUrl: string | null;\n  requiredApprovals: Generated<Json | null>;\n  status: Generated<string | null>;\n  tenantId: string | null;\n  title: string;\n  updatedAt: Generated<Timestamp>;\n  url: string | null;\n}\n\nexport interface ControlPlaneFeatureEnabledTeam {\n  createdAt: Generated<Timestamp>;\n  featureId: string;\n  id: Generated<string>;\n  status: Generated<string | null>;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneFeatureApproval {\n  createdAt: Generated<Timestamp>;\n  featureId: string;\n  id: Generated<string>;\n  status: Generated<string | null>;\n  updatedAt: Generated<Timestamp>;\n  userId: string;\n}\n\nexport interface ControlPlaneFlow {\n  appId: string;\n  createdAt: Generated<Timestamp>;\n  description: string | null;\n  eventListening: Generated<Json>;\n  id: Generated<string>;\n  isPublic: Generated<boolean>;\n  leftType: string | null;\n  mappingSchema: Generated<Json>;\n  revision: Generated<number>;\n  rightType: string | null;\n  runSchema: Generated<Json>;\n  settingSchema: Generated<Json>;\n  title: string;\n  type: 'pull' | 'push' | null;\n  uniqueRef: string;\n  updatedAt: Generated<Timestamp>;\n  useGlobalMapping: Generated<boolean>;\n}\n\nexport interface ControlPlaneIssueMessageOverwrite {\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  message: string;\n  pattern: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneLineClassification {\n  appConflict: Generated<boolean>;\n  appId: string | null;\n  createdAt: Generated<Timestamp>;\n  firstSeenAt: Timestamp;\n  id: Generated<string>;\n  kind: string;\n  lastSeenAt: Timestamp;\n  name: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneLineClassificationTeamUsage {\n  classificationId: string;\n  createdAt: Generated<Timestamp>;\n  dataRegion: string;\n  firstSeenAt: Timestamp;\n  lastSeenAt: Timestamp;\n  mappingStatus: string | null;\n  revision: number;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneReservationLineDefault {\n  accountKey: string | null;\n  bookingChannel: string | null;\n  bookingChannelKey: Generated<string>;\n  classificationId: string;\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  partnerTenantId: string | null;\n  revenueRecognition: string | null;\n  revision: Generated<number>;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneRolloutMonitorSnapshot {\n  monitorName: string;\n  result: Json;\n  snapshotDate: Timestamp;\n}\n\nexport interface ControlPlaneTransactionLineMapping {\n  accountAssignmentType: string | null;\n  createdAt: Generated<Timestamp>;\n  deletedAt: Timestamp | null;\n  id: Generated<string>;\n  lineType: string;\n  revision: Generated<number>;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneGeneralLedgerDefaultSet {\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  partnerTenantId: string | null;\n  publishedVersion: number | null;\n  sourceDataRegion: string;\n  sourceDigest: string | null;\n  sourceTenantId: string;\n  templateKey: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneGeneralLedgerDefaultVersion {\n  dataJson: Json;\n  defaultSetId: string;\n  id: Generated<string>;\n  publishedAt: Generated<Timestamp>;\n  sourceDigest: string;\n  sourceTenantId: string;\n  version: number;\n}\n\nexport interface ControlPlaneOutbox {\n  aggregateId: string;\n  aggregateType: string;\n  attempts: Generated<number>;\n  createdAt: Generated<Timestamp>;\n  dataRegion: string | null;\n  eventType: string;\n  eventVersion: number;\n  id: Generated<string>;\n  lastError: string | null;\n  payload: Generated<Json>;\n  publishedAt: Timestamp | null;\n}\n\nexport interface ControlPlanePartnerManagedTeamAssignment {\n  createdAt: Generated<Timestamp>;\n  managedTeamId: string;\n  partnerTenantId: string;\n  userId: string;\n}\n\nexport interface ControlPlaneTenant {\n  billingPartnerId: string | null;\n  billingPlan: string | null;\n  createdAt: Generated<Timestamp>;\n  dataRegion: Generated<string>;\n  id: Generated<string>;\n  migrationStatus: Generated<string>;\n  name: string;\n  partnerId: string | null;\n  partnerDeniedPermissions: Generated<string[]>;\n  slug: string;\n  status: Generated<string | null>;\n  storageRealm: Generated<string>;\n  type: Generated<string | null>;\n  uniqueRef: string | null;\n  updatedAt: Generated<Timestamp | null>;\n}\n\nexport interface ControlPlaneTenantRegionMigration {\n  actor: string;\n  completedAt: Timestamp | null;\n  error: Json | null;\n  id: string;\n  reason: string;\n  sourceManifest: Json | null;\n  sourceRegion: string;\n  startedAt: Generated<Timestamp>;\n  status: Generated<string>;\n  targetManifest: Json | null;\n  targetRegion: string;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneTenantUser {\n  createdAt: Generated<Timestamp | null>;\n  id: Generated<string>;\n  lastInvitedAt: Timestamp | null;\n  managedTeamAccess: Generated<'all' | 'assigned'>;\n  permissionBundles: Generated<string[]>;\n  role: Generated<string | null>;\n  status: Generated<string | null>;\n  tenantId: string;\n  updatedAt: Generated<Timestamp | null>;\n  userId: string;\n}\n\nexport interface ControlPlaneToken {\n  createdAt: Generated<Timestamp>;\n  expiresAt: Timestamp | null;\n  id: Generated<string>;\n  nanoId: Generated<string>;\n  payload: Generated<Json>;\n  tenantId: string | null;\n  type: string | null;\n  userId: string | null;\n}\n\nexport interface ControlPlaneUser {\n  clerkId: string | null;\n  createdAt: Generated<Timestamp | null>;\n  email: string | null;\n  firstName: string | null;\n  id: Generated<string>;\n  internalOperationGrants: Generated<string[]>;\n  isAdmin: Generated<boolean>;\n  lastName: string | null;\n  lastSeen: Timestamp | null;\n  name: string | null;\n  partnerId: string | null;\n  phone: string | null;\n  secondaryEmails: Generated<Json>;\n  status: Generated<string | null>;\n  sub: string | null;\n  type: Generated<string | null>;\n  updatedAt: Generated<Timestamp | null>;\n}\n\nexport interface ControlPlaneDB {\n  'controlPlane.accountingIntegrityDefinitionDraft': ControlPlaneAccountingIntegrityDefinitionDraft;\n  'controlPlane.accountingIntegrityDefinitionVersion': ControlPlaneAccountingIntegrityDefinitionVersion;\n  'controlPlane.accountingIntegrityEvaluation': ControlPlaneAccountingIntegrityEvaluation;\n  'controlPlane.app': ControlPlaneApp;\n  'controlPlane.bookingChannel': ControlPlaneBookingChannel;\n  'controlPlane.bookingChannelIconCandidate': ControlPlaneBookingChannelIconCandidate;\n  'controlPlane.connectionRoute': ControlPlaneConnectionRoute;\n  'controlPlane.controlPlaneOutbox': ControlPlaneOutbox;\n  'controlPlane.currency': ControlPlaneCurrency;\n  'controlPlane.destructiveJob': ControlPlaneDestructiveJob;\n  'controlPlane.destructiveJobAttempt': ControlPlaneDestructiveJobAttempt;\n  'controlPlane.destructiveJobOperation': ControlPlaneDestructiveJobOperation;\n  'controlPlane.events': ControlPlaneEvent;\n  'controlPlane.feature': ControlPlaneFeature;\n  'controlPlane.featureApproval': ControlPlaneFeatureApproval;\n  'controlPlane.featureEnabledTeam': ControlPlaneFeatureEnabledTeam;\n  'controlPlane.generalLedgerDefaultSet': ControlPlaneGeneralLedgerDefaultSet;\n  'controlPlane.generalLedgerDefaultVersion': ControlPlaneGeneralLedgerDefaultVersion;\n  'controlPlane.lineClassification': ControlPlaneLineClassification;\n  'controlPlane.lineClassificationTeamUsage': ControlPlaneLineClassificationTeamUsage;\n  'controlPlane.operation': ControlPlaneOperation;\n  'controlPlane.operationResource': ControlPlaneOperationResource;\n  'controlPlane.operationSource': ControlPlaneOperationSource;\n  'controlPlane.partnerManagedTeamAssignment': ControlPlanePartnerManagedTeamAssignment;\n  'controlPlane.reservationLineDefault': ControlPlaneReservationLineDefault;\n  'controlPlane.rolloutMonitorSnapshot': ControlPlaneRolloutMonitorSnapshot;\n  'controlPlane.tenant': ControlPlaneTenant;\n  'controlPlane.tenantRegionMigration': ControlPlaneTenantRegionMigration;\n  'controlPlane.tenantUser': ControlPlaneTenantUser;\n  'controlPlane.trackingQueueFailure': ControlPlaneTrackingQueueFailure;\n  'controlPlane.token': ControlPlaneToken;\n  'controlPlane.transactionLineMapping': ControlPlaneTransactionLineMapping;\n  'controlPlane.user': ControlPlaneUser;\n  'controlPlaneCore.flow': ControlPlaneFlow;\n  'controlPlaneCore.issueMessageOverwrite': ControlPlaneIssueMessageOverwrite;\n}\n\nclass ControlPlaneSchemaTransformer extends OperationNodeTransformer {\n  constructor(\n    readonly schema: string,\n    readonly issueMessageOverwriteSchema: string\n  ) {\n    super();\n  }\n\n  protected override transformSchemableIdentifier(\n    node: SchemableIdentifierNode,\n    queryId: QueryId\n  ): SchemableIdentifierNode {\n    const transformed = super.transformSchemableIdentifier(node, queryId);\n    if (\n      transformed.schema?.name === 'controlPlane' ||\n      transformed.schema?.name === 'control_plane'\n    ) {\n      return { ...transformed, schema: IdentifierNode.create(this.schema) };\n    }\n    if (\n      transformed.schema?.name === 'controlPlaneCore' ||\n      transformed.schema?.name === 'control_plane_core'\n    ) {\n      return {\n        ...transformed,\n        schema: IdentifierNode.create(this.issueMessageOverwriteSchema),\n      };\n    }\n    return transformed;\n  }\n\n  protected override transformFunction(\n    node: FunctionNode,\n    queryId: QueryId\n  ): FunctionNode {\n    const transformed = super.transformFunction(node, queryId);\n    return node.func.startsWith('controlPlane.')\n      ? {\n          ...transformed,\n          func: `${this.schema}.${transformed.func.slice('controlPlane.'.length)}`,\n        }\n      : transformed;\n  }\n}\n\nclass ControlPlaneSchemaPlugin implements KyselyPlugin {\n  readonly #transformer: ControlPlaneSchemaTransformer;\n\n  constructor(schema: string, issueMessageOverwriteSchema: string) {\n    this.#transformer = new ControlPlaneSchemaTransformer(\n      schema,\n      issueMessageOverwriteSchema\n    );\n  }\n\n  transformQuery(args: PluginTransformQueryArgs): RootOperationNode {\n    return this.#transformer.transformNode(args.node, args.queryId);\n  }\n\n  async transformResult(\n    args: PluginTransformResultArgs\n  ): Promise<QueryResult<UnknownRow>> {\n    return args.result;\n  }\n}\n\nexport function withControlPlaneSchema(\n  kysely: Kysely<ControlPlaneDB>,\n  schema: string,\n  issueMessageOverwriteSchema = 'core'\n) {\n  return kysely.withPlugin(\n    new ControlPlaneSchemaPlugin(schema, issueMessageOverwriteSchema)\n  );\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["control-plane/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EAGd,wBAAwB,GAQzB,MAAM,QAAQ,CAAC;AAymBhB,MAAM,6BAA8B,SAAQ,wBAAwB;IAEvD;IACA;IAFX,YACW,MAAc,EACd,2BAAmC;QAE5C,KAAK,EAAE,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,gCAA2B,GAA3B,2BAA2B,CAAQ;IAG9C,CAAC;IAEkB,4BAA4B,CAC7C,IAA6B,EAC7B,OAAgB;QAEhB,MAAM,WAAW,GAAG,KAAK,CAAC,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtE,IACE,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,cAAc;YAC3C,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,eAAe,EAC5C,CAAC;YACD,OAAO,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxE,CAAC;QACD,IACE,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,kBAAkB;YAC/C,WAAW,CAAC,MAAM,EAAE,IAAI,KAAK,oBAAoB,EACjD,CAAC;YACD,OAAO;gBACL,GAAG,WAAW;gBACd,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC;aAChE,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAEkB,iBAAiB,CAClC,IAAkB,EAClB,OAAgB;QAEhB,MAAM,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;YAC1C,CAAC,CAAC;gBACE,GAAG,WAAW;gBACd,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE;aACzE;YACH,CAAC,CAAC,WAAW,CAAC;IAClB,CAAC;CACF;AAED,MAAM,wBAAwB;IACnB,YAAY,CAAgC;IAErD,YAAY,MAAc,EAAE,2BAAmC;QAC7D,IAAI,CAAC,YAAY,GAAG,IAAI,6BAA6B,CACnD,MAAM,EACN,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,IAA8B;QAC3C,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,IAA+B;QAE/B,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CACpC,MAA8B,EAC9B,MAAc,EACd,2BAA2B,GAAG,MAAM;IAEpC,OAAO,MAAM,CAAC,UAAU,CACtB,IAAI,wBAAwB,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAClE,CAAC;AACJ,CAAC","sourcesContent":["import {\n  type ColumnType,\n  type FunctionNode,\n  IdentifierNode,\n  type Kysely,\n  type KyselyPlugin,\n  OperationNodeTransformer,\n  type PluginTransformQueryArgs,\n  type PluginTransformResultArgs,\n  type QueryId,\n  type QueryResult,\n  type RootOperationNode,\n  type SchemableIdentifierNode,\n  type UnknownRow,\n} from 'kysely';\nimport type { TenantDataRegion } from '../regional';\n\nexport type Generated<T> =\n  T extends ColumnType<infer S, infer I, infer U>\n    ? ColumnType<S, I | undefined, U>\n    : ColumnType<T, T | undefined, T>;\n\nexport type Json = JsonValue;\n\nexport type JsonArray = JsonValue[];\n\nexport type JsonObject = {\n  [x: string]: JsonValue | undefined;\n};\n\nexport type JsonPrimitive = boolean | number | string | null;\n\nexport type JsonValue = JsonArray | JsonObject | JsonPrimitive;\n\nexport type Int8 = ColumnType<\n  string,\n  number | string | bigint,\n  number | string | bigint\n>;\n\nexport type Timestamp = ColumnType<Date | string, Date | string, Date | string>;\n\nexport type ControlPlaneOperationStatus =\n  | 'completed'\n  | 'failed'\n  | 'queued'\n  | 'running';\n\nexport type ControlPlaneOperationType =\n  | 'ach-verification'\n  | 'bank-rule-run'\n  | 'calendar-block'\n  | 'calendar-unblock'\n  | 'connection-archive'\n  | 'connection-connect'\n  | 'connection-extract'\n  | 'connection-sync'\n  | 'csv-import'\n  | 'csv-import-preview'\n  | 'export'\n  | 'flow-run'\n  | 'historical-gl-import'\n  | 'historical-statement-import'\n  | 'listing-journal-refresh'\n  | 'plaid-initial-sync'\n  | 'pms-cutover'\n  | 'pms-cutover-preview'\n  | 'provider-payment'\n  | 'provider-payment-recovery'\n  | 'recurring-transaction-run'\n  | 'reservation-journal-refresh'\n  | 'team-delete'\n  | 'team-demo-data'\n  | 'team-duplicate'\n  | 'team-initialize'\n  | 'transaction-journal-refresh'\n  | 'vri-statement-import'\n  | 'vri-team-migration'\n  | 'webhook-test';\n\nexport type ControlPlaneOperationResourceRole = 'result' | 'source' | 'target';\n\nexport type ControlPlaneOperationResourceType =\n  | 'bank-rule'\n  | 'connection'\n  | 'contact'\n  | 'file'\n  | 'flow'\n  | 'listing'\n  | 'recurring-fee'\n  | 'recurring-transaction-template'\n  | 'reservation'\n  | 'statement'\n  | 'team'\n  | 'transaction'\n  | 'webhook';\n\nexport type ControlPlaneOperationSourceType =\n  | 'destructive-job'\n  | 'regional-operation';\n\nexport interface ControlPlaneApp {\n  authentication: Generated<Json>;\n  category: string | null;\n  color: string | null;\n  createdAt: Generated<Timestamp>;\n  icon: string | null;\n  iconRound: string | null;\n  id: Generated<string>;\n  info: Json | null;\n  name: string;\n  type: string;\n  version: Generated<number>;\n}\n\nexport interface ControlPlaneAccountingIntegrityEvaluation {\n  caseCount: Generated<Int8>;\n  completedAt: Timestamp | null;\n  completedRunCount: Generated<number>;\n  createdAt: Generated<Timestamp>;\n  environment: string;\n  error: Json | null;\n  expectedRunCount: number;\n  failedRunCount: Generated<number>;\n  findingRowCount: Generated<Int8>;\n  gitRevision: string;\n  id: string;\n  results: Generated<Json>;\n  rowsScanned: Generated<Int8>;\n  skippedRunCount: Generated<number>;\n  source: string;\n  startedAt: Timestamp;\n  status: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneAccountingIntegrityDefinitionDraft {\n  artifact: Json;\n  artifactHash: string;\n  code: string;\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  ownerId: string;\n  previewResult: Json | null;\n  rationale: string;\n  revision: Generated<number>;\n  status: string;\n  templateId: string;\n  templateVersion: number;\n  title: string;\n  updatedAt: Generated<Timestamp>;\n  validationResult: Json | null;\n}\n\nexport interface ControlPlaneAccountingIntegrityDefinitionVersion {\n  artifact: Json;\n  artifactHash: string;\n  code: string;\n  draftId: string;\n  id: Generated<string>;\n  publishedAt: Generated<Timestamp>;\n  publishedBy: string;\n  rollout: string;\n  templateId: string;\n  templateVersion: number;\n  version: number;\n}\n\nexport interface ControlPlaneBookingChannel {\n  channelRef: string | null;\n  color: string | null;\n  createdAt: Generated<Timestamp>;\n  icon: string | null;\n  iconProvider: string | null;\n  id: Generated<string>;\n  lastGenerateRun: Timestamp | null;\n  logo: string | null;\n  logoProvider: string | null;\n  selectedBookingChannelIconCandidateId: string | null;\n  selectedBookingChannelLogoCandidateId: string | null;\n  uniqueRef: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneBookingChannelIconCandidate {\n  bookingChannelId: string;\n  cloudflareImageId: string | null;\n  color: string | null;\n  comment: string | null;\n  createdAt: Generated<Timestamp>;\n  externalIcon: string | null;\n  height: number | null;\n  id: Generated<string>;\n  provider: Generated<string>;\n  source: string | null;\n  updatedAt: Generated<Timestamp>;\n  width: number | null;\n}\n\nexport interface ControlPlaneCurrency {\n  name: string;\n}\n\nexport type DestructiveJobStep =\n  | 'completed'\n  | 'completion_effects'\n  | 'control_plane_deleted'\n  | 'control_plane_deleting'\n  | 'queued'\n  | 'regional_deleted'\n  | 'regional_deleting'\n  | 'validated';\n\nexport interface ControlPlaneDestructiveJob {\n  attempts: Generated<number>;\n  authorizedByTenantId: string;\n  availableAt: Generated<Timestamp>;\n  claimedAt: Timestamp | null;\n  claimedBy: string | null;\n  completedAt: Timestamp | null;\n  completionData: Json | null;\n  completionWarningCode: string | null;\n  completionWarningDetails: Json | null;\n  createdAt: Generated<Timestamp>;\n  dataRegion: TenantDataRegion;\n  failureCode: string | null;\n  failureDetails: Json | null;\n  force: Generated<boolean>;\n  id: Generated<string>;\n  jobType: 'tenant.delete';\n  maxAttempts: Generated<number>;\n  requestId: string | null;\n  requestedByActorType: 'api_key' | 'system' | 'user';\n  requestedByTenantId: string;\n  requestedByUserId: string | null;\n  startedAt: Timestamp | null;\n  status: Generated<'canceled' | 'completed' | 'failed' | 'queued' | 'running'>;\n  step: Generated<DestructiveJobStep>;\n  targetId: string;\n  triggerRunId: string | null;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneDestructiveJobAttempt {\n  attemptNumber: number;\n  failureCode: string | null;\n  failureDetails: Json | null;\n  finishedAt: Timestamp | null;\n  id: Generated<string>;\n  jobId: string;\n  startedAt: Generated<Timestamp>;\n  status: Generated<'completed' | 'failed' | 'running' | 'superseded'>;\n  step: DestructiveJobStep;\n  triggerRunId: string | null;\n}\n\nexport interface ControlPlaneDestructiveJobOperation {\n  action: 'abandon' | 'cancel' | 'retry';\n  actor: string;\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  jobId: string;\n  previousStatus: string;\n  previousStep: string;\n  reasonCode: string;\n}\n\nexport interface ControlPlaneOperation {\n  createdAt: Generated<Timestamp>;\n  failureCode: string | null;\n  failureMessage: string | null;\n  finishedAt: Timestamp | null;\n  id: Generated<string>;\n  initiatedByUserId: string | null;\n  requesterTenantId: string;\n  retainUntil: Timestamp | null;\n  sourceRegion: TenantDataRegion | null;\n  sourceVersion: Generated<number>;\n  startedAt: Timestamp | null;\n  status: Generated<ControlPlaneOperationStatus>;\n  type: ControlPlaneOperationType;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneOperationResource {\n  createdAt: Generated<Timestamp>;\n  isPrimary: Generated<boolean>;\n  operationId: string;\n  resourceId: string;\n  resourceType: ControlPlaneOperationResourceType;\n  role: ControlPlaneOperationResourceRole;\n}\n\nexport interface ControlPlaneOperationSource {\n  finishedAt: Timestamp | null;\n  operationId: string;\n  required: Generated<boolean>;\n  sourceId: string;\n  sourceType: ControlPlaneOperationSourceType;\n  sourceVersion: Generated<number>;\n  startedAt: Timestamp | null;\n  status: Generated<ControlPlaneOperationStatus>;\n}\n\nexport interface ControlPlaneEvent {\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  name: string;\n  packageName: string;\n  props: Json;\n  tenantId: string | null;\n  timestamp: Generated<Timestamp>;\n  trackedAt: Generated<Timestamp | null>;\n  userId: string | null;\n}\n\nexport interface ControlPlaneTrackingQueueFailure {\n  bodyFingerprint: string | null;\n  capturedAt: Generated<Timestamp>;\n  dispositionAt: Timestamp | null;\n  dispositionHistory: Generated<Json[]>;\n  dispositionReasonCode: string | null;\n  dispositionActor: string | null;\n  environment: 'production' | 'staging';\n  event: Json | null;\n  eventId: string | null;\n  expiresAt: Timestamp;\n  failureCode: string;\n  id: Generated<string>;\n  lastReplayedAt: Timestamp | null;\n  queueMessageId: string;\n  replayCount: Generated<number>;\n  recurrenceCount: Generated<number>;\n  status: Generated<'captured' | 'discarded' | 'replayed'>;\n  updatedAt: Generated<Timestamp>;\n  validationIssues: Json | null;\n}\n\nexport interface ControlPlaneConnectionRoute {\n  connectionId: string;\n  createdAt: Generated<Timestamp>;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneFeature {\n  createdAt: Generated<Timestamp>;\n  description: string | null;\n  id: Generated<string>;\n  issueUrl: string | null;\n  requiredApprovals: Generated<Json | null>;\n  status: Generated<string | null>;\n  tenantId: string | null;\n  title: string;\n  updatedAt: Generated<Timestamp>;\n  url: string | null;\n}\n\nexport interface ControlPlaneFeatureEnabledTeam {\n  createdAt: Generated<Timestamp>;\n  featureId: string;\n  id: Generated<string>;\n  status: Generated<string | null>;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneFeatureApproval {\n  createdAt: Generated<Timestamp>;\n  featureId: string;\n  id: Generated<string>;\n  status: Generated<string | null>;\n  updatedAt: Generated<Timestamp>;\n  userId: string;\n}\n\nexport interface ControlPlaneFlow {\n  appId: string;\n  createdAt: Generated<Timestamp>;\n  description: string | null;\n  eventListening: Generated<Json>;\n  id: Generated<string>;\n  isPublic: Generated<boolean>;\n  leftType: string | null;\n  mappingSchema: Generated<Json>;\n  revision: Generated<number>;\n  rightType: string | null;\n  runSchema: Generated<Json>;\n  settingSchema: Generated<Json>;\n  title: string;\n  type: 'pull' | 'push' | null;\n  uniqueRef: string;\n  updatedAt: Generated<Timestamp>;\n  useGlobalMapping: Generated<boolean>;\n}\n\nexport interface ControlPlaneIssueMessageOverwrite {\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  message: string;\n  pattern: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneLineClassification {\n  appConflict: Generated<boolean>;\n  appId: string | null;\n  createdAt: Generated<Timestamp>;\n  firstSeenAt: Timestamp;\n  id: Generated<string>;\n  kind: string;\n  lastSeenAt: Timestamp;\n  name: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneLineClassificationTeamUsage {\n  classificationId: string;\n  createdAt: Generated<Timestamp>;\n  dataRegion: string;\n  firstSeenAt: Timestamp;\n  lastSeenAt: Timestamp;\n  mappingStatus: string | null;\n  revision: number;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneReservationLineDefault {\n  accountKey: string | null;\n  bookingChannel: string | null;\n  bookingChannelKey: Generated<string>;\n  classificationId: string;\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  partnerTenantId: string | null;\n  revenueRecognition: string | null;\n  revision: Generated<number>;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneRolloutMonitorSnapshot {\n  monitorName: string;\n  result: Json;\n  snapshotDate: Timestamp;\n}\n\nexport interface ControlPlaneTransactionLineMapping {\n  accountAssignmentType: string | null;\n  createdAt: Generated<Timestamp>;\n  deletedAt: Timestamp | null;\n  id: Generated<string>;\n  lineType: string;\n  revision: Generated<number>;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneGeneralLedgerDefaultSet {\n  createdAt: Generated<Timestamp>;\n  id: Generated<string>;\n  partnerTenantId: string | null;\n  publishedVersion: number | null;\n  sourceDataRegion: string;\n  sourceDigest: string | null;\n  sourceTenantId: string;\n  templateKey: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneGeneralLedgerDefaultVersion {\n  dataJson: Json;\n  defaultSetId: string;\n  id: Generated<string>;\n  publishedAt: Generated<Timestamp>;\n  sourceDigest: string;\n  sourceTenantId: string;\n  version: number;\n}\n\nexport interface ControlPlaneOutbox {\n  aggregateId: string;\n  aggregateType: string;\n  attempts: Generated<number>;\n  createdAt: Generated<Timestamp>;\n  dataRegion: string | null;\n  eventType: string;\n  eventVersion: number;\n  id: Generated<string>;\n  lastError: string | null;\n  payload: Generated<Json>;\n  publishedAt: Timestamp | null;\n}\n\nexport interface ControlPlanePartnerManagedTeamAssignment {\n  createdAt: Generated<Timestamp>;\n  managedTeamId: string;\n  partnerTenantId: string;\n  userId: string;\n}\n\nexport interface ControlPlaneOwnerPortal {\n  hostname: string;\n  tenantId: string;\n  status: Generated<'pending' | 'active' | 'disabled'>;\n  name: string;\n  logo: string | null;\n  colorPrimary: string;\n  showPlatformBranding: Generated<boolean>;\n  linksEnabled: Generated<boolean>;\n  sender: { from: string; replyTo: string } | null;\n  revision: Generated<number>;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneTenant {\n  billingPartnerId: string | null;\n  billingPlan: string | null;\n  createdAt: Generated<Timestamp>;\n  dataRegion: Generated<string>;\n  id: Generated<string>;\n  migrationStatus: Generated<string>;\n  name: string;\n  partnerId: string | null;\n  partnerDeniedPermissions: Generated<string[]>;\n  slug: string;\n  status: Generated<string | null>;\n  storageRealm: Generated<string>;\n  type: Generated<string | null>;\n  uniqueRef: string | null;\n  updatedAt: Generated<Timestamp | null>;\n}\n\nexport interface ControlPlaneTenantRegionMigration {\n  actor: string;\n  completedAt: Timestamp | null;\n  error: Json | null;\n  id: string;\n  reason: string;\n  sourceManifest: Json | null;\n  sourceRegion: string;\n  startedAt: Generated<Timestamp>;\n  status: Generated<string>;\n  targetManifest: Json | null;\n  targetRegion: string;\n  tenantId: string;\n  updatedAt: Generated<Timestamp>;\n}\n\nexport interface ControlPlaneTenantUser {\n  createdAt: Generated<Timestamp | null>;\n  id: Generated<string>;\n  lastInvitedAt: Timestamp | null;\n  managedTeamAccess: Generated<'all' | 'assigned'>;\n  permissionBundles: Generated<string[]>;\n  role: Generated<string | null>;\n  status: Generated<string | null>;\n  tenantId: string;\n  updatedAt: Generated<Timestamp | null>;\n  userId: string;\n}\n\nexport interface ControlPlaneToken {\n  createdAt: Generated<Timestamp>;\n  expiresAt: Timestamp | null;\n  id: Generated<string>;\n  nanoId: Generated<string>;\n  payload: Generated<Json>;\n  tenantId: string | null;\n  type: string | null;\n  userId: string | null;\n}\n\nexport interface ControlPlaneUser {\n  clerkId: string | null;\n  createdAt: Generated<Timestamp | null>;\n  email: string | null;\n  firstName: string | null;\n  id: Generated<string>;\n  internalOperationGrants: Generated<string[]>;\n  isAdmin: Generated<boolean>;\n  lastName: string | null;\n  lastSeen: Timestamp | null;\n  name: string | null;\n  partnerId: string | null;\n  phone: string | null;\n  secondaryEmails: Generated<Json>;\n  status: Generated<string | null>;\n  sub: string | null;\n  type: Generated<string | null>;\n  updatedAt: Generated<Timestamp | null>;\n}\n\nexport interface ControlPlaneDB {\n  'controlPlane.accountingIntegrityDefinitionDraft': ControlPlaneAccountingIntegrityDefinitionDraft;\n  'controlPlane.accountingIntegrityDefinitionVersion': ControlPlaneAccountingIntegrityDefinitionVersion;\n  'controlPlane.accountingIntegrityEvaluation': ControlPlaneAccountingIntegrityEvaluation;\n  'controlPlane.app': ControlPlaneApp;\n  'controlPlane.bookingChannel': ControlPlaneBookingChannel;\n  'controlPlane.bookingChannelIconCandidate': ControlPlaneBookingChannelIconCandidate;\n  'controlPlane.connectionRoute': ControlPlaneConnectionRoute;\n  'controlPlane.controlPlaneOutbox': ControlPlaneOutbox;\n  'controlPlane.currency': ControlPlaneCurrency;\n  'controlPlane.destructiveJob': ControlPlaneDestructiveJob;\n  'controlPlane.destructiveJobAttempt': ControlPlaneDestructiveJobAttempt;\n  'controlPlane.destructiveJobOperation': ControlPlaneDestructiveJobOperation;\n  'controlPlane.events': ControlPlaneEvent;\n  'controlPlane.feature': ControlPlaneFeature;\n  'controlPlane.featureApproval': ControlPlaneFeatureApproval;\n  'controlPlane.featureEnabledTeam': ControlPlaneFeatureEnabledTeam;\n  'controlPlane.generalLedgerDefaultSet': ControlPlaneGeneralLedgerDefaultSet;\n  'controlPlane.generalLedgerDefaultVersion': ControlPlaneGeneralLedgerDefaultVersion;\n  'controlPlane.lineClassification': ControlPlaneLineClassification;\n  'controlPlane.lineClassificationTeamUsage': ControlPlaneLineClassificationTeamUsage;\n  'controlPlane.operation': ControlPlaneOperation;\n  'controlPlane.operationResource': ControlPlaneOperationResource;\n  'controlPlane.operationSource': ControlPlaneOperationSource;\n  'controlPlane.partnerManagedTeamAssignment': ControlPlanePartnerManagedTeamAssignment;\n  'controlPlane.reservationLineDefault': ControlPlaneReservationLineDefault;\n  'controlPlane.rolloutMonitorSnapshot': ControlPlaneRolloutMonitorSnapshot;\n  'controlPlane.ownerPortal': ControlPlaneOwnerPortal;\n  'controlPlane.tenant': ControlPlaneTenant;\n  'controlPlane.tenantRegionMigration': ControlPlaneTenantRegionMigration;\n  'controlPlane.tenantUser': ControlPlaneTenantUser;\n  'controlPlane.trackingQueueFailure': ControlPlaneTrackingQueueFailure;\n  'controlPlane.token': ControlPlaneToken;\n  'controlPlane.transactionLineMapping': ControlPlaneTransactionLineMapping;\n  'controlPlane.user': ControlPlaneUser;\n  'controlPlaneCore.flow': ControlPlaneFlow;\n  'controlPlaneCore.issueMessageOverwrite': ControlPlaneIssueMessageOverwrite;\n}\n\nclass ControlPlaneSchemaTransformer extends OperationNodeTransformer {\n  constructor(\n    readonly schema: string,\n    readonly issueMessageOverwriteSchema: string\n  ) {\n    super();\n  }\n\n  protected override transformSchemableIdentifier(\n    node: SchemableIdentifierNode,\n    queryId: QueryId\n  ): SchemableIdentifierNode {\n    const transformed = super.transformSchemableIdentifier(node, queryId);\n    if (\n      transformed.schema?.name === 'controlPlane' ||\n      transformed.schema?.name === 'control_plane'\n    ) {\n      return { ...transformed, schema: IdentifierNode.create(this.schema) };\n    }\n    if (\n      transformed.schema?.name === 'controlPlaneCore' ||\n      transformed.schema?.name === 'control_plane_core'\n    ) {\n      return {\n        ...transformed,\n        schema: IdentifierNode.create(this.issueMessageOverwriteSchema),\n      };\n    }\n    return transformed;\n  }\n\n  protected override transformFunction(\n    node: FunctionNode,\n    queryId: QueryId\n  ): FunctionNode {\n    const transformed = super.transformFunction(node, queryId);\n    return node.func.startsWith('controlPlane.')\n      ? {\n          ...transformed,\n          func: `${this.schema}.${transformed.func.slice('controlPlane.'.length)}`,\n        }\n      : transformed;\n  }\n}\n\nclass ControlPlaneSchemaPlugin implements KyselyPlugin {\n  readonly #transformer: ControlPlaneSchemaTransformer;\n\n  constructor(schema: string, issueMessageOverwriteSchema: string) {\n    this.#transformer = new ControlPlaneSchemaTransformer(\n      schema,\n      issueMessageOverwriteSchema\n    );\n  }\n\n  transformQuery(args: PluginTransformQueryArgs): RootOperationNode {\n    return this.#transformer.transformNode(args.node, args.queryId);\n  }\n\n  async transformResult(\n    args: PluginTransformResultArgs\n  ): Promise<QueryResult<UnknownRow>> {\n    return args.result;\n  }\n}\n\nexport function withControlPlaneSchema(\n  kysely: Kysely<ControlPlaneDB>,\n  schema: string,\n  issueMessageOverwriteSchema = 'core'\n) {\n  return kysely.withPlugin(\n    new ControlPlaneSchemaPlugin(schema, issueMessageOverwriteSchema)\n  );\n}\n"]}

package/build/module/index.d.ts

@@ -8,12 +8,22 @@ export * from './postgres-error';
 export * from './query';
 export * from './regional';
 export * from './transaction';
+import type { TenantDataRegion } from './regional';
 import type { DB } from './v1.generated';
 type KyselyOpts = {
+    dataRegion?: TenantDataRegion;
     hyperdrive?: true;
+    onRetryDiagnostic?: (diagnostic: PostgresRetryDiagnostic) => void;
     repositoryName?: string;
     log?: true | LogConfig;
 };
+type PostgresRetryDiagnostic = {
+    attemptCount: number;
+    dataRegion?: TenantDataRegion;
+    operationKind: 'acquisition' | 'mutation' | 'select' | 'transaction';
+    outcome: 'exhausted' | 'notRetryable' | 'retrying';
+    repositoryName?: string;
+};
 type PgOpt = {
     forceDisableSSL?: boolean;
     probe?: true;
@@ -25,5 +35,6 @@ export type ControlPlaneTransaction = T<ControlPlaneDB>;
 export declare function useKysely<Database = DB>(postgres: Sql, options?: KyselyOpts): K<Database>;
 export declare function useAsyncPostgres(connectionString: string, opt?: PgOpt): Promise<postgres.Sql<{}>>;
 export declare function useAsyncKysely(connectionString: string, opt?: PgOpt & KyselyOpts): Promise<K<DB>>;
+export declare function useAsyncNeonWebSocketKysely(connectionString: string, opt?: Pick<PgOpt, 'probe'> & KyselyOpts): Promise<K<DB>>;
 export declare function useAsyncControlPlaneKysely(connectionString: string, opt?: PgOpt & KyselyOpts): Promise<K<ControlPlaneDB>>;
 export declare function forceCloseAllPostgres(timeoutMs?: number): Promise<void>;