@columnus/shared 0.1.47

package/dist/shareGuestPolicy.d.ts

@@ -0,0 +1,14 @@
+import type { GuestCapabilities, GuestCapabilityInput, GuestLinkCapabilities, GuestScopeCapabilities, ShareScope } from "./shareTypes.ts";
+export declare function resolveGuestLinkCapabilities(input: GuestCapabilityInput): GuestLinkCapabilities;
+export declare function resolveGuestScopeCapabilities(input: GuestCapabilityInput & {
+    scope: ShareScope;
+}): GuestScopeCapabilities;
+export declare function resolveGuestCapabilities(input: GuestCapabilityInput & {
+    scope?: ShareScope;
+}): GuestCapabilities;
+export declare function guestVisibleScopes(input: GuestCapabilityInput & {
+    scopes: ShareScope[];
+}): ShareScope[];
+export declare function guestSearchableScopes(input: GuestCapabilityInput & {
+    scopes: ShareScope[];
+}): ShareScope[];

package/dist/shareGuestPolicy.js

@@ -0,0 +1,90 @@
+// packages/@columnus/shared/src/shareScopes.ts
+function isReferenceOnlyScope(scope) {
+  return scope.primary === false;
+}
+function isFormSubmissionScope(scope) {
+  return scope.formAccess?.submit === true;
+}
+function canSearchFormReferences(scope) {
+  return scope.formAccess?.searchReferences === true;
+}
+function canCreateFormReferences(scope) {
+  return scope?.formAccess?.createReferences === true;
+}
+function canProposeOperation(scope, operation) {
+  if (scope?.permission !== "propose" || !scope.ops[operation]) return false;
+  return operation !== "insert" || scope.access !== "referenced" || Boolean(scope.allowCreate);
+}
+function canProposeInsert(scope) {
+  return canProposeOperation(scope, "insert");
+}
+
+// packages/@columnus/shared/src/shareGuestPolicy.ts
+function resolveGuestLinkCapabilities(input) {
+  const { type } = input.link;
+  const recipientPropose = type === "propose" && input.invite.kind === "recipient";
+  return {
+    formMode: type === "form",
+    canBrowseRows: type === "view" || recipientPropose,
+    canListProposals: recipientPropose,
+    canUpsertPatches: type === "propose",
+    canToggleViewMode: type !== "form"
+  };
+}
+function resolveGuestScopeCapabilities(input) {
+  const link = resolveGuestLinkCapabilities(input);
+  const { scope } = input;
+  const propose = {
+    canProposeInsert: canProposeInsert(scope),
+    canProposeUpdate: link.canUpsertPatches && canProposeOperation(scope, "update"),
+    canProposeDelete: link.canUpsertPatches && canProposeOperation(scope, "delete")
+  };
+  if (link.formMode) {
+    const canSearch = canSearchFormReferences(scope);
+    return {
+      visibleInNav: isFormSubmissionScope(scope),
+      canReadDisplay: canSearch,
+      canSearchReferences: canSearch,
+      canCreateReferences: canCreateFormReferences(scope),
+      ...propose
+    };
+  }
+  if (isReferenceOnlyScope(scope)) {
+    const canSearch = canSearchFormReferences(scope);
+    const canCreate = canCreateFormReferences(scope);
+    return {
+      visibleInNav: false,
+      canReadDisplay: canSearch || canCreate,
+      canSearchReferences: canSearch,
+      canCreateReferences: canCreate,
+      ...propose
+    };
+  }
+  return {
+    visibleInNav: true,
+    canReadDisplay: true,
+    canSearchReferences: true,
+    canCreateReferences: canProposeInsert(scope),
+    ...propose
+  };
+}
+function resolveGuestCapabilities(input) {
+  return {
+    link: resolveGuestLinkCapabilities(input),
+    scope: input.scope ? resolveGuestScopeCapabilities({ ...input, scope: input.scope }) : void 0
+  };
+}
+function guestVisibleScopes(input) {
+  return input.scopes.filter(
+    (scope) => resolveGuestScopeCapabilities({ ...input, scope }).visibleInNav
+  );
+}
+function guestSearchableScopes(input) {
+  return input.scopes.filter(
+    (scope) => resolveGuestScopeCapabilities({ ...input, scope }).canSearchReferences
+  );
+}
+
+export { guestSearchableScopes, guestVisibleScopes, resolveGuestCapabilities, resolveGuestLinkCapabilities, resolveGuestScopeCapabilities };
+//# sourceMappingURL=shareGuestPolicy.js.map
+//# sourceMappingURL=shareGuestPolicy.js.map

