permdock 0.9.0 → 0.11.0

package/dist/server/index.d.ts

@@ -9,5 +9,5 @@ import { l as ReplayStore } from "../types-DsHGPtkR.js";
 import { a as WebhookInput, c as WebhookMessage, d as WebhookSigningKey, f as WebhookVerifier, h as webhookVerifier, i as WebhookHeaders, l as WebhookSigner, m as webhookSigner, n as WebhookAlgorithm, o as WebhookJwk, p as WebhookVerifierOptions, r as WebhookFailureCause, s as WebhookJwks, t as VerifiedWebhookMessage, u as WebhookSignerOptions } from "../standard-webhooks-DOYEuOLx.js";
 import { t as memoryReplayStore } from "../replay-Bs9Df2fQ.js";
 import { a as snapshotHeaders, i as cacheLifeFor, n as SnapshotHeaders, o as snapshotTag, r as SnapshotHeadersOptions, t as CacheLifeForOptions } from "../snapshot-cache-BjAWkchD.js";
-import { a as RunContext, c as RunTicket, d as RunTicketInput, f as RunTicketOptions, g as subjectFromRunTicket, h as signRunTicket, i as RunBinding, l as RunTicketAutomations, m as parseRunTicket, n as RunActClaim, o as RunKind, p as RunTicketSubjectOptions, r as RunAutomation, s as RunPrincipal, t as RUN_TICKET_CLAIMS, u as RunTicketFailureCause } from "../run-ticket-B2o2Kxz8.js";
-export { type ApiKeyFailureCause, type ApiKeyParts, type ApiKeySubjectOptions, type ApprovalHint, type CacheLifeForOptions, type Connection, type ConnectionData, type ConnectionOptions, type DeniedResponse, type DeniedResponseEvent, type DiscoverViaSignatureAgentOptions, type Guard, InvalidSignatureError, type MemoryCredentialStore, type OpenApiHooks, type OperationScopes, PROBLEM_BASE, PermDockApprovalRequiredError, PermDockDeniedError, PermDockRevokedError, PermDockValidationError, type ProblemFromErrorOptions, type ProtectOptions, RUN_TICKET_CLAIMS, type ReplayStore, type RequestContext, type RevocationEvent, type RevocationFeed, type RunActClaim, type RunAutomation, type RunBinding, type RunContext, type RunKind, type RunPrincipal, type RunTicket, type RunTicketAutomations, type RunTicketFailureCause, type RunTicketInput, type RunTicketOptions, type RunTicketSubjectOptions, type ScopeGuard, type ServerPermDock, type ServerPermDockOptions, type SnapshotHeaders, type SnapshotHeadersOptions, type SnapshotQuery, type StoredCredential, type SupportSessionContext, type SupportSessionFailureCause, type SupportSessionSource, type SupportSessionSubjectOptions, type TenantOption, type TenantScope, type VerifiedWebhookMessage, type WebBotAuthJwk, type WebBotAuthKeyLookup, type WebBotAuthKeys, type WebBotAuthOptions, type WebBotAuthVerifier, type WebhookAlgorithm, type WebhookFailureCause, type WebhookHeaders, type WebhookInput, type WebhookJwk, type WebhookJwks, type WebhookMessage, type WebhookSigner, type WebhookSignerOptions, type WebhookSigningKey, type WebhookVerifier, type WebhookVerifierOptions, apiKeyVerifier, cacheLifeFor, createPermDock, discoverViaSignatureAgent, evaluationsHandler, generateApiKey, generateFeedKey, hashApiKey, invalidSignatureProblem, invalidSignatureResponse, memoryCredentialStore, memoryReplayStore, memoryRevocationFeed, parseApiKey, parseFeedKey, parseRunTicket, problemFromDecision, problemFromError, problemResponse, signRunTicket, signSupportSession, snapshotHeaders, snapshotTag, subjectFromApiKey, subjectFromRunTicket, subjectFromSupportSession, tenantScope, validationProblem, webBotAuthVerifier, webhookSigner, webhookVerifier, wwwAuthenticate };
+import { _ as subjectFromRunTicket, a as RunContext, c as RunResource, d as RunTicketFailureCause, f as RunTicketInput, g as signRunTicket, h as parseRunTicket, i as RunBinding, l as RunTicket, m as RunTicketSubjectOptions, n as RunActClaim, o as RunKind, p as RunTicketOptions, r as RunAutomation, s as RunPrincipal, t as RUN_TICKET_CLAIMS, u as RunTicketAutomations } from "../run-ticket-ylovhyFQ.js";
+export { type ApiKeyFailureCause, type ApiKeyParts, type ApiKeySubjectOptions, type ApprovalHint, type CacheLifeForOptions, type Connection, type ConnectionData, type ConnectionOptions, type DeniedResponse, type DeniedResponseEvent, type DiscoverViaSignatureAgentOptions, type Guard, InvalidSignatureError, type MemoryCredentialStore, type OpenApiHooks, type OperationScopes, PROBLEM_BASE, PermDockApprovalRequiredError, PermDockDeniedError, PermDockRevokedError, PermDockValidationError, type ProblemFromErrorOptions, type ProtectOptions, RUN_TICKET_CLAIMS, type ReplayStore, type RequestContext, type RevocationEvent, type RevocationFeed, type RunActClaim, type RunAutomation, type RunBinding, type RunContext, type RunKind, type RunPrincipal, type RunResource, type RunTicket, type RunTicketAutomations, type RunTicketFailureCause, type RunTicketInput, type RunTicketOptions, type RunTicketSubjectOptions, type ScopeGuard, type ServerPermDock, type ServerPermDockOptions, type SnapshotHeaders, type SnapshotHeadersOptions, type SnapshotQuery, type StoredCredential, type SupportSessionContext, type SupportSessionFailureCause, type SupportSessionSource, type SupportSessionSubjectOptions, type TenantOption, type TenantScope, type VerifiedWebhookMessage, type WebBotAuthJwk, type WebBotAuthKeyLookup, type WebBotAuthKeys, type WebBotAuthOptions, type WebBotAuthVerifier, type WebhookAlgorithm, type WebhookFailureCause, type WebhookHeaders, type WebhookInput, type WebhookJwk, type WebhookJwks, type WebhookMessage, type WebhookSigner, type WebhookSignerOptions, type WebhookSigningKey, type WebhookVerifier, type WebhookVerifierOptions, apiKeyVerifier, cacheLifeFor, createPermDock, discoverViaSignatureAgent, evaluationsHandler, generateApiKey, generateFeedKey, hashApiKey, invalidSignatureProblem, invalidSignatureResponse, memoryCredentialStore, memoryReplayStore, memoryRevocationFeed, parseApiKey, parseFeedKey, parseRunTicket, problemFromDecision, problemFromError, problemResponse, signRunTicket, signSupportSession, snapshotHeaders, snapshotTag, subjectFromApiKey, subjectFromRunTicket, subjectFromSupportSession, tenantScope, validationProblem, webBotAuthVerifier, webhookSigner, webhookVerifier, wwwAuthenticate };

