@columnus/shared 0.1.47

package/dist/shareTypes.d.ts

@@ -0,0 +1,107 @@
+import type { ClampQuery } from "./queryTypes.ts";
+export type SharePermission = "view" | "propose";
+export type ShareAccess = "full" | "referenced";
+export type ShareOperation = "insert" | "update" | "delete";
+export type ShareOps = {
+    insert: boolean;
+    update: boolean;
+    delete: boolean;
+};
+export type ShareFormAccess = {
+    submit: boolean;
+    searchReferences: boolean;
+    createReferences: boolean;
+};
+export type ShareScope = {
+    table: string;
+    /** Explicit guest-navigation membership. Normalization fills legacy omissions. */
+    primary?: boolean;
+    access: ShareAccess;
+    recordIds?: string[];
+    permission: SharePermission;
+    ops: ShareOps;
+    allowCreate?: boolean;
+    /** Optional form allowlist. Omitted means every non-system manifest field. */
+    allowedFields?: string[];
+    /** Submit and reference-picker capabilities for form and propose links. */
+    formAccess?: ShareFormAccess;
+    /** Opaque row clamp AND-merged with optional guest Query on full-table lists. */
+    rowQuery?: ClampQuery;
+    /** Scan ceiling for this scope; guest maxScan may only lower. */
+    maxScanLimit?: number;
+};
+export type ShareInviteKind = "recipient" | "public";
+export type ShareInviteAuth = "token" | "email";
+export type ShareScopeAccessMode = "full" | "selected" | "referenced";
+export type ShareLinkType = "form" | "view" | "propose";
+export type ShareGuestViewMode = "grid" | "detail";
+export type ShareWizardTableInput = {
+    table: string;
+    recordIds?: string[];
+    allowedFields?: string[];
+};
+export type ShareWizardReferenceInput = {
+    table: string;
+    searchReferences: boolean;
+    createReferences: boolean;
+};
+export type ShareWizardInput = {
+    tables: ShareWizardTableInput[];
+    ops?: Partial<ShareOps>;
+    references?: ShareWizardReferenceInput[];
+};
+export type ShareRefChoice = "pick" | "create" | "hide";
+export type ShareConfiguratorState = {
+    tables: string[];
+    allowedFields: Record<string, string[]>;
+    recordIds: Record<string, string>;
+    refChoices: Record<string, ShareRefChoice>;
+    ops: ShareOps;
+};
+export type GuestCapabilityInput = {
+    link: {
+        type: ShareLinkType;
+    };
+    invite: {
+        kind: ShareInviteKind;
+    };
+};
+export type GuestLinkCapabilities = {
+    formMode: boolean;
+    canBrowseRows: boolean;
+    canListProposals: boolean;
+    canUpsertPatches: boolean;
+    canToggleViewMode: boolean;
+};
+export type GuestScopeCapabilities = {
+    visibleInNav: boolean;
+    canReadDisplay: boolean;
+    canSearchReferences: boolean;
+    canCreateReferences: boolean;
+    canProposeInsert: boolean;
+    canProposeUpdate: boolean;
+    canProposeDelete: boolean;
+};
+export type GuestCapabilities = {
+    link: GuestLinkCapabilities;
+    scope?: GuestScopeCapabilities;
+};
+export type ShareScopeConflictPatch = {
+    table: string;
+    rowId: string;
+    op: ShareOperation;
+    fields: Record<string, unknown>;
+};
+export type ProposalFieldDiff = {
+    field: string;
+    before: unknown;
+    after: unknown;
+};
+/** Full-record proposal review row (schema field order, including unchanged). */
+export type ProposalRecordFieldDiff = {
+    field: string;
+    before: unknown;
+    after: unknown;
+    changed: boolean;
+};
+export type ProposalDiffViewMode = "diff" | "table";

package/dist/shareTypes.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=shareTypes.js.map
+//# sourceMappingURL=shareTypes.js.map

package/dist/shareTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"shareTypes.js"}

package/dist/shareValidators.d.ts