package/dist/shareGuestPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shareScopes.ts","../src/shareGuestPolicy.ts"],"names":[],"mappings":"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","file":"shareGuestPolicy.js","sourcesContent":["import { assertProposalAccess, type ProposalAccess } from \"./proposePolicy.ts\";\nimport { refFieldsForTable } from \"./refGraph.ts\";\nimport type { Manifest } from \"./schemaTypes.ts\";\nimport type {\n  ShareInviteKind,\n  ShareLinkType,\n  ShareOperation,\n  ShareScope,\n  ShareScopeConflictPatch,\n  ShareWizardReferenceInput,\n} from \"./shareTypes.ts\";\n\nfunction inferLegacyPrimary(scope: ShareScope): boolean {\n  const access = scope.formAccess;\n  return !(access && !access.submit && (access.searchReferences || access.createReferences));\n}\n\nexport function normalizeShareScopes(scopes: ShareScope[]): ShareScope[] {\n  const tables = new Set<string>();\n  return scopes.map((scope) => {\n    const table = scope.table.trim();\n    if (!table) throw new Error(\"Every share scope needs a table\");\n    if (tables.has(table)) throw new Error(`Duplicate share scope for ${table}`);\n    tables.add(table);\n\n    const recordIds = scope.recordIds\n      ? [...new Set(scope.recordIds.map((id) => id.trim()).filter(Boolean))]\n      : undefined;\n    const allowedFields = scope.allowedFields\n      ? [...new Set(scope.allowedFields.map((field) => field.trim()).filter(Boolean))]\n      : undefined;\n\n    if (scope.access === \"referenced\" && recordIds) {\n      throw new Error(`Referenced scope ${table} cannot specify recordIds`);\n    }\n    if (recordIds && scope.permission === \"propose\" && scope.ops.insert) {\n      throw new Error(`Record-picked scope ${table} cannot allow inserts`);\n    }\n    if (\n      scope.allowCreate &&\n      (scope.access !== \"referenced\" || scope.permission !== \"propose\" || !scope.ops.insert)\n    ) {\n      throw new Error(`allowCreate requires referenced propose insert access for ${table}`);\n    }\n\n    return {\n      ...scope,\n      table,\n      primary: scope.primary ?? inferLegacyPrimary(scope),\n      recordIds,\n      allowedFields,\n      ops:\n        scope.permission === \"view\"\n          ? { insert: false, update: false, delete: false }\n          : { ...scope.ops },\n    };\n  });\n}\n\nexport function isReferenceOnlyScope(scope: ShareScope): boolean {\n  return scope.primary === false;\n}\n\nexport function mergeReferenceScopes(\n  scopes: ShareScope[],\n  references: ShareWizardReferenceInput[],\n): ShareScope[] {\n  const next = normalizeShareScopes(scopes);\n  for (const reference of references) {\n    const existing = next.find((scope) => scope.table === reference.table.trim());\n    const formAccess = {\n      submit: existing?.formAccess?.submit ?? false,\n      searchReferences:\n        (existing?.formAccess?.searchReferences ?? false) || reference.searchReferences,\n      createReferences:\n        (existing?.formAccess?.createReferences ?? false) || reference.createReferences,\n    };\n    if (existing) {\n      existing.formAccess = formAccess;\n      if (formAccess.createReferences && !existing.primary) {\n        existing.permission = \"propose\";\n        existing.ops = { insert: true, update: false, delete: false };\n      }\n      continue;\n    }\n    next.push({\n      table: reference.table,\n      primary: false,\n      access: \"full\",\n      permission: formAccess.createReferences ? \"propose\" : \"view\",\n      ops: formAccess.createReferences\n        ? { insert: true, update: false, delete: false }\n        : { insert: false, update: false, delete: false },\n      formAccess,\n    });\n  }\n  return next;\n}\n\nfunction isInsertOnlyScope(scope: ShareScope): boolean {\n  return (\n    scope.permission === \"propose\" && scope.ops.insert && !scope.ops.update && !scope.ops.delete\n  );\n}\n\nexport function isFormSubmissionScope(scope: ShareScope): boolean {\n  return scope.formAccess?.submit === true;\n}\n\nexport function canSearchFormReferences(scope: ShareScope): boolean {\n  return scope.formAccess?.searchReferences === true;\n}\n\nexport function canCreateFormReferences(scope: ShareScope | undefined): boolean {\n  return scope?.formAccess?.createReferences === true;\n}\n\nexport function assertShareLinkTypeConsistency(\n  type: ShareLinkType,\n  scopes: ShareScope[],\n  inviteKind?: ShareInviteKind,\n): void {\n  const normalized = normalizeShareScopes(scopes);\n  if (normalized.length === 0) throw new Error(\"Add at least one table scope\");\n  if (type === \"propose\" && inviteKind === \"public\") {\n    throw new Error(\"Proposal shares require a recipient invite\");\n  }\n  for (const scope of normalized) {\n    if (type === \"view\" && scope.permission !== \"view\") {\n      throw new Error(`View shares require read-only access for ${scope.table}`);\n    }\n    if (\n      type === \"propose\" &&\n      scope.permission !== \"propose\" &&\n      (!isReferenceOnlyScope(scope) || scope.permission !== \"view\")\n    ) {\n      throw new Error(`Proposal shares require proposal access for ${scope.table}`);\n    }\n    if (type === \"propose\" && scope.formAccess?.submit) {\n      throw new Error(`Proposal shares cannot use form submission scopes for ${scope.table}`);\n    }\n    if (type === \"propose\" && isReferenceOnlyScope(scope)) {\n      const formAccess = scope.formAccess;\n      if (!formAccess) throw new Error(`Reference scope ${scope.table} needs reference access`);\n      if (scope.access !== \"full\") {\n        throw new Error(`Reference picker scopes must use full-table access for ${scope.table}`);\n      }\n      if (formAccess.createReferences && !isInsertOnlyScope(scope)) {\n        throw new Error(`Reference creation requires insert-only access for ${scope.table}`);\n      }\n      if (!formAccess.createReferences && scope.permission !== \"view\") {\n        throw new Error(`Read-only reference picker access is required for ${scope.table}`);\n      }\n    }\n    if (type === \"form\") assertFormScope(scope);\n  }\n}\n\nfunction assertFormScope(scope: ShareScope): void {\n  const access = scope.formAccess;\n  if (!access) throw new Error(`Form shares require explicit form access for ${scope.table}`);\n  if (!access.submit && !access.searchReferences && !access.createReferences) {\n    throw new Error(`Form scope ${scope.table} does not grant any capability`);\n  }\n  if (scope.access !== \"full\")\n    throw new Error(`Form scopes must use full-table access for ${scope.table}`);\n  if ((access.submit || access.createReferences) && !isInsertOnlyScope(scope)) {\n    throw new Error(\n      `Form submission and reference creation require insert-only access for ${scope.table}`,\n    );\n  }\n  if (!access.submit && !access.createReferences && scope.permission !== \"view\") {\n    throw new Error(`Read-only form reference access is required for ${scope.table}`);\n  }\n}\n\nexport function canProposeOperation(\n  scope: ShareScope | undefined,\n  operation: ShareOperation,\n): boolean {\n  if (scope?.permission !== \"propose\" || !scope.ops[operation]) return false;\n  return operation !== \"insert\" || scope.access !== \"referenced\" || Boolean(scope.allowCreate);\n}\n\nexport function canProposeInsert(scope: ShareScope | undefined): boolean {\n  return canProposeOperation(scope, \"insert\");\n}\n\nexport function eligibleReferencedParents(\n  manifest: Manifest,\n  scopes: ShareScope[],\n  targetTable: string,\n): ShareScope[] {\n  return scopes.filter((scope) => {\n    const table = manifest.tables.find((candidate) => candidate.name === scope.table);\n    return Boolean(\n      table &&\n        table.name !== targetTable &&\n        refFieldsForTable(table).some((edge) => edge.targetTable === targetTable),\n    );\n  });\n}\n\nexport function assertShareOperation(\n  scopes: ShareScope[],\n  table: string,\n  operation: ShareOperation,\n  rowId?: string,\n  fields?: string[],\n): ShareScope {\n  const scope = scopes.find((candidate) => candidate.table === table);\n  if (scope?.permission !== \"propose\") throw new Error(`${operation} is not allowed for ${table}`);\n  const access = {\n    table: scope.table,\n    ops: scope.ops,\n    recordIds: scope.recordIds,\n    allowedFields: scope.allowedFields,\n  } satisfies ProposalAccess;\n  assertProposalAccess([access], { table, operation, rowId, fields });\n  if (operation === \"insert\" && scope.access === \"referenced\" && !scope.allowCreate) {\n    throw new Error(`Creating referenced ${table} rows is not allowed`);\n  }\n  return scope;\n}\n\nexport function findShareScopeConflicts(\n  scopes: ShareScope[],\n  patches: ShareScopeConflictPatch[],\n): ShareScopeConflictPatch[] {\n  return patches.filter((patch) => {\n    try {\n      assertShareOperation(\n        scopes,\n        patch.table,\n        patch.op,\n        patch.rowId.startsWith(\"new:\") ? undefined : patch.rowId,\n        Object.keys(patch.fields),\n      );\n      return false;\n    } catch {\n      return true;\n    }\n  });\n}\n","import {\n  canCreateFormReferences,\n  canProposeInsert,\n  canProposeOperation,\n  canSearchFormReferences,\n  isFormSubmissionScope,\n  isReferenceOnlyScope,\n} from \"./shareScopes.ts\";\nimport type {\n  GuestCapabilities,\n  GuestCapabilityInput,\n  GuestLinkCapabilities,\n  GuestScopeCapabilities,\n  ShareScope,\n} from \"./shareTypes.ts\";\n\nexport function resolveGuestLinkCapabilities(input: GuestCapabilityInput): GuestLinkCapabilities {\n  const { type } = input.link;\n  const recipientPropose = type === \"propose\" && input.invite.kind === \"recipient\";\n  return {\n    formMode: type === \"form\",\n    canBrowseRows: type === \"view\" || recipientPropose,\n    canListProposals: recipientPropose,\n    canUpsertPatches: type === \"propose\",\n    canToggleViewMode: type !== \"form\",\n  };\n}\n\nexport function resolveGuestScopeCapabilities(\n  input: GuestCapabilityInput & { scope: ShareScope },\n): GuestScopeCapabilities {\n  const link = resolveGuestLinkCapabilities(input);\n  const { scope } = input;\n  const propose = {\n    canProposeInsert: canProposeInsert(scope),\n    canProposeUpdate: link.canUpsertPatches && canProposeOperation(scope, \"update\"),\n    canProposeDelete: link.canUpsertPatches && canProposeOperation(scope, \"delete\"),\n  };\n  if (link.formMode) {\n    const canSearch = canSearchFormReferences(scope);\n    return {\n      visibleInNav: isFormSubmissionScope(scope),\n      canReadDisplay: canSearch,\n      canSearchReferences: canSearch,\n      canCreateReferences: canCreateFormReferences(scope),\n      ...propose,\n    };\n  }\n  if (isReferenceOnlyScope(scope)) {\n    const canSearch = canSearchFormReferences(scope);\n    const canCreate = canCreateFormReferences(scope);\n    return {\n      visibleInNav: false,\n      canReadDisplay: canSearch || canCreate,\n      canSearchReferences: canSearch,\n      canCreateReferences: canCreate,\n      ...propose,\n    };\n  }\n  return {\n    visibleInNav: true,\n    canReadDisplay: true,\n    canSearchReferences: true,\n    canCreateReferences: canProposeInsert(scope),\n    ...propose,\n  };\n}\n\nexport function resolveGuestCapabilities(\n  input: GuestCapabilityInput & { scope?: ShareScope },\n): GuestCapabilities {\n  return {\n    link: resolveGuestLinkCapabilities(input),\n    scope: input.scope\n      ? resolveGuestScopeCapabilities({ ...input, scope: input.scope })\n      : undefined,\n  };\n}\n\nexport function guestVisibleScopes(\n  input: GuestCapabilityInput & { scopes: ShareScope[] },\n): ShareScope[] {\n  return input.scopes.filter(\n    (scope) => resolveGuestScopeCapabilities({ ...input, scope }).visibleInNav,\n  );\n}\n\nexport function guestSearchableScopes(\n  input: GuestCapabilityInput & { scopes: ShareScope[] },\n): ShareScope[] {\n  return input.scopes.filter(\n    (scope) => resolveGuestScopeCapabilities({ ...input, scope }).canSearchReferences,\n  );\n}\n"]}