package/dist/server/index.js

@@ -8,7 +8,7 @@ import { d as invalidSignatureProblem, f as invalidSignatureResponse, l as Inval
 import { n as tenantScope } from "../adapter-context-CIQpQxbE.js";
 import { t as createPermDock } from "../create-BLPKnJKa.js";
 import { a as generateFeedKey, c as parseApiKey, i as generateApiKey, l as parseFeedKey, n as subjectFromSupportSession, o as hashApiKey, r as apiKeyVerifier, s as memoryCredentialStore, t as signSupportSession, u as subjectFromApiKey } from "../server-3cVlTLde.js";
-import { i as subjectFromRunTicket, n as parseRunTicket, r as signRunTicket, t as RUN_TICKET_CLAIMS } from "../run-ticket-Dv7aF7Dk.js";
+import { i as subjectFromRunTicket, n as parseRunTicket, r as signRunTicket, t as RUN_TICKET_CLAIMS } from "../run-ticket-DfnZCh-u.js";
 import { t as problemFromError } from "../map-error-pasIGqMT.js";
 import { n as webhookVerifier, t as webhookSigner } from "../standard-webhooks-D67a3nzk.js";
 export { InvalidSignatureError, PROBLEM_BASE, PermDockApprovalRequiredError, PermDockDeniedError, PermDockRevokedError, PermDockValidationError, RUN_TICKET_CLAIMS, apiKeyVerifier, cacheLifeFor, createPermDock, discoverViaSignatureAgent, evaluationsHandler, generateApiKey, generateFeedKey, hashApiKey, invalidSignatureProblem, invalidSignatureResponse, memoryCredentialStore, memoryReplayStore, memoryRevocationFeed, parseApiKey, parseFeedKey, parseRunTicket, problemFromDecision, problemFromError, problemResponse, signRunTicket, signSupportSession, snapshotHeaders, snapshotTag, subjectFromApiKey, subjectFromRunTicket, subjectFromSupportSession, tenantScope, validationProblem, webBotAuthVerifier, webhookSigner, webhookVerifier, wwwAuthenticate };

package/dist/{shared-Afctg7B0.js → shared-DrGLwM3s.js}

@@ -4,7 +4,7 @@ import { t as byCodePoint } from "./compare-DTfyUunF.js";
 import { i as configError } from "./errors-Vpu6rKHl.js";
 import { a as quoteQualifiedTable, c as quoteSqlTable, o as quoteSqlIdent, s as quoteSqlLiteral, t as SQL_IDENT } from "./sql-0WjxIp9g.js";
 import { t as byScope } from "./compile-EzEMB-7v.js";
-import "./sources-CMAM-2A3.js";
+import "./sources-C4vkzZJV.js";
 //#region src/cli/sql/columns.ts
 /**
 * The Postgres type a JSON Schema property compares as; `undefined` for text or

package/dist/{skills-C9uKfSF5.js → skills-BZc81VLt.js}

@@ -1,7 +1,7 @@
 import { t as defineLeaf } from "./command-L8EstFNm.js";
 import { t as checkFlag } from "./flags-DXjoTVbS.js";
 import { r as pick, t as CANCELLED } from "./prompt-BYc6drYW.js";
-import { n as detectedAgents, r as runSkills, t as SKILL_AGENTS } from "./skills-CQQcuGBi.js";
+import { n as detectedAgents, r as runSkills, t as SKILL_AGENTS } from "./skills-Bar7ZqwM.js";
 //#region src/cli/commands/skills.ts
 const forFlag = { for: {
 	type: "string",

package/dist/{skills-CQQcuGBi.js → skills-Bar7ZqwM.js}

@@ -2,7 +2,7 @@ import { t as byCodePoint } from "./compare-DTfyUunF.js";
 import { i as readJsonFile } from "./files-BSjrtIHw.js";
 import { l as packageRoot } from "./version-DMQ0dnN5.js";
 import { t as didYouMean } from "./args-0FrVs5EH.js";
-import { a as nonEmptyOr } from "./output-DV5dwOTs.js";
+import { a as nonEmptyOr } from "./output-CtyBwTNB.js";
 import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { pathToFileURL } from "node:url";

package/dist/{sources-CMAM-2A3.js → sources-C4vkzZJV.js}

@@ -228,7 +228,7 @@ function singleRole(role, table, alias, options) {
 	}
 	const pairs = Object.entries(role.on);
 	const [pair] = pairs;
-	if (pair === void 0 || pairs.length !== 1) throw new TypeError(`${prefix}: ${options.label}.on must map exactly one column of ${table} to ${role.through}, for example ${options.example ?? "{ role_id: 'id' }"}`);
+	if (pair === void 0 || pairs.length !== 1 && options.composite !== true) throw new TypeError(options.composite === true ? `${prefix}: ${options.label}.on must map at least one column of ${table} to ${role.through}, for example ${options.example ?? "{ role_id: 'id' }"}` : `${prefix}: ${options.label}.on must map exactly one column of ${table} to ${role.through}, for example ${options.example ?? "{ role_id: 'id' }"}`);
 	const [ref, id] = pair;
 	const schema = table.includes(".") ? table.split(".")[0] ?? "public" : "public";
 	const through = role.through.includes(".") ? role.through : `${schema}.${role.through}`;
@@ -238,18 +238,20 @@ function singleRole(role, table, alias, options) {
 		table: through,
 		id,
 		key: role.column,
-		ref
+		ref,
+		match: pairs
 	};
+	const on = pairs.map(([from, to]) => `${keys}.${q(to)} = ${alias}.${q(from)}`).join(" and ");
 	const plain = `${keys}.${q(role.column)}::text`;
 	const guard = options.guard;
 	const key = guard !== void 0 && qualifySqlTable(guard.table) === through ? `case when ${keys}.${q(guard.tenant)} is not null${guard.skip === void 0 ? "" : ` and not coalesce(${keys}.${q(guard.skip)}, false)`} and ${plain} = any(${sqlTextArray(guard.declared)}) then null else ${plain} end` : plain;
 	return {
 		column: ref,
 		sql: key,
-		join: `${options.indent === void 0 ? " " : `\n${options.indent}`}join ${target} ${keys} on ${keys}.${q(id)} = ${alias}.${q(ref)}`,
-		lookup: `(select ${key} from ${target} ${keys} where ${keys}.${q(id)} = ${alias}.${q(ref)})`,
+		join: `${options.indent === void 0 ? " " : `\n${options.indent}`}join ${target} ${keys} on ${on}`,
+		lookup: `(select ${key} from ${target} ${keys} where ${on})`,
 		through: keyed,
-		columns: [ref],
+		columns: pairs.map(([from]) => from),
 		throughs: [keyed],
 		lateral: false,
 		nullable: false
@@ -264,12 +266,14 @@ function sourceManifest(column, through, map) {
 		column,
 		map
 	};
-	return through === void 0 ? { column } : {
+	if (through === void 0) return { column };
+	return {
 		column,
 		through: {
 			table: through.table,
 			id: through.id,
-			column: through.key
+			column: through.key,
+			...through.match.length > 1 ? { on: Object.fromEntries(through.match) } : {}
 		}
 	};
 }
@@ -300,6 +304,7 @@ function memberRole(role, table, label, guard) {
 	return roleColumn(role, qualifySqlTable(table), "m", {
 		label,
 		indent: "",
+		composite: true,
 		...guard === void 0 ? {} : { guard }
 	});
 }

package/dist/{types-BMVDHvI0.d.ts → sources-oB1Hg1Fm.d.ts}

@@ -1,6 +1,8 @@
-import { pr as Principal, rn as AuthEvent } from "./policy-types-DGIO_gxq.js";
+import { nt as MembershipSource, pr as Principal, rn as AuthEvent } from "./policy-types-DGIO_gxq.js";
 import { t as ClaimsMap } from "./claims-map-D1Pb5oRq.js";
 import { t as ClientNames } from "./clients-C_NOET3z.js";
+import { c as SupabaseManifestMembership } from "./manifest-B5yF3CIq.js";
+import { t as SqlQuery } from "./sql-B80DFdpG.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/supabase/claims.d.ts
 /**
@@ -404,4 +406,316 @@ type SupabaseDelegation = {
   readonly scopes: readonly string[];
 };
 //#endregion
-export { SupabaseClaims as C, SupabasePermDockClaims as D, SupabaseMembershipClaim as E, supabaseClaims as O, SupabaseActClaim as S, SupabaseClaimsSchema as T, SupabaseStorage as _, SupabaseActor as a, SupabaseSuspendedScope as b, SupabaseInclude as c, SupabasePrincipal as d, SupabaseRealtime as f, SupabaseSessionLike as g, SupabaseRlsOptions as h, SupabaseActiveRow as i, SupabaseMembershipTable as l, SupabaseRlsMembershipTable as m, RoleMap as n, SupabaseActorResult as o, SupabaseRlsConfig as p, RoleThrough as r, SupabaseDelegation as s, AuthorizeSqlOptions as t, SupabasePermissionRef as u, SupabaseSubjectOptions as v, SupabaseClaimsOptions as w, SupabaseSuspension as x, SupabaseSuspendedMembership as y };
+//#region src/supabase/roles.d.ts
+/** A roles table a role column references, by `schema.table`. */
+type RoleKeys = {
+  readonly table: string;
+  /** The roles table column the reference points at. */
+  readonly id: string;
+  /** The roles table column holding the role key. */
+  readonly key: string;
+  /** The referencing table's column. */
+  readonly ref: string;
+  /**
+   * Every referencing column and the column of `table` it matches, `ref` and
+   * `id` first; more than one pair for a composite reference.
+   */
+  readonly match: readonly (readonly [ref: string, id: string])[];
+};
+/**
+ * One role source of a membership row: a key column, or a reference to a roles
+ * table.
+ */
+type RoleSource = string | RoleThrough | RoleMap;
+/** A role source, or several the row holds at once. */
+type RoleSpec = RoleSource | readonly RoleSource[];
+/**
+ * A roles table whose tenant rows are written by tenants. A role key read
+ * through it from a tenant row that is one of `declared` reads as null, so a
+ * tenant cannot claim the grants of a declared role by naming a role after it.
+ */
+type RoleGuard = {
+  /** `schema.table`, or `public`. */
+  readonly table: string;
+  /** The tenant column of the roles table. */
+  readonly tenant: string;
+  /**
+   * A tenant row with this column true is the application's own copy of a
+   * declared role.
+   */
+  readonly skip?: string | undefined;
+  readonly declared: readonly string[];
+};
+//#endregion
+//#region src/supabase/sources.d.ts
+type Common = {
+  readonly table: string;
+  /**
+   * Runs the lookups; without it the source only describes SQL (for `permdock
+   * supabase hook generate`).
+   */
+  readonly query?: SqlQuery;
+  /**
+   * Drop suspended users and memberships under suspended instances, like
+   * `rls.suspension`.
+   */
+  readonly suspension?: SupabaseSuspension;
+};
+type MembershipTableOptions = Common & {
+  /**
+   * Column names; `user`, `scope`, `id` and `role` default to `user_id`,
+   * `scope`, `scope_id`, `role`.
+   */
+  readonly columns?: {
+    /** The user id column, or a reference to a table that holds the user id. */
+    readonly user?: string | RoleThrough;
+    readonly scope?: string;
+    readonly id?: string;
+    /** A `jsonb` column of ancestor ids keyed by scope name. */
+    readonly within?: string;
+    /**
+     * The role key column, a reference to a roles table that holds the key, or
+     * several of them: the row holds every non-null key.
+     */
+    readonly role?: RoleSpec;
+    readonly via?: string;
+    readonly expiresAt?: string;
+    readonly disabledAt?: string;
+    /** The principal id that wrote the membership (`grantedBy`). */
+    readonly grantedBy?: string;
+    /** Free-text justification recorded on the membership (`reason`). */
+    readonly reason?: string;
+    /** A subgroup column filling `member.group`. */
+    readonly group?: string;
+    /**
+     * A text column; the value `idp` marks the row as owned by the identity
+     * provider.
+     */
+    readonly managedBy?: string;
+    /** A `text[]` column of seats. */
+    readonly seats?: string;
+    /** A `jsonb` column of app data (`Membership.x`); never written into claims. */
+    readonly x?: string;
+  };
+};
+type MembershipJunctionOptions = Common & {
+  /** The declared scope every row is a membership of. */
+  readonly scope: string;
+  /**
+   * The user id column (default `user_id`), or a reference to a table that
+   * holds the user id.
+   */
+  readonly user?: string | RoleThrough;
+  /** The column holding the scope instance id. Default `<scope>_id`. */
+  readonly id?: string;
+  /** Ancestor id columns keyed by scope name. */
+  readonly within?: Readonly<Record<string, string>>;
+  /**
+   * A role column, a reference to a roles table that holds the key, fixed roles
+   * every row holds (a contact table with no role column), or `{ sources }`:
+   * several role columns whose non-null keys the row holds.
+   */
+  readonly roles: string | RoleThrough | RoleMap | readonly string[] | {
+    readonly sources: readonly RoleSource[];
+  };
+  /** The membership kind every row has (`contact`, `staff`, `partner`). */
+  readonly via?: string;
+  readonly expiresAt?: string;
+  readonly disabledAt?: string;
+  /** The principal id that wrote the membership (`grantedBy`). */
+  readonly grantedBy?: string;
+  /** Free-text justification recorded on the membership (`reason`). */
+  readonly reason?: string;
+  /** A subgroup filling `member.group`: a fixed name every row has, or a column. */
+  readonly group?: string | {
+    readonly column: string;
+  };
+  /**
+   * `idp` when the identity provider owns every row, or a text column holding
+   * `idp` per row.
+   */
+  readonly managedBy?: "idp" | {
+    readonly column: string;
+  };
+  /** A `text[]` column of seats. */
+  readonly seats?: string;
+  /** A `jsonb` column of app data (`Membership.x`); never written into claims. */
+  readonly x?: string;
+};
+/**
+ * What `permdock supabase hook generate` compiles; the same SQL the source
+ * runs.
+ */
+type MembershipSql = {
+  readonly table: string;
+  /**
+   * The table's user column: the user id, or with `userThrough` the reference
+   * to the row holding it.
+   */
+  readonly user: string;
+  /**
+   * The table that holds the user id when `user` references it; a change of
+   * that id bumps the old and the new user.
+   */
+  readonly userThrough?: RoleKeys;
+  /**
+   * `<table>.<user>%type`: the PL/pgSQL type of the user id column, for a
+   * variable `select` compares with.
+   */
+  readonly userType: string;
+  /**
+   * The `select` of claim rows for one user, with every filter applied. `user`
+   * must have the column's type (a `userType` variable, or an untyped `$1`
+   * Postgres infers): the column is compared uncast so its index applies.
+   * `keep` adds the `keep` column; it defaults to `keeps`, and a `union` with a
+   * source that keeps passes `true`.
+   */
+  select: (user: string, keep?: boolean) => string;
+  /** The `select` of member rows for one scope instance (`$1` scope, `$2` id). */
+  list: (keep?: boolean) => string;
+  /**
+   * A suspended scope on the source keeps permissions: rows of its suspended
+   * instances stay, with a `keep` column.
+   */
+  readonly keeps: boolean;
+  /**
+   * A text column holding `idp` for rows the identity provider owns; `''` when
+   * every row is owned.
+   */
+  readonly managed?: string;
+  /** Other tables the `select` reads (suspension tables). */
+  readonly reads: readonly string[];
+  /**
+   * The roles table the role column references; a key change bumps every
+   * holder's authorization version.
+   */
+  readonly through?: RoleKeys;
+  /** Every roles table the role columns reference, `through` first. */
+  readonly throughs: readonly RoleKeys[];
+  /**
+   * Every column that decides who holds which membership: user, scope, id,
+   * `within`, role, `via` and expiry.
+   */
+  readonly columns: readonly string[];
+  /**
+   * For a single-scope source: its scope and the scopes whose ids each row
+   * carries.
+   */
+  readonly scope?: string;
+  readonly holds?: readonly string[];
+  /** The source's entry in the hook manifest's `memberships`. */
+  readonly manifest: SupabaseManifestMembership;
+  /** What the ownership triggers count; absent on a source that is not a table. */
+  readonly holders?: MembershipHolders;
+  /**
+   * The rows as plain columns, for Sync Streams and `powerSyncSource`; a source
+   * without it does not sync.
+   */
+  readonly stream?: MembershipStream;
+};
+/**
+ * One membership source as columns a Sync Streams query can filter on. Tables
+ * are `schema.table`; a `through` table is qualified in the source's schema
+ * when it names none.
+ */
+type MembershipStream = {
+  readonly table: string;
+  /** The user id column, or the reference to the table that holds the user id. */
+  readonly user: string | RoleThrough;
+  /** The scope column, or the scope every row is a membership of. */
+  readonly scope: {
+    readonly column: string;
+  } | {
+    readonly value: string;
+  };
+  readonly id: string;
+  /**
+   * The role sources (the row holds every non-null key), or the fixed roles
+   * every row holds.
+   */
+  readonly roles: RoleSpec | {
+    readonly value: readonly string[];
+  };
+  /** The membership kind column, or the kind every row has. */
+  readonly via?: {
+    readonly column: string;
+  } | {
+    readonly value: string;
+  };
+  readonly expiresAt?: string;
+  readonly disabledAt?: string;
+  /**
+   * A row may hold no role key: such a row is no membership, and a reader drops
+   * it.
+   */
+  readonly nullableRoles: boolean;
+  /**
+   * The guard the source reads its roles table with: a tenant row named like a
+   * declared role is no role.
+   */
+  readonly guard?: RoleGuard;
+};
+/**
+ * The rows of a membership table, for the holder-count and transfer-only
+ * triggers `permdock rls generate` puts on it. No suspension filter: a
+ * suspended holder still holds the role.
+ */
+type MembershipHolders = {
+  /**
+   * `<table>.<id column>%type`: the type of a variable `rows` compares the id
+   * column with.
+   */
+  readonly idType: string;
+  /**
+   * The instance id of scope `scope` the PL/pgSQL record `row` holds, as text;
+   * null on a row of another scope.
+   */
+  id: (scope: string, row: string) => string;
+  /**
+   * `select id, user_id, role, via, live` over the rows of scope `scope` in
+   * `from` (default the table): one row per held role key, `live` false once
+   * expired. `id` is an expression of `idType` the id column must equal.
+   */
+  rows: (scope: string, options?: {
+    readonly id?: string;
+    readonly from?: string;
+  }) => string;
+};
+type SqlMembershipSource = MembershipSource & {
+  readonly sql: MembershipSql;
+  /**
+   * The same source with the role keys of tenant rows of `guard.table` named
+   * like a declared role read as null.
+   */
+  readonly guarded?: (guard: RoleGuard) => SqlMembershipSource;
+};
+/** The part of `@supabase/server`'s `PostgresApi` a `SqlQuery` needs. */
+type SupabasePostgres = {
+  readonly queryRaw: (text: string, params?: unknown[]) => Promise<readonly Record<string, unknown>[]>;
+};
+declare function supabasePostgresQuery(postgres: SupabasePostgres): SqlQuery;
+/**
+ * Memberships from one table holding every scope: a row per user, scope,
+ * instance and role (`user_id, scope, scope_id, role`), with optional `within`,
+ * `via`, expiry, owner and seat columns. Rows of the same instance merge into
+ * one membership.
+ */
+declare function tableMembershipSource(options: MembershipTableOptions): SqlMembershipSource;
+/**
+ * Memberships from a table of one scope (`customer_contacts`): every row is a
+ * membership of `scope`, with roles from a column or fixed (`['contact']`), a
+ * fixed `via`, and ancestor ids from `within` columns.
+ */
+declare function junctionMembershipSource(options: MembershipJunctionOptions): SqlMembershipSource;
+declare const AUTHZ_VERSION_TABLE = "permdock_authz_version";
+/**
+ * Reads the authorization version `permdock supabase hook generate` keeps in
+ * `<schema>.permdock_authz_version`: pass it to `claimsFirst(sources, { version
+ * })`.
+ */
+declare function authzVersion(options: {
+  readonly query: SqlQuery;
+  readonly schema?: string;
+}): NonNullable<MembershipSource["version"]>;
+//#endregion
+export { SupabaseSubjectOptions as A, supabaseClaims as B, SupabasePrincipal as C, SupabaseRlsOptions as D, SupabaseRlsMembershipTable as E, SupabaseClaims as F, SupabaseClaimsOptions as I, SupabaseClaimsSchema as L, SupabaseSuspendedScope as M, SupabaseSuspension as N, SupabaseSessionLike as O, SupabaseActClaim as P, SupabaseMembershipClaim as R, SupabasePermissionRef as S, SupabaseRlsConfig as T, SupabaseActor as _, MembershipStream as a, SupabaseInclude as b, SupabasePostgres as c, supabasePostgresQuery as d, tableMembershipSource as f, SupabaseActiveRow as g, RoleThrough as h, MembershipSql as i, SupabaseSuspendedMembership as j, SupabaseStorage as k, authzVersion as l, RoleMap as m, MembershipHolders as n, MembershipTableOptions as o, AuthorizeSqlOptions as p, MembershipJunctionOptions as r, SqlMembershipSource as s, AUTHZ_VERSION_TABLE as t, junctionMembershipSource as u, SupabaseActorResult as v, SupabaseRealtime as w, SupabaseMembershipTable as x, SupabaseDelegation as y, SupabasePermDockClaims as z };

package/dist/supabase/index.d.ts

@@ -1,10 +1,9 @@
 import { Wt as Instant, hr as Subject } from "../policy-types-DGIO_gxq.js";
 import { a as ApprovalDelegationSource, m as ApprovalStore, u as ApprovalRequest } from "../types-DLvhVm1r.js";
 import { a as SupabaseRpcClient, c as readSubjectRecord, i as SupabaseRpcCaller, n as PostgrestSourcesOptions, o as SupabaseRpcResult, r as SubjectRecord, s as postgrestSources, t as PostgrestSources } from "../postgrest-D5nUGm-c.js";
-import { C as SupabaseClaims, D as SupabasePermDockClaims, E as SupabaseMembershipClaim, O as supabaseClaims, S as SupabaseActClaim, T as SupabaseClaimsSchema, _ as SupabaseStorage, a as SupabaseActor, b as SupabaseSuspendedScope, c as SupabaseInclude, d as SupabasePrincipal, f as SupabaseRealtime, g as SupabaseSessionLike, h as SupabaseRlsOptions, i as SupabaseActiveRow, l as SupabaseMembershipTable, m as SupabaseRlsMembershipTable, o as SupabaseActorResult, p as SupabaseRlsConfig, r as RoleThrough, s as SupabaseDelegation, t as AuthorizeSqlOptions, u as SupabasePermissionRef, v as SupabaseSubjectOptions, w as SupabaseClaimsOptions, x as SupabaseSuspension, y as SupabaseSuspendedMembership } from "../types-BMVDHvI0.js";
+import { A as SupabaseSubjectOptions, B as supabaseClaims, C as SupabasePrincipal, D as SupabaseRlsOptions, E as SupabaseRlsMembershipTable, F as SupabaseClaims, I as SupabaseClaimsOptions, L as SupabaseClaimsSchema, M as SupabaseSuspendedScope, N as SupabaseSuspension, O as SupabaseSessionLike, P as SupabaseActClaim, R as SupabaseMembershipClaim, S as SupabasePermissionRef, T as SupabaseRlsConfig, _ as SupabaseActor, a as MembershipStream, b as SupabaseInclude, c as SupabasePostgres, d as supabasePostgresQuery, f as tableMembershipSource, g as SupabaseActiveRow, h as RoleThrough, i as MembershipSql, j as SupabaseSuspendedMembership, k as SupabaseStorage, l as authzVersion, n as MembershipHolders, o as MembershipTableOptions, p as AuthorizeSqlOptions, r as MembershipJunctionOptions, s as SqlMembershipSource, t as AUTHZ_VERSION_TABLE, u as junctionMembershipSource, v as SupabaseActorResult, w as SupabaseRealtime, x as SupabaseMembershipTable, y as SupabaseDelegation, z as SupabasePermDockClaims } from "../sources-oB1Hg1Fm.js";
+import { _ as hasTokenHook, a as SupabaseManifestActiveRow, c as SupabaseManifestMembership, d as SupabaseManifestResourceNames, f as SupabaseManifestRls, g as SupabaseManifestValue, h as SupabaseManifestThrough, i as SupabaseManifest, l as SupabaseManifestNames, m as SupabaseManifestScopeNames, n as SupabaseHookClaim, o as SupabaseManifestColumn, p as SupabaseManifestRole, r as SupabaseHookManifest, s as SupabaseManifestHelper, t as SupabaseDatabaseManifest, u as SupabaseManifestRequires, v as parseSupabaseManifest } from "../manifest-B5yF3CIq.js";
 import { t as SqlQuery } from "../sql-B80DFdpG.js";
-import { _ as hasTokenHook, a as SupabaseManifestActiveRow, c as SupabaseManifestMembership, d as SupabaseManifestResourceNames, f as SupabaseManifestRls, g as SupabaseManifestValue, h as SupabaseManifestThrough, i as SupabaseManifest, l as SupabaseManifestNames, m as SupabaseManifestScopeNames, n as SupabaseHookClaim, o as SupabaseManifestColumn, p as SupabaseManifestRole, r as SupabaseHookManifest, s as SupabaseManifestHelper, t as SupabaseDatabaseManifest, u as SupabaseManifestRequires, v as parseSupabaseManifest } from "../manifest-CzzWtnAb.js";
-import { a as MembershipStream, c as SupabasePostgres, d as supabasePostgresQuery, f as tableMembershipSource, i as MembershipSql, l as authzVersion, n as MembershipHolders, o as MembershipTableOptions, r as MembershipJunctionOptions, s as SqlMembershipSource, t as AUTHZ_VERSION_TABLE, u as junctionMembershipSource } from "../sources-CWG32C0G.js";
 import { n as supabaseTenantClaim, t as supabaseMembershipsBudget } from "../budget-hYsPz_yE.js";
 //#region src/supabase/capability.d.ts
 type ExchangeCapabilityOptions = {
@@ -41,6 +40,14 @@ type SupabaseApprovalStoreOptions = {
   readonly schema?: string;
   /** Seconds a request stays open when the caller sets no `ttl`. */
   readonly ttl?: number;
+  /**
+   * Runs on every `create`, before the call that stores the request, with the
+   * request: insert the app's own row holding `request.token`, which `open:
+   * 'attach'` then attaches the request to. A repeated ask and a retried open
+   * run it again, so it must be idempotent, such as an insert that ignores a
+   * conflict on the token. A throw fails the open before anything is stored.
+   */
+  readonly beforeOpen?: (request: ApprovalRequest) => void | Promise<void>;
   /**
    * Runs once per stored request, after the call that stored it, with the
    * stored request: notify the approvers, or cancel the requests this one

package/dist/supabase/index.js

@@ -1,6 +1,6 @@
-import { a as supabaseClaims, i as supabaseApprovalStore, n as supabaseRls, o as exchangeCapability, r as tableApprovalDelegationSource, t as authorizeSql } from "../supabase-DnMMg5Fn.js";
+import { a as supabaseClaims, i as supabaseApprovalStore, n as supabaseRls, o as exchangeCapability, r as tableApprovalDelegationSource, t as authorizeSql } from "../supabase-CC6rIri4.js";
 import { n as supabaseTenantClaim, t as supabaseMembershipsBudget } from "../budget-BELja5A9.js";
-import { c as tableMembershipSource, i as authzVersion, o as junctionMembershipSource, s as supabasePostgresQuery, t as AUTHZ_VERSION_TABLE } from "../sources-CMAM-2A3.js";
-import { a as delegationOf, c as subjectFromSupabaseSession, i as actorOf, n as postgrestSources, r as readSubjectRecord, s as subjectFromSupabase } from "../postgrest-5Dr3W64L.js";
-import { n as parseSupabaseManifest, t as hasTokenHook } from "../manifest-wg8WkkpD.js";
+import { c as tableMembershipSource, i as authzVersion, o as junctionMembershipSource, s as supabasePostgresQuery, t as AUTHZ_VERSION_TABLE } from "../sources-C4vkzZJV.js";
+import { a as delegationOf, c as subjectFromSupabaseSession, i as actorOf, n as postgrestSources, r as readSubjectRecord, s as subjectFromSupabase } from "../postgrest-DAxFltvO.js";
+import { n as parseSupabaseManifest, t as hasTokenHook } from "../manifest-BXTbHNIV.js";
 export { AUTHZ_VERSION_TABLE, actorOf, authorizeSql, authzVersion, delegationOf, exchangeCapability, hasTokenHook, junctionMembershipSource, parseSupabaseManifest, postgrestSources, readSubjectRecord, subjectFromSupabase, subjectFromSupabaseSession, supabaseApprovalStore, supabaseClaims, supabaseMembershipsBudget, supabasePostgresQuery, supabaseRls, supabaseTenantClaim, tableApprovalDelegationSource, tableMembershipSource };

package/dist/{supabase-SBs3MYUE.js → supabase-CBEK6KEo.js}

@@ -47,7 +47,7 @@ const hookGenerate = defineLeaf({
 		const budget = given(flags.budget);
 		const schema = given(flags.schema);
 		const grantsOut = given(flags["grants-out"]);
-		const { runSupabase } = await import("./supabase-hook-C0FyEACZ.js");
+		const { runSupabase } = await import("./supabase-hook-CWvEpdCh.js");
 		return runSupabase({
 			cwd: ctx.cwd,
 			config: ctx.config,
@@ -76,7 +76,7 @@ const inspect = defineLeaf({
 	},
 	async run(ctx, { flags }) {
 		const out = flags.out === "" ? true : flags.out === "-" ? void 0 : flags.out;
-		const { runSupabase } = await import("./supabase-hook-C0FyEACZ.js");
+		const { runSupabase } = await import("./supabase-hook-CWvEpdCh.js");
 		return runSupabase({
 			cwd: ctx.cwd,
 			config: ctx.config,

package/dist/{supabase-DnMMg5Fn.js → supabase-CC6rIri4.js}

@@ -7,8 +7,8 @@ import { a as parseCapability } from "./capability-BqX94r07.js";
 import { t as loadJose } from "./load-jose-DZ4dnjri.js";
 import { a as quoteQualifiedTable, c as quoteSqlTable, d as sqlTextArray, i as qualifySqlTable, o as quoteSqlIdent, s as quoteSqlLiteral } from "./sql-0WjxIp9g.js";
 import "./budget-BELja5A9.js";
-import { d as keptKeys, l as roleColumn } from "./sources-CMAM-2A3.js";
-import { t as callRpc } from "./postgrest-5Dr3W64L.js";
+import { d as keptKeys, l as roleColumn } from "./sources-C4vkzZJV.js";
+import { t as callRpc } from "./postgrest-DAxFltvO.js";
 //#region src/supabase/capability.ts
 const DEFAULT_TTL = 300;
 const MAX_TTL = 3600;
@@ -278,6 +278,7 @@ function supabaseApprovalStore(client, options = {}) {
 	return {
 		...options.ttl === void 0 ? {} : { ttl: options.ttl },
 		async create(request) {
+			await options.beforeOpen?.(request);
 			await call("permdock_approval_open", { p_request: request });
 			if (options.onOpen !== void 0) {
 				const stored = await get(request.token);

package/dist/supabase-hook-CWvEpdCh.js

@@ -0,0 +1 @@
+export { i as runSupabase } from "./supabase-hook-CyuD9Wau.js";