@vrplatform/kysely 1.3.45-4658 → 1.3.45-4684

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

@@ -89,6 +89,7 @@ export interface ControlPlaneTenant {
     status: Generated<string | null>;
     storageRealm: Generated<string>;
     type: Generated<string | null>;
+    uniqueRef: string | null;
     updatedAt: Generated<Timestamp | null>;
 }
 export interface ControlPlaneTenantUser {
@@ -121,6 +122,7 @@ export interface ControlPlaneUser {
     lastName: string | null;
     name: string | null;
     partnerId: string | null;
+    phone: string | null;
     secondaryEmails: Generated<Json>;
     status: Generated<string | null>;
     sub: string | null;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"src/","sources":["control-plane/index.ts"],"names":[],"mappings":"","sourcesContent":["import type { ColumnType, Kysely as K } from 'kysely';\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 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 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 ControlPlaneCurrency {\n  name: string;\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 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 ControlPlaneTenant {\n  billingPlan: string | null;\n  createdAt: Generated<Timestamp>;\n  dataRegion: Generated<string>;\n  id: Generated<string>;\n  name: string;\n  partnerId: string | null;\n  slug: string;\n  status: Generated<string | null>;\n  storageRealm: Generated<string>;\n  type: Generated<string | null>;\n  updatedAt: Generated<Timestamp | null>;\n}\n\nexport interface ControlPlaneTenantUser {\n  createdAt: Generated<Timestamp | null>;\n  id: Generated<string>;\n  lastInvitedAt: Timestamp | null;\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  isAdmin: Generated<boolean>;\n  lastName: string | null;\n  name: string | null;\n  partnerId: 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  'public.app': ControlPlaneApp;\n  'public.bookingChannel': ControlPlaneBookingChannel;\n  'public.connectionRoute': ControlPlaneConnectionRoute;\n  'public.currency': ControlPlaneCurrency;\n  'public.feature': ControlPlaneFeature;\n  'public.featureEnabledTeam': ControlPlaneFeatureEnabledTeam;\n  'public.controlPlaneOutbox': ControlPlaneOutbox;\n  'public.tenant': ControlPlaneTenant;\n  'public.tenantUser': ControlPlaneTenantUser;\n  'public.token': ControlPlaneToken;\n  'public.user': ControlPlaneUser;\n}\n\nexport type ControlPlaneKysely = K<ControlPlaneDB>;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["control-plane/index.ts"],"names":[],"mappings":"","sourcesContent":["import type { ColumnType, Kysely as K } from 'kysely';\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 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 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 ControlPlaneCurrency {\n  name: string;\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 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 ControlPlaneTenant {\n  billingPlan: string | null;\n  createdAt: Generated<Timestamp>;\n  dataRegion: Generated<string>;\n  id: Generated<string>;\n  name: string;\n  partnerId: string | null;\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 ControlPlaneTenantUser {\n  createdAt: Generated<Timestamp | null>;\n  id: Generated<string>;\n  lastInvitedAt: Timestamp | null;\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  isAdmin: Generated<boolean>;\n  lastName: string | 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  'public.app': ControlPlaneApp;\n  'public.bookingChannel': ControlPlaneBookingChannel;\n  'public.connectionRoute': ControlPlaneConnectionRoute;\n  'public.currency': ControlPlaneCurrency;\n  'public.feature': ControlPlaneFeature;\n  'public.featureEnabledTeam': ControlPlaneFeatureEnabledTeam;\n  'public.controlPlaneOutbox': ControlPlaneOutbox;\n  'public.tenant': ControlPlaneTenant;\n  'public.tenantUser': ControlPlaneTenantUser;\n  'public.token': ControlPlaneToken;\n  'public.user': ControlPlaneUser;\n}\n\nexport type ControlPlaneKysely = K<ControlPlaneDB>;\n"]}

package/build/main/query/index.d.ts

@@ -1 +1,2 @@
 export * from './listing';
+export * from './tenant';

package/build/main/query/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./listing"), exports);
+__exportStar(require("./tenant"), exports);
 //# sourceMappingURL=index.js.map

package/build/main/query/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"src/","sources":["query/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B","sourcesContent":["export * from './listing';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["query/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB","sourcesContent":["export * from './listing';\nexport * from './tenant';\n"]}

package/build/main/query/tenant/index.d.ts

@@ -0,0 +1 @@
+export * from './status';

package/build/main/query/tenant/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./status"), exports);
+//# sourceMappingURL=index.js.map

package/build/main/query/tenant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["query/tenant/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB","sourcesContent":["export * from './status';\n"]}

package/build/main/query/tenant/status.d.ts

@@ -0,0 +1,20 @@
+import type { DB, ExpressionBuilder, PublicTenant } from '../../isomorphic';
+type TenantExpressionBuilder = ExpressionBuilder<DB & {
+    tenant: PublicTenant;
+}, 'tenant'>;
+export declare function whereTenantActive(eb: TenantExpressionBuilder): import("kysely").ExpressionWrapper<DB & {
+    tenant: PublicTenant;
+}, "tenant", import("kysely/dist/cjs/util/type-utils").SqlBool>;
+export declare function whereTenantNotTestTeam(eb: TenantExpressionBuilder, { excludedTenantIds, testPartnerTenantId, }: {
+    excludedTenantIds: readonly [string, ...string[]];
+    testPartnerTenantId: string;
+}): import("kysely").ExpressionWrapper<DB & {
+    tenant: PublicTenant;
+}, "tenant", import("kysely/dist/cjs/util/type-utils").SqlBool>;
+export declare function whereTenantShouldBePaid(eb: TenantExpressionBuilder, { includePartnerTeams, today, }?: {
+    includePartnerTeams?: boolean;
+    today?: Date | string;
+}): import("kysely").ExpressionWrapper<DB & {
+    tenant: PublicTenant;
+}, "tenant", import("kysely/dist/cjs/util/type-utils").SqlBool>;
+export {};

package/build/main/query/tenant/status.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.whereTenantActive = whereTenantActive;
+exports.whereTenantNotTestTeam = whereTenantNotTestTeam;
+exports.whereTenantShouldBePaid = whereTenantShouldBePaid;
+const utils_1 = require("@vrplatform/utils");
+function whereTenantActive(eb) {
+    return eb.and([
+        eb('tenant.calculatedStatus', '=', 'active'),
+        eb.or([
+            eb('tenant.calculatedBillingPartnerId', 'is', null),
+            eb.exists(eb
+                .selectFrom('public.tenant as billingPartner')
+                .select('billingPartner.id')
+                .whereRef('billingPartner.id', '=', 'tenant.calculatedBillingPartnerId')
+                .where('billingPartner.calculatedStatus', '=', 'active')),
+        ]),
+    ]);
+}
+function whereTenantNotTestTeam(eb, { excludedTenantIds, testPartnerTenantId, }) {
+    return eb.and([
+        eb('tenant.id', 'not in', [...excludedTenantIds]),
+        eb('tenant.partnerId', '!=', testPartnerTenantId),
+        eb.or([
+            eb('tenant.billingPartnerId', 'is', null),
+            eb('tenant.billingPartnerId', '!=', testPartnerTenantId),
+        ]),
+    ]);
+}
+function whereTenantShouldBePaid(eb, { includePartnerTeams = false, today = (0, utils_1.day)().yyyymmdd(), } = {}) {
+    return eb.and([
+        whereTenantActive(eb),
+        eb('tenant.isOnboarding', '=', false),
+        eb.or([
+            eb('tenant.trialUntil', '<', today),
+            eb('tenant.trialUntil', 'is', null),
+        ]),
+        ...(includePartnerTeams
+            ? []
+            : [eb('tenant.calculatedIsBillable', '=', true)]),
+    ]);
+}
+//# sourceMappingURL=status.js.map

package/build/main/query/tenant/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"src/","sources":["query/tenant/status.ts"],"names":[],"mappings":";;AAQA,8CAkBC;AAED,wDAkBC;AAED,0DAqBC;AArED,6CAAwC;AAQxC,SAAgB,iBAAiB,CAAC,EAA2B;IAC3D,OAAO,EAAE,CAAC,GAAG,CAAC;QACZ,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE,QAAQ,CAAC;QAC5C,EAAE,CAAC,EAAE,CAAC;YACJ,EAAE,CAAC,mCAAmC,EAAE,IAAI,EAAE,IAAI,CAAC;YACnD,EAAE,CAAC,MAAM,CACP,EAAE;iBACC,UAAU,CAAC,iCAAiC,CAAC;iBAC7C,MAAM,CAAC,mBAAmB,CAAC;iBAC3B,QAAQ,CACP,mBAAmB,EACnB,GAAG,EACH,mCAAmC,CACpC;iBACA,KAAK,CAAC,iCAAiC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAC3D;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,sBAAsB,CACpC,EAA2B,EAC3B,EACE,iBAAiB,EACjB,mBAAmB,GAIpB;IAED,OAAO,EAAE,CAAC,GAAG,CAAC;QACZ,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC;QACjD,EAAE,CAAC,kBAAkB,EAAE,IAAI,EAAE,mBAAmB,CAAC;QACjD,EAAE,CAAC,EAAE,CAAC;YACJ,EAAE,CAAC,yBAAyB,EAAE,IAAI,EAAE,IAAI,CAAC;YACzC,EAAE,CAAC,yBAAyB,EAAE,IAAI,EAAE,mBAAmB,CAAC;SACzD,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,uBAAuB,CACrC,EAA2B,EAC3B,EACE,mBAAmB,GAAG,KAAK,EAC3B,KAAK,GAAG,IAAA,WAAG,GAAE,CAAC,QAAQ,EAAE,MAItB,EAAE;IAEN,OAAO,EAAE,CAAC,GAAG,CAAC;QACZ,iBAAiB,CAAC,EAAE,CAAC;QACrB,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE,KAAK,CAAC;QACrC,EAAE,CAAC,EAAE,CAAC;YACJ,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE,KAAK,CAAC;YACnC,EAAE,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC;SACpC,CAAC;QACF,GAAG,CAAC,mBAAmB;YACrB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;KACpD,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { day } from '@vrplatform/utils';\nimport type { DB, ExpressionBuilder, PublicTenant } from '../../isomorphic';\n\ntype TenantExpressionBuilder = ExpressionBuilder<\n  DB & { tenant: PublicTenant },\n  'tenant'\n>;\n\nexport function whereTenantActive(eb: TenantExpressionBuilder) {\n  return eb.and([\n    eb('tenant.calculatedStatus', '=', 'active'),\n    eb.or([\n      eb('tenant.calculatedBillingPartnerId', 'is', null),\n      eb.exists(\n        eb\n          .selectFrom('public.tenant as billingPartner')\n          .select('billingPartner.id')\n          .whereRef(\n            'billingPartner.id',\n            '=',\n            'tenant.calculatedBillingPartnerId'\n          )\n          .where('billingPartner.calculatedStatus', '=', 'active')\n      ),\n    ]),\n  ]);\n}\n\nexport function whereTenantNotTestTeam(\n  eb: TenantExpressionBuilder,\n  {\n    excludedTenantIds,\n    testPartnerTenantId,\n  }: {\n    excludedTenantIds: readonly [string, ...string[]];\n    testPartnerTenantId: string;\n  }\n) {\n  return eb.and([\n    eb('tenant.id', 'not in', [...excludedTenantIds]),\n    eb('tenant.partnerId', '!=', testPartnerTenantId),\n    eb.or([\n      eb('tenant.billingPartnerId', 'is', null),\n      eb('tenant.billingPartnerId', '!=', testPartnerTenantId),\n    ]),\n  ]);\n}\n\nexport function whereTenantShouldBePaid(\n  eb: TenantExpressionBuilder,\n  {\n    includePartnerTeams = false,\n    today = day().yyyymmdd(),\n  }: {\n    includePartnerTeams?: boolean;\n    today?: Date | string;\n  } = {}\n) {\n  return eb.and([\n    whereTenantActive(eb),\n    eb('tenant.isOnboarding', '=', false),\n    eb.or([\n      eb('tenant.trialUntil', '<', today),\n      eb('tenant.trialUntil', 'is', null),\n    ]),\n    ...(includePartnerTeams\n      ? []\n      : [eb('tenant.calculatedIsBillable', '=', true)]),\n  ]);\n}\n"]}

package/build/main/regional.d.ts

@@ -14,6 +14,27 @@ export declare function useTenantDatabaseKysely(dataRegion: TenantDataRegion, re
     useAsyncKysely?: UseAsyncRegionalKysely;
     probe?: true;
 }): Promise<Kysely>;
+export type TenantKysely = {
+    id: string;
+    slug: string;
+    dataRegion: TenantDataRegion;
+    kysely: Kysely;
+};
+/**
+ * Resolve a tenant's regional Kysely connection from a connection id, slug,
+ * or tenant id. The control-plane connection is opened and destroyed
+ * internally; the returned regional connection must be destroyed by the
+ * caller.
+ */
+export declare function resolveTenantKysely({ connectionId, slug, tenantId, repositoryName, env, ...options }: {
+    connectionId?: string;
+    slug?: string;
+    tenantId?: string;
+    repositoryName: string;
+    env: RegionEnvironment;
+    useAsyncKysely?: UseAsyncRegionalKysely;
+    probe?: true;
+}): Promise<TenantKysely>;
 export type RegionRunError = {
     dataRegion: TenantDataRegion;
     error: string;

package/build/main/regional.js

@@ -39,6 +39,7 @@ exports.resolveTenantDatabaseUrl = resolveTenantDatabaseUrl;
 exports.resolveTenantApiBaseUrl = resolveTenantApiBaseUrl;
 exports.resolveConfiguredTenantDataRegions = resolveConfiguredTenantDataRegions;
 exports.useTenantDatabaseKysely = useTenantDatabaseKysely;
+exports.resolveTenantKysely = resolveTenantKysely;
 exports.forEachConfiguredRegion = forEachConfiguredRegion;
 // The tenant-data-region contract lives here — the region set plus how a
 // region resolves to its database url, API base url, and how to fan a job out
@@ -115,6 +116,53 @@ async function useTenantDatabaseKysely(dataRegion, repositoryName, env, options
         probe: options.probe,
     });
 }
+/**
+ * Resolve a tenant's regional Kysely connection from a connection id, slug,
+ * or tenant id. The control-plane connection is opened and destroyed
+ * internally; the returned regional connection must be destroyed by the
+ * caller.
+ */
+async function resolveTenantKysely({ connectionId, slug, tenantId, repositoryName, env, ...options }) {
+    if (!connectionId && !slug && !tenantId) {
+        throw new Error('connectionId, slug, or tenantId is required');
+    }
+    const controlPlaneDatabaseUrl = env.CONTROL_PLANE_DATABASE_URL;
+    if (!controlPlaneDatabaseUrl)
+        throw new Error('CONTROL_PLANE_DATABASE_URL is required');
+    const controlPlane = await (options.useAsyncKysely ?? defaultUseAsyncKysely)(controlPlaneDatabaseUrl, {
+        repositoryName: `${repositoryName}/control-plane`,
+        probe: options.probe,
+    });
+    let tenant;
+    try {
+        const query = controlPlane
+            .selectFrom('public.tenant')
+            .select([
+            'public.tenant.id as id',
+            'public.tenant.slug as slug',
+            'public.tenant.dataRegion as dataRegion',
+        ]);
+        tenant = await (slug
+            ? query.where('public.tenant.slug', '=', slug)
+            : connectionId
+                ? query
+                    .innerJoin('public.connectionRoute', 'public.connectionRoute.tenantId', 'public.tenant.id')
+                    .where('public.connectionRoute.connectionId', '=', connectionId)
+                : query.where('public.tenant.id', '=', tenantId)).executeTakeFirst();
+    }
+    finally {
+        await controlPlane.destroy();
+    }
+    if (!tenant)
+        throw new Error('Tenant not found in control plane');
+    assertTenantDataRegion(tenant.dataRegion);
+    return {
+        id: tenant.id,
+        slug: tenant.slug,
+        dataRegion: tenant.dataRegion,
+        kysely: await useTenantDatabaseKysely(tenant.dataRegion, repositoryName, env, options),
+    };
+}
 /**
  * Run a job once per configured tenant data region with per-region error
  * isolation: one region's outage must not stall the others (regions iterate

package/build/main/regional.js.map

@@ -1 +1 @@
-{"version":3,"file":"regional.js","sourceRoot":"src/","sources":["regional.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Kysely } from './index';\n\n// The tenant-data-region contract lives here — the region set plus how a\n// region resolves to its database url, API base url, and how to fan a job out\n// across regions. Every runtime resolves regions through these functions;\n// @vrplatform/common re-exports them for app-facing imports, and the trigger\n// runtime wraps them only to default `env` to process.env.\n//\n// Region → resource keys are derived from the region name\n// (`DATABASE_URL_VRTRUST_<REGION>`, `API_BASE_URL_<REGION>`), so adding a\n// region means extending this array plus its env values and migrations — not\n// editing per-region branches.\nexport const tenantDataRegions = [\n  'ap',\n  'crunchy',\n  'eu',\n  'hostaway',\n  'us',\n] as const;\nexport type TenantDataRegion = (typeof tenantDataRegions)[number];\n\nexport type RegionEnvironment = Record<string, string | undefined>;\n\nexport function assertTenantDataRegion(\n  value: string | undefined\n): asserts value is TenantDataRegion {\n  if (!tenantDataRegions.includes(value as TenantDataRegion)) {\n    throw new Error(`Missing or invalid tenant data region: ${value ?? ''}`);\n  }\n}\n\nfunction databaseUrlEnvKey(dataRegion: TenantDataRegion) {\n  return `DATABASE_URL_VRTRUST_${dataRegion.toUpperCase()}`;\n}\n\nfunction apiBaseUrlEnvKey(dataRegion: TenantDataRegion) {\n  return `API_BASE_URL_${dataRegion.toUpperCase()}`;\n}\n\nexport function resolveTenantDatabaseUrl(\n  dataRegion: TenantDataRegion,\n  env: RegionEnvironment\n) {\n  const databaseUrl = env[databaseUrlEnvKey(dataRegion)];\n  if (!databaseUrl) {\n    throw new Error(`Missing database url for ${dataRegion}`);\n  }\n  return databaseUrl;\n}\n\nexport function resolveTenantApiBaseUrl(\n  dataRegion: TenantDataRegion,\n  env: RegionEnvironment\n) {\n  const key = apiBaseUrlEnvKey(dataRegion);\n  const baseUrl = env[key];\n  if (!baseUrl) {\n    throw new Error(`Missing ${key}`);\n  }\n  return baseUrl;\n}\n\nexport function resolveConfiguredTenantDataRegions(env: RegionEnvironment) {\n  const configured = tenantDataRegions.filter((region) =>\n    Boolean(env[databaseUrlEnvKey(region)])\n  );\n\n  if (!configured.length) {\n    throw new Error('No tenant data region database urls configured');\n  }\n\n  // Two regions sharing one URL means every region-fan-out job scans the\n  // same physical DB twice (e.g. a stale dashboard env var re-merged into a\n  // deploy). Regions must stay unset until they point at distinct databases.\n  const regionsByUrl = new Map<string, TenantDataRegion[]>();\n  for (const region of configured) {\n    const url = env[databaseUrlEnvKey(region)]!;\n    regionsByUrl.set(url, [...(regionsByUrl.get(url) ?? []), region]);\n  }\n  for (const aliased of regionsByUrl.values()) {\n    if (aliased.length > 1) {\n      throw new Error(\n        `Tenant data regions ${aliased.join(', ')} share the same database url; ` +\n          'each configured region must point at a distinct database'\n      );\n    }\n  }\n\n  return configured;\n}\n\ntype UseAsyncRegionalKysely = (\n  connectionString: string,\n  options?: {\n    repositoryName?: string;\n    probe?: true;\n  }\n) => Promise<Kysely>;\n\nasync function defaultUseAsyncKysely(\n  connectionString: string,\n  options?: Parameters<UseAsyncRegionalKysely>[1]\n) {\n  const { useAsyncKysely } = await import('./index');\n  return await useAsyncKysely(connectionString, options);\n}\n\nexport async function useTenantDatabaseKysely(\n  dataRegion: TenantDataRegion,\n  repositoryName: string,\n  env: RegionEnvironment,\n  options: { useAsyncKysely?: UseAsyncRegionalKysely; probe?: true } = {}\n) {\n  const open = options.useAsyncKysely ?? defaultUseAsyncKysely;\n  return await open(resolveTenantDatabaseUrl(dataRegion, env), {\n    repositoryName,\n    probe: options.probe,\n  });\n}\n\nexport type RegionRunError = {\n  dataRegion: TenantDataRegion;\n  error: string;\n};\n\n/**\n * Run a job once per configured tenant data region with per-region error\n * isolation: one region's outage must not stall the others (regions iterate\n * in a fixed order, so a failing first region would otherwise starve the\n * rest on every attempt). Throws only when every configured region failed.\n */\nexport async function forEachConfiguredRegion<T>(\n  run: (dataRegion: TenantDataRegion) => Promise<T>,\n  env: RegionEnvironment\n): Promise<{\n  results: { dataRegion: TenantDataRegion; result: T }[];\n  errors: RegionRunError[];\n}> {\n  const results: { dataRegion: TenantDataRegion; result: T }[] = [];\n  const errors: RegionRunError[] = [];\n\n  for (const dataRegion of resolveConfiguredTenantDataRegions(env)) {\n    try {\n      results.push({ dataRegion, result: await run(dataRegion) });\n    } catch (error) {\n      errors.push({\n        dataRegion,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  if (!results.length && errors.length) {\n    throw new Error(\n      `All configured tenant data regions failed: ${errors\n        .map((regionError) => `${regionError.dataRegion}: ${regionError.error}`)\n        .join('; ')}`\n    );\n  }\n\n  return { results, errors };\n}\n"]}
+{"version":3,"file":"regional.js","sourceRoot":"src/","sources":["regional.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Kysely } from './index';\n\n// The tenant-data-region contract lives here — the region set plus how a\n// region resolves to its database url, API base url, and how to fan a job out\n// across regions. Every runtime resolves regions through these functions;\n// @vrplatform/common re-exports them for app-facing imports, and the trigger\n// runtime wraps them only to default `env` to process.env.\n//\n// Region → resource keys are derived from the region name\n// (`DATABASE_URL_VRTRUST_<REGION>`, `API_BASE_URL_<REGION>`), so adding a\n// region means extending this array plus its env values and migrations — not\n// editing per-region branches.\nexport const tenantDataRegions = [\n  'ap',\n  'crunchy',\n  'eu',\n  'hostaway',\n  'us',\n] as const;\nexport type TenantDataRegion = (typeof tenantDataRegions)[number];\n\nexport type RegionEnvironment = Record<string, string | undefined>;\n\nexport function assertTenantDataRegion(\n  value: string | undefined\n): asserts value is TenantDataRegion {\n  if (!tenantDataRegions.includes(value as TenantDataRegion)) {\n    throw new Error(`Missing or invalid tenant data region: ${value ?? ''}`);\n  }\n}\n\nfunction databaseUrlEnvKey(dataRegion: TenantDataRegion) {\n  return `DATABASE_URL_VRTRUST_${dataRegion.toUpperCase()}`;\n}\n\nfunction apiBaseUrlEnvKey(dataRegion: TenantDataRegion) {\n  return `API_BASE_URL_${dataRegion.toUpperCase()}`;\n}\n\nexport function resolveTenantDatabaseUrl(\n  dataRegion: TenantDataRegion,\n  env: RegionEnvironment\n) {\n  const databaseUrl = env[databaseUrlEnvKey(dataRegion)];\n  if (!databaseUrl) {\n    throw new Error(`Missing database url for ${dataRegion}`);\n  }\n  return databaseUrl;\n}\n\nexport function resolveTenantApiBaseUrl(\n  dataRegion: TenantDataRegion,\n  env: RegionEnvironment\n) {\n  const key = apiBaseUrlEnvKey(dataRegion);\n  const baseUrl = env[key];\n  if (!baseUrl) {\n    throw new Error(`Missing ${key}`);\n  }\n  return baseUrl;\n}\n\nexport function resolveConfiguredTenantDataRegions(env: RegionEnvironment) {\n  const configured = tenantDataRegions.filter((region) =>\n    Boolean(env[databaseUrlEnvKey(region)])\n  );\n\n  if (!configured.length) {\n    throw new Error('No tenant data region database urls configured');\n  }\n\n  // Two regions sharing one URL means every region-fan-out job scans the\n  // same physical DB twice (e.g. a stale dashboard env var re-merged into a\n  // deploy). Regions must stay unset until they point at distinct databases.\n  const regionsByUrl = new Map<string, TenantDataRegion[]>();\n  for (const region of configured) {\n    const url = env[databaseUrlEnvKey(region)]!;\n    regionsByUrl.set(url, [...(regionsByUrl.get(url) ?? []), region]);\n  }\n  for (const aliased of regionsByUrl.values()) {\n    if (aliased.length > 1) {\n      throw new Error(\n        `Tenant data regions ${aliased.join(', ')} share the same database url; ` +\n          'each configured region must point at a distinct database'\n      );\n    }\n  }\n\n  return configured;\n}\n\ntype UseAsyncRegionalKysely = (\n  connectionString: string,\n  options?: {\n    repositoryName?: string;\n    probe?: true;\n  }\n) => Promise<Kysely>;\n\nasync function defaultUseAsyncKysely(\n  connectionString: string,\n  options?: Parameters<UseAsyncRegionalKysely>[1]\n) {\n  const { useAsyncKysely } = await import('./index');\n  return await useAsyncKysely(connectionString, options);\n}\n\nexport async function useTenantDatabaseKysely(\n  dataRegion: TenantDataRegion,\n  repositoryName: string,\n  env: RegionEnvironment,\n  options: { useAsyncKysely?: UseAsyncRegionalKysely; probe?: true } = {}\n) {\n  const open = options.useAsyncKysely ?? defaultUseAsyncKysely;\n  return await open(resolveTenantDatabaseUrl(dataRegion, env), {\n    repositoryName,\n    probe: options.probe,\n  });\n}\n\nexport type TenantKysely = {\n  id: string;\n  slug: string;\n  dataRegion: TenantDataRegion;\n  kysely: Kysely;\n};\n\n/**\n * Resolve a tenant's regional Kysely connection from a connection id, slug,\n * or tenant id. The control-plane connection is opened and destroyed\n * internally; the returned regional connection must be destroyed by the\n * caller.\n */\nexport async function resolveTenantKysely({\n  connectionId,\n  slug,\n  tenantId,\n  repositoryName,\n  env,\n  ...options\n}: {\n  connectionId?: string;\n  slug?: string;\n  tenantId?: string;\n  repositoryName: string;\n  env: RegionEnvironment;\n  useAsyncKysely?: UseAsyncRegionalKysely;\n  probe?: true;\n}): Promise<TenantKysely> {\n  if (!connectionId && !slug && !tenantId) {\n    throw new Error('connectionId, slug, or tenantId is required');\n  }\n\n  const controlPlaneDatabaseUrl = env.CONTROL_PLANE_DATABASE_URL;\n  if (!controlPlaneDatabaseUrl)\n    throw new Error('CONTROL_PLANE_DATABASE_URL is required');\n\n  const controlPlane = await (options.useAsyncKysely ?? defaultUseAsyncKysely)(\n    controlPlaneDatabaseUrl,\n    {\n      repositoryName: `${repositoryName}/control-plane`,\n      probe: options.probe,\n    }\n  );\n  let tenant: { id: string; slug: string; dataRegion: string } | undefined;\n  try {\n    const query = controlPlane\n      .selectFrom('public.tenant')\n      .select([\n        'public.tenant.id as id',\n        'public.tenant.slug as slug',\n        'public.tenant.dataRegion as dataRegion',\n      ]);\n    tenant = await (\n      slug\n        ? query.where('public.tenant.slug', '=', slug)\n        : connectionId\n          ? query\n              .innerJoin(\n                'public.connectionRoute',\n                'public.connectionRoute.tenantId',\n                'public.tenant.id'\n              )\n              .where('public.connectionRoute.connectionId', '=', connectionId)\n          : query.where('public.tenant.id', '=', tenantId!)\n    ).executeTakeFirst();\n  } finally {\n    await controlPlane.destroy();\n  }\n  if (!tenant) throw new Error('Tenant not found in control plane');\n\n  assertTenantDataRegion(tenant.dataRegion);\n  return {\n    id: tenant.id,\n    slug: tenant.slug,\n    dataRegion: tenant.dataRegion,\n    kysely: await useTenantDatabaseKysely(\n      tenant.dataRegion,\n      repositoryName,\n      env,\n      options\n    ),\n  };\n}\n\nexport type RegionRunError = {\n  dataRegion: TenantDataRegion;\n  error: string;\n};\n\n/**\n * Run a job once per configured tenant data region with per-region error\n * isolation: one region's outage must not stall the others (regions iterate\n * in a fixed order, so a failing first region would otherwise starve the\n * rest on every attempt). Throws only when every configured region failed.\n */\nexport async function forEachConfiguredRegion<T>(\n  run: (dataRegion: TenantDataRegion) => Promise<T>,\n  env: RegionEnvironment\n): Promise<{\n  results: { dataRegion: TenantDataRegion; result: T }[];\n  errors: RegionRunError[];\n}> {\n  const results: { dataRegion: TenantDataRegion; result: T }[] = [];\n  const errors: RegionRunError[] = [];\n\n  for (const dataRegion of resolveConfiguredTenantDataRegions(env)) {\n    try {\n      results.push({ dataRegion, result: await run(dataRegion) });\n    } catch (error) {\n      errors.push({\n        dataRegion,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  if (!results.length && errors.length) {\n    throw new Error(\n      `All configured tenant data regions failed: ${errors\n        .map((regionError) => `${regionError.dataRegion}: ${regionError.error}`)\n        .join('; ')}`\n    );\n  }\n\n  return { results, errors };\n}\n"]}

package/build/main/v1.generated.d.ts

@@ -332,6 +332,12 @@ export interface AccountingOwnerStatementProjection {
     tenantId: string;
     variant: string;
 }
+export interface AccountingOwnerStatementProjectionListingRevision {
+    listingId: string;
+    revision: Generated<Int8>;
+    tenantId: string;
+    updatedAt: Generated<Timestamp>;
+}
 export interface AccountingOwnerStatementProjectionRevision {
     revision: Generated<Int8>;
     tenantId: string;
@@ -956,6 +962,35 @@ export interface PublicConnection {
     version: number | null;
     webhookVersion: Generated<Int8>;
 }
+export interface PublicConnectionRoute {
+    connectionId: string;
+    createdAt: Generated<Timestamp>;
+    tenantId: string;
+    updatedAt: Generated<Timestamp>;
+}
+export interface PublicControlPlaneOutbox {
+    aggregateId: string;
+    aggregateType: string;
+    attempts: Generated<number>;
+    createdAt: Generated<Timestamp>;
+    dataRegion: string | null;
+    eventType: string;
+    eventVersion: number;
+    id: Generated<string>;
+    lastError: string | null;
+    payload: Generated<Json>;
+    publishedAt: Timestamp | null;
+}
+export interface PublicControlPlaneProjectionEvent {
+    aggregateId: string;
+    aggregateType: string;
+    appliedAt: Generated<Timestamp>;
+    dataRegion: string;
+    eventId: string;
+    eventType: string;
+    eventVersion: number;
+    payload: Generated<Json>;
+}
 export interface PublicPlaidConnectSession {
     connectionId: string | null;
     createdAt: Generated<Timestamp>;
@@ -1702,6 +1737,7 @@ export interface PublicTenant {
     svixEndpoints: boolean | null;
     trialUntil: Timestamp | null;
     type: Generated<string | null>;
+    uniqueRef: string | null;
     updatedAt: Generated<Timestamp | null>;
     website: string | null;
 }
@@ -2016,6 +2052,7 @@ export interface DB {
     "accounting.journalEntryTriggerType": AccountingJournalEntryTriggerType;
     "accounting.journalEntryType": AccountingJournalEntryType;
     "accounting.ownerStatementProjection": AccountingOwnerStatementProjection;
+    "accounting.ownerStatementProjectionListingRevision": AccountingOwnerStatementProjectionListingRevision;
     "accounting.ownerStatementProjectionRevision": AccountingOwnerStatementProjectionRevision;
     "accounting.paidStatus": AccountingPaidStatus;
     "accounting.party": AccountingParty;
@@ -2072,6 +2109,9 @@ export interface DB {
     "public.bookingChannel": PublicBookingChannel;
     "public.bookingChannelIconCandidate": PublicBookingChannelIconCandidate;
     "public.connection": PublicConnection;
+    "public.connectionRoute": PublicConnectionRoute;
+    "public.controlPlaneOutbox": PublicControlPlaneOutbox;
+    "public.controlPlaneProjectionEvent": PublicControlPlaneProjectionEvent;
     "public.plaidConnectSession": PublicPlaidConnectSession;
     "public.currency": PublicCurrency;
     "public.duplicateEmails": PublicDuplicateEmails;