@@ -0,0 +1,168 @@
+/** Convex boundary validators shared by the share component and host facade. */
+export declare const shareScopeValidator: import("convex/values").VObject<{
+    allowedFields?: string[] | undefined;
+    recordIds?: string[] | undefined;
+    rowQuery?: {
+        predicates?: any[] | undefined;
+        order?: {
+            field: string;
+            direction: "asc" | "desc";
+        } | undefined;
+        search?: {
+            index: string;
+            query: string;
+        } | undefined;
+    } | undefined;
+    maxScanLimit?: number | undefined;
+    primary?: boolean | undefined;
+    allowCreate?: boolean | undefined;
+    formAccess?: {
+        submit: boolean;
+        searchReferences: boolean;
+        createReferences: boolean;
+    } | undefined;
+    ops: {
+        insert: boolean;
+        update: boolean;
+        delete: boolean;
+    };
+    table: string;
+    access: "full" | "referenced";
+    permission: "propose" | "view";
+}, {
+    table: import("convex/values").VString<string, "required">;
+    primary: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    access: import("convex/values").VUnion<"full" | "referenced", [import("convex/values").VLiteral<"full", "required">, import("convex/values").VLiteral<"referenced", "required">], "required", never>;
+    recordIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    permission: import("convex/values").VUnion<"propose" | "view", [import("convex/values").VLiteral<"view", "required">, import("convex/values").VLiteral<"propose", "required">], "required", never>;
+    ops: import("convex/values").VObject<{
+        insert: boolean;
+        update: boolean;
+        delete: boolean;
+    }, {
+        insert: import("convex/values").VBoolean<boolean, "required">;
+        update: import("convex/values").VBoolean<boolean, "required">;
+        delete: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "insert" | "update" | "delete">;
+    allowCreate: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    allowedFields: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    formAccess: import("convex/values").VObject<{
+        submit: boolean;
+        searchReferences: boolean;
+        createReferences: boolean;
+    } | undefined, {
+        submit: import("convex/values").VBoolean<boolean, "required">;
+        searchReferences: import("convex/values").VBoolean<boolean, "required">;
+        createReferences: import("convex/values").VBoolean<boolean, "required">;
+    }, "optional", "submit" | "searchReferences" | "createReferences">;
+    rowQuery: import("convex/values").VObject<{
+        predicates?: any[] | undefined;
+        order?: {
+            field: string;
+            direction: "asc" | "desc";
+        } | undefined;
+        search?: {
+            index: string;
+            query: string;
+        } | undefined;
+    } | undefined, {
+        predicates: import("convex/values").VArray<any[] | undefined, import("convex/values").VUnion<any, [import("convex/values").GenericValidator, import("convex/values").GenericValidator, ...import("convex/values").GenericValidator[]], "required", any>, "optional">;
+        order: import("convex/values").VObject<{
+            field: string;
+            direction: "asc" | "desc";
+        } | undefined, {
+            field: import("convex/values").VString<string, "required">;
+            direction: import("convex/values").VUnion<"asc" | "desc", [import("convex/values").VLiteral<"asc", "required">, import("convex/values").VLiteral<"desc", "required">], "required", never>;
+        }, "optional", "field" | "direction">;
+        search: import("convex/values").VObject<{
+            index: string;
+            query: string;
+        } | undefined, {
+            index: import("convex/values").VString<string, "required">;
+            query: import("convex/values").VString<string, "required">;
+        }, "optional", "index" | "query">;
+    }, "optional", "predicates" | "order" | "search" | "order.field" | "order.direction" | "search.index" | "search.query">;
+    maxScanLimit: import("convex/values").VFloat64<number | undefined, "optional">;
+}, "required", "ops" | "table" | "access" | "allowedFields" | "recordIds" | "rowQuery" | "maxScanLimit" | "primary" | "permission" | "allowCreate" | "formAccess" | "ops.insert" | "ops.update" | "ops.delete" | "rowQuery.predicates" | "rowQuery.order" | "rowQuery.search" | "rowQuery.order.field" | "rowQuery.order.direction" | "rowQuery.search.index" | "rowQuery.search.query" | "formAccess.submit" | "formAccess.searchReferences" | "formAccess.createReferences">;
+export declare const shareWizardTableValidator: import("convex/values").VObject<{
+    allowedFields?: string[] | undefined;
+    recordIds?: string[] | undefined;
+    table: string;
+}, {
+    table: import("convex/values").VString<string, "required">;
+    recordIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    allowedFields: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+}, "required", "table" | "allowedFields" | "recordIds">;
+export declare const shareWizardReferenceValidator: import("convex/values").VObject<{
+    table: string;
+    searchReferences: boolean;
+    createReferences: boolean;
+}, {
+    table: import("convex/values").VString<string, "required">;
+    searchReferences: import("convex/values").VBoolean<boolean, "required">;
+    createReferences: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "table" | "searchReferences" | "createReferences">;
+export declare const shareWizardInputValidator: import("convex/values").VObject<{
+    ops?: {
+        insert: boolean;
+        update: boolean;
+        delete: boolean;
+    } | undefined;
+    references?: {
+        table: string;
+        searchReferences: boolean;
+        createReferences: boolean;
+    }[] | undefined;
+    tables: {
+        allowedFields?: string[] | undefined;
+        recordIds?: string[] | undefined;
+        table: string;
+    }[];
+}, {
+    tables: import("convex/values").VArray<{
+        allowedFields?: string[] | undefined;
+        recordIds?: string[] | undefined;
+        table: string;
+    }[], import("convex/values").VObject<{
+        allowedFields?: string[] | undefined;
+        recordIds?: string[] | undefined;
+        table: string;
+    }, {
+        table: import("convex/values").VString<string, "required">;
+        recordIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+        allowedFields: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    }, "required", "table" | "allowedFields" | "recordIds">, "required">;
+    ops: import("convex/values").VObject<{
+        insert: boolean;
+        update: boolean;
+        delete: boolean;
+    } | undefined, {
+        insert: import("convex/values").VBoolean<boolean, "required">;
+        update: import("convex/values").VBoolean<boolean, "required">;
+        delete: import("convex/values").VBoolean<boolean, "required">;
+    }, "optional", "insert" | "update" | "delete">;
+    references: import("convex/values").VArray<{
+        table: string;
+        searchReferences: boolean;
+        createReferences: boolean;
+    }[] | undefined, import("convex/values").VObject<{
+        table: string;
+        searchReferences: boolean;
+        createReferences: boolean;
+    }, {
+        table: import("convex/values").VString<string, "required">;
+        searchReferences: import("convex/values").VBoolean<boolean, "required">;
+        createReferences: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "table" | "searchReferences" | "createReferences">, "optional">;
+}, "required", "ops" | "tables" | "ops.insert" | "ops.update" | "ops.delete" | "references">;
+export declare const sharePatchValidator: import("convex/values").VObject<{
+    rowId?: string | undefined;
+    op: "insert" | "update" | "delete";
+    table: string;
+    fields: any;
+}, {
+    table: import("convex/values").VString<string, "required">;
+    rowId: import("convex/values").VString<string | undefined, "optional">;
+    op: import("convex/values").VUnion<"insert" | "update" | "delete", [import("convex/values").VLiteral<"update", "required">, import("convex/values").VLiteral<"insert", "required">, import("convex/values").VLiteral<"delete", "required">], "required", never>;
+    fields: import("convex/values").VAny<any, "required", string>;
+}, "required", "op" | "table" | "fields" | "rowId" | `fields.${string}`>;

package/dist/shareValidators.js

@@ -0,0 +1,124 @@
+import { v } from 'convex/values';
+
+// packages/@columnus/shared/src/shareValidators.ts
+
+// packages/@columnus/shared/src/queryFieldOps.ts
+var PREDICATE_VARIANTS = [
+  {
+    value: "unknown",
+    ops: [
+      { op: "eq", label: "=" },
+      { op: "neq", label: "\u2260" }
+    ]
+  },
+  { value: "unknownArray", ops: [{ op: "in", label: "in" }] },
+  {
+    value: "unknown",
+    ops: [
+      { op: "gt", label: ">" },
+      { op: "gte", label: "\u2265" },
+      { op: "lt", label: "<" },
+      { op: "lte", label: "\u2264" }
+    ]
+  },
+  { value: "between", ops: [{ op: "between", label: "between" }] },
+  {
+    value: "unknownArray",
+    ops: [{ op: "containsAll", label: "contains all" }]
+  }
+];
+PREDICATE_VARIANTS.flatMap(
+  (variant) => variant.ops.map(({ op }) => op)
+);
+new Map(
+  PREDICATE_VARIANTS.flatMap((variant) => variant.ops.map(({ op, label }) => [op, label]))
+);
+
+// packages/@columnus/shared/src/queryValidators.ts
+var predicateValidators = PREDICATE_VARIANTS.flatMap(
+  (variant) => variant.ops.map(
+    ({ op }) => v.object({
+      field: v.string(),
+      op: v.literal(op),
+      value: variant.value === "unknownArray" ? v.array(v.any()) : variant.value === "between" ? v.object({ min: v.any(), max: v.any() }) : v.any()
+    })
+  )
+);
+var predicateValidator = v.union(
+  ...predicateValidators
+);
+var queryOrderValidator = v.object({
+  field: v.string(),
+  direction: v.union(v.literal("asc"), v.literal("desc"))
+});
+var querySearchValidator = v.object({
+  index: v.string(),
+  query: v.string()
+});
+var queryValidator = v.object({
+  predicates: v.optional(v.array(predicateValidator)),
+  order: v.optional(queryOrderValidator),
+  search: v.optional(querySearchValidator),
+  maxScan: v.optional(v.number()),
+  indexHint: v.optional(v.string()),
+  vector: v.optional(v.any())
+});
+var clampQueryValidator = v.object({
+  predicates: v.optional(v.array(predicateValidator)),
+  order: v.optional(queryOrderValidator),
+  search: v.optional(querySearchValidator)
+});
+v.optional(queryValidator);
+var maxScanLimitValidator = v.optional(v.number());
+
+// packages/@columnus/shared/src/shareValidators.ts
+var shareScopeValidator = v.object({
+  table: v.string(),
+  primary: v.optional(v.boolean()),
+  access: v.union(v.literal("full"), v.literal("referenced")),
+  recordIds: v.optional(v.array(v.string())),
+  permission: v.union(v.literal("view"), v.literal("propose")),
+  ops: v.object({ insert: v.boolean(), update: v.boolean(), delete: v.boolean() }),
+  allowCreate: v.optional(v.boolean()),
+  allowedFields: v.optional(v.array(v.string())),
+  formAccess: v.optional(
+    v.object({
+      submit: v.boolean(),
+      searchReferences: v.boolean(),
+      createReferences: v.boolean()
+    })
+  ),
+  rowQuery: v.optional(clampQueryValidator),
+  maxScanLimit: maxScanLimitValidator
+});
+var shareWizardTableValidator = v.object({
+  table: v.string(),
+  recordIds: v.optional(v.array(v.string())),
+  allowedFields: v.optional(v.array(v.string()))
+});
+var shareWizardReferenceValidator = v.object({
+  table: v.string(),
+  searchReferences: v.boolean(),
+  createReferences: v.boolean()
+});
+var shareWizardInputValidator = v.object({
+  tables: v.array(shareWizardTableValidator),
+  ops: v.optional(
+    v.object({
+      insert: v.boolean(),
+      update: v.boolean(),
+      delete: v.boolean()
+    })
+  ),
+  references: v.optional(v.array(shareWizardReferenceValidator))
+});
+var sharePatchValidator = v.object({
+  table: v.string(),
+  rowId: v.optional(v.string()),
+  op: v.union(v.literal("update"), v.literal("insert"), v.literal("delete")),
+  fields: v.any()
+});
+
+export { sharePatchValidator, shareScopeValidator, shareWizardInputValidator, shareWizardReferenceValidator, shareWizardTableValidator };
+//# sourceMappingURL=shareValidators.js.map
+//# sourceMappingURL=shareValidators.js.map

package/dist/shareValidators.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queryFieldOps.ts","../src/queryValidators.ts","../src/shareValidators.ts"],"names":["v"],"mappings":"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","file":"shareValidators.js","sourcesContent":["import type { FieldType, Table } from \"./schemaTypes.ts\";\n\n/** One edit surface for each predicate operation's wire shape and UI label. */\nexport const PREDICATE_VARIANTS = [\n  {\n    value: \"unknown\",\n    ops: [\n      { op: \"eq\", label: \"=\" },\n      { op: \"neq\", label: \"≠\" },\n    ],\n  },\n  { value: \"unknownArray\", ops: [{ op: \"in\", label: \"in\" }] },\n  {\n    value: \"unknown\",\n    ops: [\n      { op: \"gt\", label: \">\" },\n      { op: \"gte\", label: \"≥\" },\n      { op: \"lt\", label: \"<\" },\n      { op: \"lte\", label: \"≤\" },\n    ],\n  },\n  { value: \"between\", ops: [{ op: \"between\", label: \"between\" }] },\n  {\n    value: \"unknownArray\",\n    ops: [{ op: \"containsAll\", label: \"contains all\" }],\n  },\n] as const;\n\ntype PredicateOperator = (typeof PREDICATE_VARIANTS)[number][\"ops\"][number];\nexport type PredicateOp = PredicateOperator[\"op\"];\nexport const PREDICATE_OPS = PREDICATE_VARIANTS.flatMap((variant) =>\n  variant.ops.map(({ op }) => op),\n) as PredicateOp[];\n\nconst PREDICATE_OP_LABELS = new Map<PredicateOp, string>(\n  PREDICATE_VARIANTS.flatMap((variant) => variant.ops.map(({ op, label }) => [op, label] as const)),\n);\n\nexport function predicateOpLabel(op: PredicateOp): string {\n  return PREDICATE_OP_LABELS.get(op) ?? op;\n}\n\nexport type FieldOpSupport = {\n  eq: boolean;\n  neq: boolean;\n  in: boolean;\n  ranges: boolean;\n  sort: boolean;\n  containsAll: boolean;\n};\n\nconst NONE: FieldOpSupport = {\n  eq: false,\n  neq: false,\n  in: false,\n  ranges: false,\n  sort: false,\n  containsAll: false,\n};\n\nconst SCALAR_ORDERED: FieldOpSupport = {\n  eq: true,\n  neq: true,\n  in: true,\n  ranges: true,\n  sort: true,\n  containsAll: false,\n};\n\nconst SCALAR_EQ: FieldOpSupport = {\n  eq: true,\n  neq: true,\n  in: true,\n  ranges: false,\n  sort: true,\n  containsAll: false,\n};\n\n/** Resolve field type for user fields and system fields (`_id`, `_creationTime`). */\nexport function resolveQueryFieldType(\n  table: Pick<Table, \"name\" | \"fields\">,\n  field: string,\n): FieldType | null {\n  if (field === \"_id\") return { kind: \"id\", table: table.name };\n  if (field === \"_creationTime\") return { kind: \"number\" };\n  return table.fields.find((f) => f.name === field)?.type ?? null;\n}\n\nfunction comparableUnionKind(t: FieldType): FieldType | null {\n  if (t.kind !== \"union\" || t.options.length === 0) return null;\n  const first = t.options[0]!;\n  if (!t.options.every((o) => o.kind === first.kind)) return null;\n  if (\n    first.kind === \"string\" ||\n    first.kind === \"number\" ||\n    first.kind === \"bigint\" ||\n    first.kind === \"boolean\" ||\n    first.kind === \"date\" ||\n    first.kind === \"datetime\" ||\n    first.kind === \"id\"\n  ) {\n    return first;\n  }\n  if (first.kind === \"literal\") {\n    const v = first.value;\n    if (typeof v === \"string\") return { kind: \"string\" };\n    if (typeof v === \"number\") return { kind: \"number\" };\n    if (typeof v === \"boolean\") return { kind: \"boolean\" };\n  }\n  return null;\n}\n\n/** Effective type used for operator eligibility (unwraps homogeneous unions). */\nexport function effectiveQueryFieldType(t: FieldType): FieldType | null {\n  if (t.kind === \"union\") return comparableUnionKind(t);\n  return t;\n}\n\nexport function fieldOpSupport(type: FieldType): FieldOpSupport {\n  const t = effectiveQueryFieldType(type);\n  if (!t) return NONE;\n\n  switch (t.kind) {\n    case \"string\":\n    case \"number\":\n    case \"bigint\":\n    case \"date\":\n    case \"datetime\":\n      return SCALAR_ORDERED;\n    case \"boolean\":\n    case \"id\":\n    case \"literal\":\n      return SCALAR_EQ;\n    case \"array\":\n      if (\n        t.element.kind === \"id\" ||\n        t.element.kind === \"string\" ||\n        t.element.kind === \"number\" ||\n        t.element.kind === \"boolean\" ||\n        t.element.kind === \"literal\"\n      ) {\n        return { ...NONE, containsAll: true };\n      }\n      return NONE;\n    default:\n      return NONE;\n  }\n}\n\nexport function opAllowedForType(type: FieldType, op: PredicateOp): boolean {\n  const support = fieldOpSupport(type);\n  switch (op) {\n    case \"eq\":\n      return support.eq;\n    case \"neq\":\n      return support.neq;\n    case \"in\":\n      return support.in;\n    case \"gt\":\n    case \"gte\":\n    case \"lt\":\n    case \"lte\":\n    case \"between\":\n      return support.ranges;\n    case \"containsAll\":\n      return support.containsAll;\n    default: {\n      const _exhaustive: never = op;\n      return _exhaustive;\n    }\n  }\n}\n\nexport function fieldSupportsSort(type: FieldType): boolean {\n  return fieldOpSupport(type).sort;\n}\n\nexport function isRangeOp(op: PredicateOp): boolean {\n  return op === \"gt\" || op === \"gte\" || op === \"lt\" || op === \"lte\" || op === \"between\";\n}\n","import { type GenericValidator, v } from \"convex/values\";\nimport { PREDICATE_VARIANTS } from \"./queryFieldOps.ts\";\n\nconst predicateValidators = PREDICATE_VARIANTS.flatMap((variant) =>\n  variant.ops.map(({ op }) =>\n    v.object({\n      field: v.string(),\n      op: v.literal(op),\n      value:\n        variant.value === \"unknownArray\"\n          ? v.array(v.any())\n          : variant.value === \"between\"\n            ? v.object({ min: v.any(), max: v.any() })\n            : v.any(),\n    }),\n  ),\n);\n\nexport const predicateValidator = v.union(\n  ...(predicateValidators as unknown as [\n    GenericValidator,\n    GenericValidator,\n    ...GenericValidator[],\n  ]),\n);\n\nconst queryOrderValidator = v.object({\n  field: v.string(),\n  direction: v.union(v.literal(\"asc\"), v.literal(\"desc\")),\n});\n\nconst querySearchValidator = v.object({\n  index: v.string(),\n  query: v.string(),\n});\n\n/** Canonical Convex validator for caller-supplied Query values. */\nexport const queryValidator = v.object({\n  predicates: v.optional(v.array(predicateValidator)),\n  order: v.optional(queryOrderValidator),\n  search: v.optional(querySearchValidator),\n  maxScan: v.optional(v.number()),\n  indexHint: v.optional(v.string()),\n  vector: v.optional(v.any()),\n});\n\n/** Convex validator for profile/share clamp Query (predicates + optional defaults). */\nexport const clampQueryValidator = v.object({\n  predicates: v.optional(v.array(predicateValidator)),\n  order: v.optional(queryOrderValidator),\n  search: v.optional(querySearchValidator),\n});\n\n/** Optional Query arg for list endpoints (`query?`). */\nexport const queryArgValidator = v.optional(queryValidator);\n\nexport const maxScanLimitValidator = v.optional(v.number());\n","import { v } from \"convex/values\";\nimport { clampQueryValidator, maxScanLimitValidator } from \"./queryValidators.ts\";\n\n/** Convex boundary validators shared by the share component and host facade. */\nexport const shareScopeValidator = v.object({\n  table: v.string(),\n  primary: v.optional(v.boolean()),\n  access: v.union(v.literal(\"full\"), v.literal(\"referenced\")),\n  recordIds: v.optional(v.array(v.string())),\n  permission: v.union(v.literal(\"view\"), v.literal(\"propose\")),\n  ops: v.object({ insert: v.boolean(), update: v.boolean(), delete: v.boolean() }),\n  allowCreate: v.optional(v.boolean()),\n  allowedFields: v.optional(v.array(v.string())),\n  formAccess: v.optional(\n    v.object({\n      submit: v.boolean(),\n      searchReferences: v.boolean(),\n      createReferences: v.boolean(),\n    }),\n  ),\n  rowQuery: v.optional(clampQueryValidator),\n  maxScanLimit: maxScanLimitValidator,\n});\n\nexport const shareWizardTableValidator = v.object({\n  table: v.string(),\n  recordIds: v.optional(v.array(v.string())),\n  allowedFields: v.optional(v.array(v.string())),\n});\n\nexport const shareWizardReferenceValidator = v.object({\n  table: v.string(),\n  searchReferences: v.boolean(),\n  createReferences: v.boolean(),\n});\n\nexport const shareWizardInputValidator = v.object({\n  tables: v.array(shareWizardTableValidator),\n  ops: v.optional(\n    v.object({\n      insert: v.boolean(),\n      update: v.boolean(),\n      delete: v.boolean(),\n    }),\n  ),\n  references: v.optional(v.array(shareWizardReferenceValidator)),\n});\n\nexport const sharePatchValidator = v.object({\n  table: v.string(),\n  rowId: v.optional(v.string()),\n  op: v.union(v.literal(\"update\"), v.literal(\"insert\"), v.literal(\"delete\")),\n  fields: v.any(),\n});\n"]}

package/dist/shareWizard.d.ts

@@ -0,0 +1,14 @@
+import type { Manifest } from "./schemaTypes.ts";
+import type { ShareConfiguratorState, ShareLinkType, ShareOps, ShareRefChoice, ShareScope, ShareWizardInput } from "./shareTypes.ts";
+export declare function shareTypeDefaultScopes(type: ShareLinkType, input: ShareWizardInput): ShareScope[];
+export declare function isPrimaryShareScope(_type: ShareLinkType, scope: ShareScope): boolean;
+export declare function scopesToWizardInput(type: ShareLinkType, rawScopes: ShareScope[], manifest: Manifest): ShareConfiguratorState;
+export declare function buildShareWizardInput(args: {
+    type: ShareLinkType;
+    manifest: Manifest;
+    tables: string[];
+    allowedFields: Record<string, string[]>;
+    recordIds: Record<string, string>;
+    refChoices: Record<string, ShareRefChoice>;
+    ops?: ShareOps;
+}): ShareWizardInput;

package/dist/shareWizard.js

@@ -0,0 +1,200 @@
+// packages/@columnus/shared/src/refGraph.ts
+function refEdgesForType(type) {
+  switch (type.kind) {
+    case "id":
+      return [{ field: "", targetTable: type.table, array: false }];
+    case "array":
+      if (type.element.kind === "id") {
+        return [{ field: "", targetTable: type.element.table, array: true }];
+      }
+      return [];
+    default:
+      return [];
+  }
+}
+function refFieldsForTable(table) {
+  const edges = [];
+  for (const field of table.fields) {
+    for (const template of refEdgesForType(field.type)) {
+      edges.push({ ...template, field: field.name });
+    }
+  }
+  return edges.sort(
+    (a, b) => a.field.localeCompare(b.field) || a.targetTable.localeCompare(b.targetTable)
+  );
+}
+
+// packages/@columnus/shared/src/shareScopes.ts
+function inferLegacyPrimary(scope) {
+  const access = scope.formAccess;
+  return !(access && !access.submit && (access.searchReferences || access.createReferences));
+}
+function normalizeShareScopes(scopes) {
+  const tables = /* @__PURE__ */ new Set();
+  return scopes.map((scope) => {
+    const table = scope.table.trim();
+    if (!table) throw new Error("Every share scope needs a table");
+    if (tables.has(table)) throw new Error(`Duplicate share scope for ${table}`);
+    tables.add(table);
+    const recordIds = scope.recordIds ? [...new Set(scope.recordIds.map((id) => id.trim()).filter(Boolean))] : void 0;
+    const allowedFields = scope.allowedFields ? [...new Set(scope.allowedFields.map((field) => field.trim()).filter(Boolean))] : void 0;
+    if (scope.access === "referenced" && recordIds) {
+      throw new Error(`Referenced scope ${table} cannot specify recordIds`);
+    }
+    if (recordIds && scope.permission === "propose" && scope.ops.insert) {
+      throw new Error(`Record-picked scope ${table} cannot allow inserts`);
+    }
+    if (scope.allowCreate && (scope.access !== "referenced" || scope.permission !== "propose" || !scope.ops.insert)) {
+      throw new Error(`allowCreate requires referenced propose insert access for ${table}`);
+    }
+    return {
+      ...scope,
+      table,
+      primary: scope.primary ?? inferLegacyPrimary(scope),
+      recordIds,
+      allowedFields,
+      ops: scope.permission === "view" ? { insert: false, update: false, delete: false } : { ...scope.ops }
+    };
+  });
+}
+function mergeReferenceScopes(scopes, references) {
+  const next = normalizeShareScopes(scopes);
+  for (const reference of references) {
+    const existing = next.find((scope) => scope.table === reference.table.trim());
+    const formAccess = {
+      submit: existing?.formAccess?.submit ?? false,
+      searchReferences: (existing?.formAccess?.searchReferences ?? false) || reference.searchReferences,
+      createReferences: (existing?.formAccess?.createReferences ?? false) || reference.createReferences
+    };
+    if (existing) {
+      existing.formAccess = formAccess;
+      if (formAccess.createReferences && !existing.primary) {
+        existing.permission = "propose";
+        existing.ops = { insert: true, update: false, delete: false };
+      }
+      continue;
+    }
+    next.push({
+      table: reference.table,
+      primary: false,
+      access: "full",
+      permission: formAccess.createReferences ? "propose" : "view",
+      ops: formAccess.createReferences ? { insert: true, update: false, delete: false } : { insert: false, update: false, delete: false },
+      formAccess
+    });
+  }
+  return next;
+}
+
+// packages/@columnus/shared/src/shareWizard.ts
+function shareTypeDefaultScopes(type, input) {
+  const scopes = input.tables.map(({ table, recordIds, allowedFields }) => {
+    if (type === "form") {
+      return {
+        table,
+        primary: true,
+        access: "full",
+        permission: "propose",
+        ops: { insert: true, update: false, delete: false },
+        allowedFields,
+        formAccess: { submit: true, searchReferences: false, createReferences: false }
+      };
+    }
+    if (type === "view") {
+      return {
+        table,
+        primary: true,
+        access: "full",
+        recordIds,
+        permission: "view",
+        ops: { insert: false, update: false, delete: false },
+        allowedFields
+      };
+    }
+    return {
+      table,
+      primary: true,
+      access: "full",
+      permission: "propose",
+      ops: {
+        insert: input.ops?.insert ?? true,
+        update: input.ops?.update ?? true,
+        delete: input.ops?.delete ?? false
+      },
+      allowedFields
+    };
+  });
+  return type === "form" || type === "propose" ? normalizeShareScopes(mergeReferenceScopes(scopes, input.references ?? [])) : normalizeShareScopes(scopes);
+}
+function isPrimaryShareScope(_type, scope) {
+  return scope.primary === true;
+}
+function scopesToWizardInput(type, rawScopes, manifest) {
+  const scopes = normalizeShareScopes(rawScopes);
+  const primaryScopes = scopes.filter((scope) => isPrimaryShareScope(type, scope));
+  const tables = primaryScopes.map((scope) => scope.table);
+  const allowedFields = {};
+  const recordIds = {};
+  const refChoices = {};
+  for (const scope of primaryScopes) {
+    const manifestTable = manifest.tables.find((candidate) => candidate.name === scope.table);
+    if (!manifestTable) continue;
+    allowedFields[scope.table] = scope.allowedFields ?? manifestTable.fields.map((field) => field.name);
+    if (type === "view" && scope.recordIds?.length)
+      recordIds[scope.table] = scope.recordIds.join(", ");
+    for (const ref of refFieldsForTable(manifestTable)) {
+      const key = `${scope.table}:${ref.field}`;
+      if (!allowedFields[scope.table].includes(ref.field)) {
+        refChoices[key] = "hide";
+        continue;
+      }
+      const access = scopes.find((candidate) => candidate.table === ref.targetTable)?.formAccess;
+      refChoices[key] = access?.createReferences ? "create" : "pick";
+    }
+  }
+  const ops = type === "propose" && primaryScopes[0] ? { ...primaryScopes[0].ops } : { insert: true, update: true, delete: false };
+  return { tables, allowedFields, recordIds, refChoices, ops };
+}
+function buildShareWizardInput(args) {
+  const { type, manifest, tables, allowedFields, recordIds, refChoices, ops } = args;
+  const selectedTables = tables.flatMap((name) => {
+    const table = manifest.tables.find((candidate) => candidate.name === name);
+    return table ? [table] : [];
+  });
+  const references = /* @__PURE__ */ new Map();
+  const wizardTables = selectedTables.map((table) => {
+    let fields = allowedFields[table.name] ?? table.fields.map((field) => field.name);
+    if (type === "form" || type === "propose") {
+      for (const ref of refFieldsForTable(table)) {
+        const choice = refChoices[`${table.name}:${ref.field}`] ?? "pick";
+        if (choice === "hide") fields = fields.filter((field) => field !== ref.field);
+        else if (fields.includes(ref.field)) {
+          const current = references.get(ref.targetTable) ?? {
+            searchReferences: false,
+            createReferences: false
+          };
+          references.set(ref.targetTable, {
+            searchReferences: current.searchReferences || choice === "pick",
+            createReferences: current.createReferences || choice === "create"
+          });
+        }
+      }
+    }
+    const ids = recordIds[table.name]?.split(",").map((id) => id.trim()).filter(Boolean);
+    const usesAllowlist = type === "form" || type === "propose" && fields.length < table.fields.length;
+    return {
+      table: table.name,
+      allowedFields: usesAllowlist ? fields : void 0,
+      recordIds: type === "view" && ids?.length ? [...new Set(ids)] : void 0
+    };
+  });
+  return {
+    tables: wizardTables,
+    ops: type === "propose" ? ops : void 0,
+    references: type === "form" || type === "propose" ? [...references].map(([table, access]) => ({ table, ...access })) : void 0
+  };
+}
+
+export { buildShareWizardInput, isPrimaryShareScope, scopesToWizardInput, shareTypeDefaultScopes };
+//# sourceMappingURL=shareWizard.js.map
+//# sourceMappingURL=shareWizard.js.map