@saasicat/adapter-prisma 0.26.1 → 1.0.0-rc.0

package/dist/index.cjs

@@ -52,10 +52,12 @@ __export(index_exports, {
   PrismaTenantSubscriptionWriteAdapter: () => PrismaTenantSubscriptionWriteAdapter,
   PrismaTransactionRunner: () => PrismaTransactionRunner,
   ZeroPromoRevenueDeductionAggregator: () => ZeroPromoRevenueDeductionAggregator,
+  assertDelegatesExist: () => assertDelegatesExist,
   buildActorTag: () => buildActorTag,
   createPrismaPlanBindingResolver: () => createPrismaPlanBindingResolver,
   getPrismaDelegate: () => getPrismaDelegate,
   prismaPersistence: () => prismaPersistence,
+  resolveAdminResourcesSchema: () => resolveAdminResourcesSchema,
   resolvePrismaSchemaOptions: () => resolvePrismaSchemaOptions
 });
 module.exports = __toCommonJS(index_exports);
@@ -410,7 +412,7 @@ __name(createPrismaPlanBindingResolver, "createPrismaPlanBindingResolver");
 function getPrismaDelegate(client, delegateName) {
   const delegate = client?.[delegateName];
   if (!delegate || typeof delegate !== "object") {
-    throw new Error(`Prisma client has no '${delegateName}' delegate.`);
+    throw new Error(`Prisma client has no '${delegateName}' delegate. If your model is called something else, map it \u2014 \`adminResources: { delegates: { tenant: "organization" } }\` for the SuperAdmin resources, \`schema\` for the plan binding.`);
   }
   return delegate;
 }
@@ -434,6 +436,65 @@ function asPlanIdentityClient(client) {
 }
 __name(asPlanIdentityClient, "asPlanIdentityClient");
 
+// src/admin-resources-schema.ts
+var DEFAULTS = {
+  delegates: {
+    tenant: "tenant",
+    user: "user",
+    subscription: "subscription"
+  },
+  tenant: {
+    slug: "slug",
+    name: "name",
+    isActive: "isActive",
+    deletedAt: "deletedAt",
+    users: "users",
+    subscription: "subscription"
+  },
+  user: {
+    email: "email",
+    firstName: "firstName",
+    lastName: "lastName",
+    isActive: "isActive",
+    tenant: "tenant"
+  }
+};
+function resolveAdminResourcesSchema(delegates = {}, fields = {}) {
+  return {
+    delegates: {
+      ...DEFAULTS.delegates,
+      ...delegates
+    },
+    tenant: {
+      ...DEFAULTS.tenant,
+      ...fields.tenant
+    },
+    user: {
+      ...DEFAULTS.user,
+      ...fields.user
+    }
+  };
+}
+__name(resolveAdminResourcesSchema, "resolveAdminResourcesSchema");
+function assertDelegatesExist(client, schema) {
+  const available = new Set(delegateNamesOf(client));
+  const missing = Object.entries(schema.delegates).filter(([, delegateName]) => !available.has(delegateName)).map(([role, delegateName]) => `${role} \u2192 '${delegateName}'`);
+  if (missing.length === 0) return;
+  throw new Error(`PrismaAdminResourcesAdapter is mapped to delegates the Prisma client does not have: ${missing.join(", ")}. The client offers: ${[
+    ...available
+  ].sort().join(", ") || "(none)"}. Map them with \`adminResources: { delegates: { tenant: "organization" } }\`, or implement \`AdminResourcesPort\` yourself if the shape differs rather than the names.`);
+}
+__name(assertDelegatesExist, "assertDelegatesExist");
+function delegateNamesOf(client) {
+  if (!client || typeof client !== "object") return [];
+  return Object.keys(client).filter((key) => {
+    if (key.startsWith("$") || key.startsWith("_")) return false;
+    const value = client[key];
+    return typeof value === "object" && value !== null && typeof value.findMany === "function";
+  });
+}
+__name(delegateNamesOf, "delegateNamesOf");
+
 // src/prisma-admin-resources.adapter.ts
 var DEFAULT_LIST_LIMIT = 200;
 var DEFAULT_AUDIT_LIMIT = 100;