package/dist/shareProposal.d.ts

@@ -0,0 +1,113 @@
+import { type Manifest } from "./schemaTypes.ts";
+import type { ShareScope } from "./shareTypes.ts";
+export type ProposalPatchForPlanning = {
+    id: string;
+    table: string;
+    rowId: string;
+    op: "insert" | "update" | "delete";
+    fields: Record<string, unknown>;
+    seq: number;
+    _creationTime: number;
+};
+/**
+ * Mint a provisional row id. The `new:` prefix is what every guard in this
+ * module keys off, so producers must go through here rather than inlining it.
+ */
+export declare function newProvisionalRowId(): string;
+/** Table-qualified key for a provisional row, avoiding cross-table `new:*` collisions. */
+export declare function provisionalRowKey(table: string, rowId: string): string;
+/**
+ * Validate and order proposal patches so every provisional producer is applied
+ * before patches that reference it. Stored sequence remains a stable tie-breaker.
+ */
+export declare function planProposalPatches<P extends ProposalPatchForPlanning>(manifest: Manifest, patches: readonly P[]): {
+    orderedPatches: P[];
+    hasDependencies: boolean;
+};
+/** Strip stale fields, skip empty updates, fail closed on type/requiredness errors. */
+export declare function prepareProposalPatchesForAccept<P extends ProposalPatchForPlanning>(manifest: Manifest, scopes: readonly ShareScope[], patches: readonly P[]): P[];
+export type ProposalPatchTarget = {
+    table: string;
+    rowId: string;
+    op: "insert" | "update" | "delete";
+    /** Present for updates; key set used for field-aware overlap. */
+    fields?: Record<string, unknown>;
+};
+export type ProposalStaleCheckPatch = ProposalPatchTarget & {
+    baseFields?: Record<string, unknown> | null;
+};
+export type ProposalPatchTargets = {
+    id: string;
+    patches: ProposalPatchTarget[];
+};
+/**
+ * Base snapshot captured server-side at propose time (plan 051 PR 2); accept
+ * compares it against the live row. Proposals without base data (share links,
+ * `col_` API tokens) are exempt so existing flows keep today's behavior.
+ */
+export declare function snapshotBaseFields(op: "insert" | "update" | "delete", proposedFields: Record<string, unknown>, liveRow: Record<string, unknown> | null): Record<string, unknown> | undefined;
+export declare function patchIsStale(patch: ProposalStaleCheckPatch, liveRow: Record<string, unknown> | null): {
+    stale: boolean;
+    reason?: string;
+};
+/**
+ * Ids of proposals with a true field-level conflict against another listed
+ * proposal: intersecting update fields, or delete vs any op, on the same live
+ * row. Disjoint updates and provisional `new:` rows do not conflict.
+ */
+export declare function findOverlappingProposalIds(proposals: ProposalPatchTargets[]): Set<string>;
+/**
+ * Ids among `candidates` that field-conflict with `target` (excludes target itself).
+ * Prefer this over all-pairs when answering a single-proposal question (e.g. publish mine).
+ */
+export declare function findProposalIdsOverlappingTarget(target: ProposalPatchTargets, candidates: ProposalPatchTargets[]): Set<string>;
+/** True when `target` field-conflicts with any other candidate (short-circuits). */
+export declare function proposalOverlapsAny(target: ProposalPatchTargets, candidates: ProposalPatchTargets[]): boolean;
+/** Replace provisional IDs only in manifest-declared top-level `id` and `id[]` fields. */
+export declare function replaceProvisionalReferences(manifest: Manifest, tableName: string, fields: Record<string, unknown>, createdIds: ReadonlyMap<string, string>): Record<string, unknown>;
+export type ProposalPatchOp = "insert" | "update" | "delete";
+/** Editor/CMS draft patch — rowId is always known (including `new:…`). */
+export type ProposalDraftPatch = {
+    table: string;
+    rowId: string;
+    op: ProposalPatchOp;
+    fields: Record<string, unknown>;
+};
+export type ProposalClientPatch = ProposalDraftPatch & {
+    id?: string;
+    baseFields?: Record<string, unknown> | null;
+    baseline?: Record<string, unknown> | null;
+    seq?: number;
+};
+/** Client-facing proposal summary (CMS + profile proposal list). */
+export type ProposalClientSummary = {
+    id: string;
+    source: "share" | "api" | "editor";
+    status: string;
+    apiProfileId?: string;
+    createdByUserId?: string;
+    createdAt: number;
+    patches: ProposalClientPatch[];
+};
+export type ProposalBatchOutcome = {
+    id: string;
+    outcome: "accepted" | "rejected" | "skipped_stale" | "skipped_overlap";
+    message?: string;
+};
+export declare const OVERLAP_MESSAGE = "Another pending proposal touches the same rows";
+/**
+ * Accept-batch orchestration shared by host profile accept and the CMS fixture
+ * mock store. Overlap only gates multi-accept; stale always skips. `onAccept`
+ * runs only for proposals that clear those gates.
+ */
+export declare function runAcceptProposalBatch(args: {
+    proposalIds: string[];
+    activeProposals: Array<{
+        id: string;
+        patches: ProposalStaleCheckPatch[];
+    }>;
+    getLiveRow: (table: string, rowId: string) => Record<string, unknown> | null | Promise<Record<string, unknown> | null>;
+    onAccept: (id: string) => void | Promise<void>;
+    /** How to treat ids absent from `activeProposals`. Default: throw. */
+    onMissing?: "reject" | "throw";
+}): Promise<ProposalBatchOutcome[]>;