@columnus/shared 0.1.47

package/dist/queryValidators.d.ts

@@ -0,0 +1,99 @@
+import { type GenericValidator } from "convex/values";
+export declare const predicateValidator: import("convex/values").VUnion<any, [GenericValidator, GenericValidator, ...GenericValidator[]], "required", any>;
+/** Canonical Convex validator for caller-supplied Query values. */
+export declare const queryValidator: import("convex/values").VObject<{
+    predicates?: any[] | undefined;
+    order?: {
+        field: string;
+        direction: "asc" | "desc";
+    } | undefined;
+    search?: {
+        index: string;
+        query: string;
+    } | undefined;
+    vector?: any;
+    maxScan?: number | undefined;
+    indexHint?: string | undefined;
+}, {
+    predicates: import("convex/values").VArray<any[] | undefined, import("convex/values").VUnion<any, [GenericValidator, GenericValidator, ...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">;
+    maxScan: import("convex/values").VFloat64<number | undefined, "optional">;
+    indexHint: import("convex/values").VString<string | undefined, "optional">;
+    vector: import("convex/values").VAny<any, "optional", string>;
+}, "required", "predicates" | "order" | "search" | "vector" | "maxScan" | "indexHint" | "order.field" | "order.direction" | "search.index" | "search.query" | `vector.${string}`>;
+/** Convex validator for profile/share clamp Query (predicates + optional defaults). */
+export declare const clampQueryValidator: import("convex/values").VObject<{
+    predicates?: any[] | undefined;
+    order?: {
+        field: string;
+        direction: "asc" | "desc";
+    } | undefined;
+    search?: {
+        index: string;
+        query: string;
+    } | undefined;
+}, {
+    predicates: import("convex/values").VArray<any[] | undefined, import("convex/values").VUnion<any, [GenericValidator, GenericValidator, ...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">;
+}, "required", "predicates" | "order" | "search" | "order.field" | "order.direction" | "search.index" | "search.query">;
+/** Optional Query arg for list endpoints (`query?`). */
+export declare const queryArgValidator: import("convex/values").VObject<{
+    predicates?: any[] | undefined;
+    order?: {
+        field: string;
+        direction: "asc" | "desc";
+    } | undefined;
+    search?: {
+        index: string;
+        query: string;
+    } | undefined;
+    vector?: any;
+    maxScan?: number | undefined;
+    indexHint?: string | undefined;
+} | undefined, {
+    predicates: import("convex/values").VArray<any[] | undefined, import("convex/values").VUnion<any, [GenericValidator, GenericValidator, ...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">;
+    maxScan: import("convex/values").VFloat64<number | undefined, "optional">;
+    indexHint: import("convex/values").VString<string | undefined, "optional">;
+    vector: import("convex/values").VAny<any, "optional", string>;
+}, "optional", "predicates" | "order" | "search" | "vector" | "maxScan" | "indexHint" | "order.field" | "order.direction" | "search.index" | "search.query" | `vector.${string}`>;
+export declare const maxScanLimitValidator: import("convex/values").VFloat64<number | undefined, "optional">;

package/dist/queryValidators.js

@@ -0,0 +1,76 @@
+import { v } from 'convex/values';
+
+// packages/@columnus/shared/src/queryValidators.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)
+});
+var queryArgValidator = v.optional(queryValidator);
+var maxScanLimitValidator = v.optional(v.number());
+
+export { clampQueryValidator, maxScanLimitValidator, predicateValidator, queryArgValidator, queryValidator };
+//# sourceMappingURL=queryValidators.js.map
+//# sourceMappingURL=queryValidators.js.map

package/dist/queryValidators.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queryFieldOps.ts","../src/queryValidators.ts"],"names":[],"mappings":"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","file":"queryValidators.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"]}

package/dist/readApiQuery.d.ts

@@ -0,0 +1,10 @@
+export type ReadApiQueryKind = "list" | "get";
+/** Deploy-generated export name (`listProducts`, `getProducts`, …). */
+export declare function readApiQueryExportName(kind: ReadApiQueryKind, tableName: string): string;
+export type ProposeApiOp = "insert" | "update" | "delete";
+/** Deploy-generated propose export name (`proposeInsertProducts`, …). */
+export declare function proposeApiExportName(op: ProposeApiOp, tableName: string): string;
+/** Convex module folder under `columnus/read/{segment}/`. */
+export declare function readApiQueryModuleSegment(profileSlug: string): string;
+/** `anyApi` path emitted by `columnus-api pull` / read-api-refs codegen. */
+export declare function readApiAnyApiPath(profileSlug: string, kind: ReadApiQueryKind, tableName: string): string;

package/dist/readApiQuery.js

@@ -0,0 +1,24 @@
+// packages/@columnus/shared/src/apiProfileSlug.ts
+function apiProfileSlugToConvexModuleSegment(slug) {
+  return slug.replace(/-/g, "_");
+}
+
+// packages/@columnus/shared/src/readApiQuery.ts
+function readApiQueryExportName(kind, tableName) {
+  return `${kind}${tableName}`;
+}
+function proposeApiExportName(op, tableName) {
+  return `propose${op[0].toUpperCase()}${op.slice(1)}${tableName}`;
+}
+function readApiQueryModuleSegment(profileSlug) {
+  return apiProfileSlugToConvexModuleSegment(profileSlug);
+}
+function readApiAnyApiPath(profileSlug, kind, tableName) {
+  const segment = readApiQueryModuleSegment(profileSlug);
+  const exportName = readApiQueryExportName(kind, tableName);
+  return `anyApi.columnus.read.${segment}.${exportName}.${exportName}`;
+}
+
+export { proposeApiExportName, readApiAnyApiPath, readApiQueryExportName, readApiQueryModuleSegment };
+//# sourceMappingURL=readApiQuery.js.map
+//# sourceMappingURL=readApiQuery.js.map

package/dist/readApiQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/apiProfileSlug.ts","../src/readApiQuery.ts"],"names":[],"mappings":";AAkDO,SAAS,oCAAoC,IAAA,EAAsB;AACxE,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAA;AAC/B;;;AC/CO,SAAS,sBAAA,CAAuB,MAAwB,SAAA,EAA2B;AACxF,EAAA,OAAO,CAAA,EAAG,IAAI,CAAA,EAAG,SAAS,CAAA,CAAA;AAC5B;AAKO,SAAS,oBAAA,CAAqB,IAAkB,SAAA,EAA2B;AAChF,EAAA,OAAO,CAAA,OAAA,EAAU,EAAA,CAAG,CAAC,CAAA,CAAG,WAAA,EAAa,CAAA,EAAG,EAAA,CAAG,KAAA,CAAM,CAAC,CAAC,CAAA,EAAG,SAAS,CAAA,CAAA;AACjE;AAGO,SAAS,0BAA0B,WAAA,EAA6B;AACrE,EAAA,OAAO,oCAAoC,WAAW,CAAA;AACxD;AAGO,SAAS,iBAAA,CACd,WAAA,EACA,IAAA,EACA,SAAA,EACQ;AACR,EAAA,MAAM,OAAA,GAAU,0BAA0B,WAAW,CAAA;AACrD,EAAA,MAAM,UAAA,GAAa,sBAAA,CAAuB,IAAA,EAAM,SAAS,CAAA;AACzD,EAAA,OAAO,CAAA,qBAAA,EAAwB,OAAO,CAAA,CAAA,EAAI,UAAU,IAAI,UAAU,CAAA,CAAA;AACpE","file":"readApiQuery.js","sourcesContent":["/** URL-safe profile slug for `api.columnus.read.{slug}.*` (plan 004). */\nexport const API_PROFILE_SLUG_RE = /^[a-z][a-z0-9-]{0,47}$/;\n\nexport function isApiProfileSlug(slug: string): boolean {\n  return API_PROFILE_SLUG_RE.test(slug);\n}\n\n/** Derive a slug from a human display name. */\nexport function slugifyApiProfileName(name: string): string {\n  const lowered = name.trim().toLowerCase();\n  const hyphenated = lowered\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .replace(/-+/g, \"-\");\n  let slug = hyphenated.slice(0, 48);\n  if (!slug) slug = \"profile\";\n  if (!/^[a-z]/.test(slug)) slug = `p-${slug}`.slice(0, 48);\n  return slug.slice(0, 48);\n}\n\nexport function assertApiProfileSlug(slug: string): void {\n  if (!isApiProfileSlug(slug)) {\n    throw new Error(\n      \"Profile slug must start with a letter and contain only lowercase letters, numbers, and hyphens (max 48 characters).\",\n    );\n  }\n}\n\n/** Reject profile slug edits after create (plan 006 D13). */\nexport function profileSlugChangeError(\n  existingSlug: string,\n  nextSlug: string | undefined,\n): string | undefined {\n  if (nextSlug === undefined) return undefined;\n  const trimmed = nextSlug.trim();\n  if (trimmed && trimmed !== existingSlug) {\n    return \"Profile slug cannot be changed after creation\";\n  }\n  return undefined;\n}\n\nexport function assertProfileSlugUnchanged(\n  existingSlug: string,\n  nextSlug: string | undefined,\n): void {\n  const message = profileSlugChangeError(existingSlug, nextSlug);\n  if (message) throw new Error(message);\n}\n\n/** Convex module path segment (`columnus/read/{segment}/…`). Hyphens are invalid in paths. */\nexport function apiProfileSlugToConvexModuleSegment(slug: string): string {\n  return slug.replace(/-/g, \"_\");\n}\n","import { apiProfileSlugToConvexModuleSegment } from \"./apiProfileSlug.ts\";\n\nexport type ReadApiQueryKind = \"list\" | \"get\";\n\n/** Deploy-generated export name (`listProducts`, `getProducts`, …). */\nexport function readApiQueryExportName(kind: ReadApiQueryKind, tableName: string): string {\n  return `${kind}${tableName}`;\n}\n\nexport type ProposeApiOp = \"insert\" | \"update\" | \"delete\";\n\n/** Deploy-generated propose export name (`proposeInsertProducts`, …). */\nexport function proposeApiExportName(op: ProposeApiOp, tableName: string): string {\n  return `propose${op[0]!.toUpperCase()}${op.slice(1)}${tableName}`;\n}\n\n/** Convex module folder under `columnus/read/{segment}/`. */\nexport function readApiQueryModuleSegment(profileSlug: string): string {\n  return apiProfileSlugToConvexModuleSegment(profileSlug);\n}\n\n/** `anyApi` path emitted by `columnus-api pull` / read-api-refs codegen. */\nexport function readApiAnyApiPath(\n  profileSlug: string,\n  kind: ReadApiQueryKind,\n  tableName: string,\n): string {\n  const segment = readApiQueryModuleSegment(profileSlug);\n  const exportName = readApiQueryExportName(kind, tableName);\n  return `anyApi.columnus.read.${segment}.${exportName}.${exportName}`;\n}\n"]}

package/dist/recordTableColumns.d.ts

@@ -0,0 +1,21 @@
+import { type Field, type Table } from "./schemaTypes.ts";
+import type { Query } from "./queryTypes.ts";
+export type RecordTableDisplayValueMap = Map<string, {
+    id?: string;
+    preview?: string;
+}>;
+export declare const RECORD_TABLE_DEFAULT_FIELD_COUNT = 5;
+export declare function defaultRecordTableFieldNames(table: Table): string[];
+/** Field names referenced by Query predicates (for locking embed columns). */
+export declare function queryPredicateFieldNames(query: Query | null): string[];
+export declare function parseRecordTableFieldsJson(fieldsJson: string): string[];
+export declare function stringifyRecordTableFields(fields: string[]): string;
+/** Discretionary field names stored on the block (empty → first five defaults). */
+export declare function discretionaryRecordTableFieldNames(table: Table, fieldsJson: string): string[];
+/** Manifest-ordered data columns: discretionary ∪ query predicate fields (deduped). `_id` is separate. */
+export declare function resolveRecordTableVisibleFields(table: Table, fieldsJson: string, query: Query | null): Field[];
+export declare function collectQueryRefIds(table: Table, query: Query | null): Map<string, Set<string>>;
+/** @deprecated Prefer {@link collectQueryRefIds}. */
+export declare function collectFilterRefIds(table: Table, query: Query | null): Map<string, Set<string>>;
+export declare function formatFilterEqDisplayValue(field: Field | undefined, value: unknown, displayByTable: Map<string, RecordTableDisplayValueMap>): string;
+export declare function formatRecordTableQuerySummary(table: Table, query: Query | null, displayByTable: Map<string, RecordTableDisplayValueMap>): string;