@@ -445,41 +506,45 @@ var PrismaAdminResourcesAdapter = class {
   metrics;
   listLimit;
   audit;
+  schema;
   constructor(prisma, options = {}) {
     this.prisma = prisma;
-    this.metrics = options.tenantMetrics ?? [
-      "users"
-    ];
     this.listLimit = options.listLimit ?? DEFAULT_LIST_LIMIT;
     this.audit = new PrismaAuditQueryAdapter(prisma);
+    this.schema = resolveAdminResourcesSchema(options.delegates, options.fields);
+    this.metrics = options.tenantMetrics ?? [
+      this.schema.tenant.users
+    ];
+    if (options.delegates) assertDelegatesExist(prisma, this.schema);
   }
   async listTenants(filter) {
+    const t = this.schema.tenant;
     const where = {};
     const active = parseActiveFilter(filter.status);
-    if (active !== void 0) where.isActive = active;
+    if (active !== void 0) where[t.isActive] = active;
     if (filter.search) {
       where.OR = [
         {
-          slug: {
+          [t.slug]: {
             contains: filter.search,
             mode: "insensitive"
           }
         },
         {
-          name: {
+          [t.name]: {
             contains: filter.search,
             mode: "insensitive"
           }
         }
       ];
     }
-    if (filter.plan) where.subscription = {
+    if (filter.plan) where[t.subscription] = {
       plan: filter.plan
     };
     const rows = await this.tenants().findMany({
       where,
       include: {
-        subscription: {
+        [t.subscription]: {
           select: {
             plan: true,
             status: true
@@ -496,24 +561,25 @@ var PrismaAdminResourcesAdapter = class {
     });
     return rows.map((row) => ({
       id: row.id,
-      slug: row.slug,
-      name: row.name,
-      isActive: row.isActive,
-      deletedAt: row.deletedAt?.toISOString() ?? null,
-      plan: row.subscription?.plan ?? null,
-      status: row.subscription?.status ?? null,
+      slug: this.read(row, t.slug) ?? "",
+      name: this.read(row, t.name) ?? "",
+      isActive: this.read(row, t.isActive) ?? true,
+      deletedAt: this.read(row, t.deletedAt)?.toISOString() ?? null,
+      plan: this.subscriptionOf(row)?.plan ?? null,
+      status: this.subscriptionOf(row)?.status ?? null,
       createdAt: row.createdAt.toISOString(),
       ...row._count ?? {}
     }));
   }
   async getTenantDetail(slug) {
+    const t = this.schema.tenant;
     const row = await this.tenants().findUnique({
       where: {
-        slug
+        [t.slug]: slug
       },
       include: {
-        subscription: true,
-        users: {
+        [t.subscription]: true,
+        [t.users]: {
           orderBy: {
             createdAt: "asc"
           }
@@ -526,31 +592,32 @@ var PrismaAdminResourcesAdapter = class {
     if (!row) return null;
     return {
       id: row.id,
-      slug: row.slug,
-      name: row.name,
-      isActive: row.isActive,
-      subscription: row.subscription ? {
-        plan: row.subscription.plan,
-        status: row.subscription.status,
-        billingCycle: row.subscription.billingCycle,
-        isPilot: row.subscription.isPilot,
-        trialEndsAt: row.subscription.trialEndsAt?.toISOString() ?? null,
-        pilotEndsAt: row.subscription.pilotEndsAt?.toISOString() ?? null
+      slug: this.read(row, t.slug) ?? slug,
+      name: this.read(row, t.name) ?? "",
+      isActive: this.read(row, t.isActive) ?? true,
+      subscription: this.subscriptionOf(row) ? {
+        plan: this.subscriptionOf(row).plan,
+        status: this.subscriptionOf(row).status,
+        billingCycle: this.subscriptionOf(row).billingCycle,
+        isPilot: this.subscriptionOf(row).isPilot,
+        trialEndsAt: this.subscriptionOf(row).trialEndsAt?.toISOString() ?? null,
+        pilotEndsAt: this.subscriptionOf(row).pilotEndsAt?.toISOString() ?? null
       } : null,
-      users: (row.users ?? []).map((user) => ({
+      users: (this.read(row, t.users) ?? []).map((user) => ({
         id: user.id,
-        email: user.email,
-        firstName: user.firstName ?? void 0,
-        lastName: user.lastName ?? void 0,
+        email: this.read(user, this.schema.user.email) ?? "",
+        firstName: this.read(user, this.schema.user.firstName) ?? void 0,
+        lastName: this.read(user, this.schema.user.lastName) ?? void 0,
         createdAt: user.createdAt.toISOString()
       })),
       counts: row._count ?? {}
     };
   }
   async setTenantActive(slug, active, subscriptionStatus) {
+    const t = this.schema.tenant;
     const tenant = await this.tenants().findUnique({
       where: {
-        slug
+        [t.slug]: slug
       }
     });
     if (!tenant) return null;
@@ -559,7 +626,7 @@ var PrismaAdminResourcesAdapter = class {
         id: tenant.id
       },
       data: {
-        isActive: active
+        [t.isActive]: active
       }
     });
     await this.subscriptions().updateMany({
@@ -579,20 +646,22 @@ var PrismaAdminResourcesAdapter = class {
     };
   }
   async listUsers(filter) {
+    const u = this.schema.user;
+    const tenantSlug = this.schema.tenant.slug;
     const where = {};
-    if (filter.q) where.email = {
+    if (filter.q) where[u.email] = {
       contains: filter.q,
       mode: "insensitive"
     };
-    if (filter.tenant) where.tenant = {
-      slug: filter.tenant
+    if (filter.tenant) where[u.tenant] = {
+      [tenantSlug]: filter.tenant
     };
     const rows = await this.users().findMany({
       where,
       include: {
-        tenant: {
+        [u.tenant]: {
           select: {
-            slug: true
+            [tenantSlug]: true
           }
         }
       },
@@ -603,12 +672,12 @@ var PrismaAdminResourcesAdapter = class {
     });
     return rows.map((row) => ({
       id: row.id,
-      email: row.email,
-      firstName: row.firstName ?? "",
-      lastName: row.lastName ?? "",
+      email: this.read(row, u.email) ?? "",
+      firstName: this.read(row, u.firstName) ?? "",
+      lastName: this.read(row, u.lastName) ?? "",
       role: row.platformRole ?? row.role ?? "MEMBER",
-      isActive: row.isActive ?? true,
-      tenantSlug: row.tenant?.slug ?? null,
+      isActive: this.read(row, u.isActive) ?? true,
+      tenantSlug: this.tenantSlugOf(row, u.tenant, tenantSlug),
       lastLoginAt: row.lastLoginAt?.toISOString() ?? null,
       createdAt: row.createdAt.toISOString()
     }));
@@ -623,12 +692,13 @@ var PrismaAdminResourcesAdapter = class {
     });
   }
   async listSubscriptions() {
+    const t = this.schema.tenant;
     const rows = await this.subscriptions().findMany({
       include: {
         tenant: {
           select: {
-            slug: true,
-            name: true
+            [t.slug]: true,
+            [t.name]: true
           }
         },
         planVersion: {
@@ -644,7 +714,10 @@ var PrismaAdminResourcesAdapter = class {
     });
     return rows.map((row) => ({
       id: row.id,
-      tenant: row.tenant,
+      tenant: {
+        slug: this.read(row.tenant, t.slug) ?? "",
+        name: this.read(row.tenant, t.name) ?? ""
+      },
       plan: row.plan,
       status: row.status,
       billingCycle: row.billingCycle,
@@ -653,13 +726,32 @@ var PrismaAdminResourcesAdapter = class {
     }));
   }
   tenants() {
-    return getPrismaDelegate(this.prisma, "tenant");
+    return getPrismaDelegate(this.prisma, this.schema.delegates.tenant);
   }
   users() {
-    return getPrismaDelegate(this.prisma, "user");
+    return getPrismaDelegate(this.prisma, this.schema.delegates.user);
   }
   subscriptions() {
-    return getPrismaDelegate(this.prisma, "subscription");
+    return getPrismaDelegate(this.prisma, this.schema.delegates.subscription);
+  }
+  /** The subscription relation of a tenant row, under whatever it is called. */
+  subscriptionOf(row) {
+    return this.read(row, this.schema.tenant.subscription) ?? null;
+  }
+  /** The tenant slug on a user row, through both mapped names. */
+  tenantSlugOf(row, relation, slugField) {
+    const tenant = this.read(row, relation);
+    return tenant ? this.read(tenant, slugField) ?? null : null;
+  }
+  /**
+   * Reads a mapped field off a row.
+   *
+   * The rows come back keyed by the APP's field names, so every read of a
+   * mapped field goes through here — and the row type stays the shape the
+   * adapter promises rather than becoming `Record<string, unknown>`.
+   */
+  read(row, field) {
+    return row[field];
   }
 };
 function metricSelect(metrics) {
@@ -2039,7 +2131,7 @@ PrismaMfaAdapter = _ts_decorate9([
   ])
 ], PrismaMfaAdapter);
 
-// src/prisma-plan-catalog-import-sink.ts
+// src/prisma-plan-catalog-import-sink.adapter.ts
 var import_common10 = require("@nestjs/common");
 function _ts_decorate10(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -2193,7 +2285,7 @@ PrismaPlanCatalogImportSink = _ts_decorate10([
   ])
 ], PrismaPlanCatalogImportSink);
 
-// src/prisma-plan-catalog-read-sink.ts
+// src/prisma-plan-catalog-read-sink.adapter.ts
 var import_common11 = require("@nestjs/common");
 function _ts_decorate11(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -3623,7 +3715,7 @@ PrismaPromoCodeValidationLogRepository = _ts_decorate17([
   ])
 ], PrismaPromoCodeValidationLogRepository);
 
-// src/prisma-promo-subscription-lookup.ts
+// src/prisma-promo-subscription-lookup.adapter.ts
 var import_common18 = require("@nestjs/common");
 function _ts_decorate18(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -4821,7 +4913,7 @@ function clearedPendingVersionData() {
 }
 __name(clearedPendingVersionData, "clearedPendingVersionData");
 
-// src/prisma-transaction-runner.ts
+// src/prisma-transaction-runner.adapter.ts
 var import_common25 = require("@nestjs/common");
 function _ts_decorate25(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -4862,7 +4954,7 @@ PrismaTransactionRunner = _ts_decorate25([
   ])
 ], PrismaTransactionRunner);
 
-// src/zero-promo-revenue-aggregator.ts
+// src/zero-promo-revenue-aggregator.adapter.ts
 var import_common26 = require("@nestjs/common");
 function _ts_decorate26(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -5016,9 +5108,11 @@ __name(buildProvisioning, "buildProvisioning");
   PrismaTenantSubscriptionWriteAdapter,
   PrismaTransactionRunner,
   ZeroPromoRevenueDeductionAggregator,
+  assertDelegatesExist,
   buildActorTag,
   createPrismaPlanBindingResolver,
   getPrismaDelegate,
   prismaPersistence,
+  resolveAdminResourcesSchema,
   resolvePrismaSchemaOptions
 });

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AdminResourcesPort, AdminTenantListFilter, AdminTenantListRow, AdminTenantDetail, AdminTenantStateResult, AdminUserListFilter, AdminUserListRow, AdminAuditListFilter, AuditEntry, AdminSubscriptionListRow, BundleRepository, TransactionContext, BundleVersionRow, BundleListFilter, BundleRow, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, PersistenceInjectionToken, PasswordHasher, SaasicatPersistenceAdapter, TransactionRunner, MfaPort, AuditPort, AdminActor, AuditQueryPort, AuditQuery, AuditStatsPort, RlsBypassPort, SubscriptionRepository, SubscriptionRecord, SubscriptionUsagePort, SubscriptionUsageRecord, SubscriptionBundleRepository, SubscriptionBundleRecord, CreateSubscriptionBundleData, CancelSubscriptionBundleData, TenantSubscriptionWritePort, ApplyOnboardingSelectionInput, RedeemPromoInTransactionCallback, ApplyOnboardingSelectionResult, ImmediatePlanChangeInput, ScheduledPlanChangeInput, PlanVersionRepository, PlanVersionRecord, PromoCodeRepository, PromoCodeRecord, PromoCodeFilter, CreatePromoCodeData, UpdatePromoCodeData, PromoCodeRedemptionRepository, PromoCodeRedemptionRecord, PromoCodeRedemptionStatus, PromoCodeRedemptionListItem, PromoCodeValidationLogRepository, PromoSubscriptionLookup, BillingCycle, PromoRevenueDeductionAggregator, SuperAdminProvisioningPort, CreateSuperAdminCliInput, PlatformUserDto, PlanCatalogReadSink, PlanCatalogReadSnapshot, PlanCatalogImportSink, UpsertPlanInput, UpsertResult, UpsertPlanVersionInput, UpsertFeatureCatalogEntryInput, PlanRepository, PlanListFilter, PlanRow, CreatePlanData, UpdatePlanData, PlanVersionRow, CreatePlanVersionDraftData, UpdatePlanVersionDraftData, CatalogEntryRepository, CatalogEntryFilter, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, UpsertCapabilityEntryData, UpsertFeatureEntryData, UpsertQuotaEntryData, SetCatalogEntryReviewData, CatalogEntryI18n, UpdateCatalogEntryBaseData, MarketingProjectionRepository, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, MarketingSettingsRepository, MarketingSettingsRow, UpdateMarketingSettingsData, PromotionRepository, PromotionFilter, PromotionRow, CreatePromotionData, UpdatePromotionData, SubscriptionContractRepository, SubscriptionContractFilter, SubscriptionContractRecord, CreateSubscriptionContractData, TerminateSubscriptionContractData } from '@saasicat/types';
+import { AdminResourcesPort, AdminTenantListFilter, AdminTenantListRow, AdminTenantDetail, AdminTenantStateResult, AdminUserListFilter, AdminUserListRow, AdminAuditListFilter, AuditEntry, AdminSubscriptionListRow, BundleRepository, TransactionContext, BundleVersionRow, BundleListFilter, BundleRow, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, PersistenceInjectionToken, PasswordHasher, SaaSiCatPersistenceAdapter, TransactionRunner, MfaPort, AuditPort, AdminActor, AuditQueryPort, AuditQuery, AuditStatsPort, RlsBypassPort, SubscriptionRepository, SubscriptionRecord, SubscriptionUsagePort, SubscriptionUsageRecord, SubscriptionBundleRepository, SubscriptionBundleRecord, CreateSubscriptionBundleData, CancelSubscriptionBundleData, TenantSubscriptionWritePort, ApplyOnboardingSelectionInput, RedeemPromoInTransactionCallback, ApplyOnboardingSelectionResult, ImmediatePlanChangeInput, ScheduledPlanChangeInput, PlanVersionRepository, PlanVersionRecord, PromoCodeRepository, PromoCodeRecord, PromoCodeFilter, CreatePromoCodeData, UpdatePromoCodeData, PromoCodeRedemptionRepository, PromoCodeRedemptionRecord, PromoCodeRedemptionStatus, PromoCodeRedemptionListItem, PromoCodeValidationLogRepository, PromoSubscriptionLookup, BillingCycle, PromoRevenueDeductionAggregator, SuperAdminProvisioningPort, CreateSuperAdminCliInput, PlatformUserDto, PlanCatalogReadSink, PlanCatalogReadSnapshot, PlanCatalogImportSink, UpsertPlanInput, UpsertResult, UpsertPlanVersionInput, UpsertFeatureCatalogEntryInput, PlanRepository, PlanListFilter, PlanRow, CreatePlanData, UpdatePlanData, PlanVersionRow, CreatePlanVersionDraftData, UpdatePlanVersionDraftData, CatalogEntryRepository, CatalogEntryFilter, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, UpsertCapabilityEntryData, UpsertFeatureEntryData, UpsertQuotaEntryData, SetCatalogEntryReviewData, CatalogEntryI18n, UpdateCatalogEntryBaseData, MarketingProjectionRepository, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, MarketingSettingsRepository, MarketingSettingsRow, UpdateMarketingSettingsData, PromotionRepository, PromotionFilter, PromotionRow, CreatePromotionData, UpdatePromotionData, SubscriptionContractRepository, SubscriptionContractFilter, SubscriptionContractRecord, CreateSubscriptionContractData, TerminateSubscriptionContractData } from '@saasicat/types';
 
 declare const PRISMA_CLIENT_TOKEN: unique symbol;
 /** Prisma `Decimal` values arrive as objects with `toString()`; tests may use plain values. */
@@ -703,6 +703,81 @@ declare function createPrismaPlanBindingResolver(options?: PrismaPlanBindingOpti
 /** Resolves a configurable Prisma delegate and fails early on misspellings. */
 declare function getPrismaDelegate<Row>(client: unknown, delegateName: string): PrismaModelDelegateLike<Row>;
 
+/** The Prisma delegates the adapter needs, by the name your client uses. */
+interface AdminResourcesDelegates {
+    /** Default `tenant`. */
+    tenant?: string;
+    /** Default `user`. */
+    user?: string;
+    /** Default `subscription`. */
+    subscription?: string;
+}
+/** The scalar and relation fields the adapter reads, by your name for them. */
+interface AdminResourcesFields {
+    tenant?: {
+        /** Default `slug` — the stable identifier every admin route addresses. */
+        slug?: string;
+        /** Default `name`. */
+        name?: string;
+        /** Default `isActive`. */
+        isActive?: string;
+        /** Default `deletedAt`. */
+        deletedAt?: string;
+        /** The tenant→users relation. Default `users`. */
+        users?: string;
+        /**
+         * The tenant→subscription relation. Default `subscription`.
+         *
+         * On YOUR model, so your name for it: Prisma names a relation field
+         * after what it points at, and an app whose tenant is `Organization`
+         * has usually not renamed this one — but it may have.
+         */
+        subscription?: string;
+    };
+    user?: {
+        /** Default `email`. */
+        email?: string;
+        /** Default `firstName`. */
+        firstName?: string;
+        /** Default `lastName`. */
+        lastName?: string;
+        /** Default `isActive`. */
+        isActive?: string;
+        /**
+         * The user→tenant relation. Default `tenant`.
+         *
+         * The one the documented example gets wrong by omission: an app whose
+         * tenant model is `Organization` calls this field `organization`, by
+         * the same Prisma convention that named the delegate.
+         */
+        tenant?: string;
+    };
+}
+/** The mapping with every default filled in — what the adapter actually reads. */
+interface ResolvedAdminResourcesSchema {
+    readonly delegates: Required<AdminResourcesDelegates>;
+    readonly tenant: Required<NonNullable<AdminResourcesFields['tenant']>>;
+    readonly user: Required<NonNullable<AdminResourcesFields['user']>>;
+}
+declare function resolveAdminResourcesSchema(delegates?: AdminResourcesDelegates, fields?: AdminResourcesFields): ResolvedAdminResourcesSchema;
+/**
+ * Refuses a mapping that names a delegate the client does not have.
+ *
+ * At construction, which is boot: a mapped delegate is resolved lazily, so a
+ * typo used to surface as a 500 on the tenants page long after deployment —
+ * and only if somebody opened it. The message lists what the client does have,
+ * because the answer is almost always a near miss (`organisation` for
+ * `organization`, `users` for `user`).
+ *
+ * Only for an EXPLICIT mapping. `prismaPersistence()` builds this adapter for
+ * every bundle, including for applications that never switch `adminResources`
+ * on, and several of them have no `tenant` delegate at all — asserting the
+ * defaults here would refuse to construct a bundle nobody was going to ask
+ * about. Those keep failing where they always did, at the first request, with
+ * a message that now names the way out.
+ */
+declare function assertDelegatesExist(client: unknown, schema: ResolvedAdminResourcesSchema): void;
+
 interface PrismaAdminResourcesOptions {
     /**
      * Relation counters exposed on tenant rows and tenant details. The names
@@ -710,6 +785,13 @@ interface PrismaAdminResourcesOptions {
      */
     tenantMetrics?: readonly string[];
     listLimit?: number;
+    /**
+     * Delegate names, when the app's models are not called `tenant`, `user`
+     * and `subscription`. Checked against the client at construction.
+     */
+    delegates?: AdminResourcesDelegates;
+    /** Field names, when the app's columns differ. See `AdminResourcesFields`. */
+    fields?: AdminResourcesFields;
 }
 /**
  * Convention-based adapter for the standard SuperAdmin resource pages.
@@ -724,6 +806,7 @@ declare class PrismaAdminResourcesAdapter implements AdminResourcesPort {
     private readonly metrics;
     private readonly listLimit;
     private readonly audit;
+    private readonly schema;
     constructor(prisma: PrismaLike, options?: PrismaAdminResourcesOptions);
     listTenants(filter: AdminTenantListFilter): Promise<AdminTenantListRow[]>;
     getTenantDetail(slug: string): Promise<AdminTenantDetail | null>;
@@ -734,6 +817,18 @@ declare class PrismaAdminResourcesAdapter implements AdminResourcesPort {
     private tenants;
     private users;
     private subscriptions;
+    /** The subscription relation of a tenant row, under whatever it is called. */
+    private subscriptionOf;
+    /** The tenant slug on a user row, through both mapped names. */
+    private tenantSlugOf;
+    /**
+     * Reads a mapped field off a row.
+     *
+     * The rows come back keyed by the APP's field names, so every read of a
+     * mapped field goes through here — and the row type stays the shape the
+     * adapter promises rather than becoming `Record<string, unknown>`.
+     */
+    private read;
 }
 
 /**
@@ -859,11 +954,11 @@ interface PrismaPersistenceOptions {
     bundle?: PrismaBundleRepositoryOptions;
 }
 /**
- * Builds the `SaasicatPersistenceAdapter` bundle for Prisma + PostgreSQL on
+ * Builds the `SaaSiCatPersistenceAdapter` bundle for Prisma + PostgreSQL on
  * the canonical schema (`@saasicat/spec` prisma-fragments):
  *
  * ```ts
- * SaasPlatformModule.forRoot({
+ * SaaSiCatModule.forRoot({
  *     persistence: prismaPersistence({ client: PrismaService }),
  *     // ...
  * });
@@ -873,7 +968,7 @@ interface PrismaPersistenceOptions {
  * tenant-billing, promo and plan-catalog persistence. App-specific behavior
  * such as quota counters and authentication remains in the consumer.
  */
-declare function prismaPersistence(options: PrismaPersistenceOptions): SaasicatPersistenceAdapter;
+declare function prismaPersistence(options: PrismaPersistenceOptions): SaaSiCatPersistenceAdapter;
 
 /**
  * `TransactionRunner` over `prisma.$transaction`. The interactive transaction
@@ -1461,4 +1556,4 @@ declare class PrismaSubscriptionContractRepository implements SubscriptionContra
     terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
 }
 
-export { AsyncLocalRlsBypassAdapter, type DecimalLike, PASSWORD_HASHER_TOKEN, PRISMA_BUNDLE_REPOSITORY_OPTIONS, PRISMA_CLIENT_TOKEN, PRISMA_SCHEMA_OPTIONS_TOKEN, PrismaAdminResourcesAdapter, type PrismaAdminResourcesOptions, PrismaAuditAdapter, PrismaAuditQueryAdapter, PrismaAuditStatsAdapter, PrismaBundleRepository, type PrismaBundleRepositoryOptions, PrismaCatalogEntryRepository, type PrismaLike, PrismaMarketingProjectionRepository, PrismaMarketingSettingsRepository, PrismaMfaAdapter, type PrismaModelDelegateLike, type PrismaPersistenceOptions, type PrismaPlanBindingMode, type PrismaPlanBindingOptions, type PrismaPlanBindingResolver, PrismaPlanCatalogImportSink, PrismaPlanCatalogReadSink, type PrismaPlanDelegateOptions, PrismaPlanRepository, type PrismaPlanVersionFieldCapabilities, type PrismaPlanVersionFieldOptions, PrismaPlanVersionRepository, PrismaPromoCodeRedemptionRepository, PrismaPromoCodeRepository, PrismaPromoCodeValidationLogRepository, PrismaPromoSubscriptionLookup, PrismaPromotionRepository, type PrismaSchemaOptions, PrismaSubscriptionBundleRepository, PrismaSubscriptionContractRepository, PrismaSubscriptionRepository, PrismaSubscriptionUsageAdapter, PrismaSuperAdminBootstrapAdapter, type PrismaTenantSubscriptionOptions, PrismaTenantSubscriptionWriteAdapter, PrismaTransactionRunner, type PrismaTxLike, type ResolvedPrismaSchemaOptions, ZeroPromoRevenueDeductionAggregator, buildActorTag, createPrismaPlanBindingResolver, getPrismaDelegate, prismaPersistence, resolvePrismaSchemaOptions };
+export { type AdminResourcesDelegates, type AdminResourcesFields, AsyncLocalRlsBypassAdapter, type DecimalLike, PASSWORD_HASHER_TOKEN, PRISMA_BUNDLE_REPOSITORY_OPTIONS, PRISMA_CLIENT_TOKEN, PRISMA_SCHEMA_OPTIONS_TOKEN, PrismaAdminResourcesAdapter, type PrismaAdminResourcesOptions, PrismaAuditAdapter, PrismaAuditQueryAdapter, PrismaAuditStatsAdapter, PrismaBundleRepository, type PrismaBundleRepositoryOptions, PrismaCatalogEntryRepository, type PrismaLike, PrismaMarketingProjectionRepository, PrismaMarketingSettingsRepository, PrismaMfaAdapter, type PrismaModelDelegateLike, type PrismaPersistenceOptions, type PrismaPlanBindingMode, type PrismaPlanBindingOptions, type PrismaPlanBindingResolver, PrismaPlanCatalogImportSink, PrismaPlanCatalogReadSink, type PrismaPlanDelegateOptions, PrismaPlanRepository, type PrismaPlanVersionFieldCapabilities, type PrismaPlanVersionFieldOptions, PrismaPlanVersionRepository, PrismaPromoCodeRedemptionRepository, PrismaPromoCodeRepository, PrismaPromoCodeValidationLogRepository, PrismaPromoSubscriptionLookup, PrismaPromotionRepository, type PrismaSchemaOptions, PrismaSubscriptionBundleRepository, PrismaSubscriptionContractRepository, PrismaSubscriptionRepository, PrismaSubscriptionUsageAdapter, PrismaSuperAdminBootstrapAdapter, type PrismaTenantSubscriptionOptions, PrismaTenantSubscriptionWriteAdapter, PrismaTransactionRunner, type PrismaTxLike, type ResolvedAdminResourcesSchema, type ResolvedPrismaSchemaOptions, ZeroPromoRevenueDeductionAggregator, assertDelegatesExist, buildActorTag, createPrismaPlanBindingResolver, getPrismaDelegate, prismaPersistence, resolveAdminResourcesSchema, resolvePrismaSchemaOptions };