@columnus/api-cli 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/cli.js +178 -36
  2. package/package.json +1 -1
package/dist/cli.js CHANGED
@@ -22750,6 +22750,9 @@ function date4(params) {
22750
22750
  return _coercedDate(ZodDate, params);
22751
22751
  }
22752
22752
 
22753
+ // ../shared/src/queryTypes.ts
22754
+ import { ConvexError } from "convex/values";
22755
+
22753
22756
  // ../shared/src/fieldValueShape.ts
22754
22757
  function enumOptions(type) {
22755
22758
  if (type.kind !== "union") return null;
@@ -22819,7 +22822,10 @@ var PREDICATE_VARIANTS = [
22819
22822
  { value: "between", ops: [{ op: "between", label: "between" }] },
22820
22823
  {
22821
22824
  value: "unknownArray",
22822
- ops: [{ op: "containsAll", label: "contains all" }]
22825
+ ops: [
22826
+ { op: "containsAll", label: "contains all" },
22827
+ { op: "containsAny", label: "contains any" }
22828
+ ]
22823
22829
  },
22824
22830
  {
22825
22831
  value: "none",
@@ -22835,21 +22841,6 @@ var PREDICATE_OPS = PREDICATE_VARIANTS.flatMap(
22835
22841
  var PREDICATE_OP_LABELS = new Map(
22836
22842
  PREDICATE_VARIANTS.flatMap((variant) => variant.ops.map(({ op, label }) => [op, label]))
22837
22843
  );
22838
- var FREEFORM_COLUMN_FILTER_OPS = {
22839
- text: ["eq", "neq", "in"],
22840
- number: ["eq", "between"],
22841
- date: ["between"]
22842
- };
22843
- var COLUMN_FILTER_EDITOR_OPS = {
22844
- enumChecklist: ["in"],
22845
- idChecklist: ["in"],
22846
- idListChecklist: ["containsAll"],
22847
- boolean: ["eq"],
22848
- text: FREEFORM_COLUMN_FILTER_OPS.text,
22849
- number: FREEFORM_COLUMN_FILTER_OPS.number,
22850
- date: FREEFORM_COLUMN_FILTER_OPS.date,
22851
- none: []
22852
- };
22853
22844
 
22854
22845
  // ../shared/src/queryTypes.ts
22855
22846
  var listAccessKindSchema = external_exports.enum(["table", "index", "search", "idList"]);
@@ -22883,6 +22874,30 @@ var predicateSchema = external_exports.discriminatedUnion(
22883
22874
  (predicate) => Object.hasOwn(predicate, "value"),
22884
22875
  "Predicate value is required"
22885
22876
  );
22877
+ var MAX_GROUP_DEPTH = 3;
22878
+ var groupedPredicateSchema = predicateSchema.refine(
22879
+ (p) => !((p.op === "containsAll" || p.op === "containsAny") && p.value.length === 0),
22880
+ "A list inside a group needs at least one value"
22881
+ );
22882
+ var tooDeepSchema = external_exports.never({ error: `Groups nest at most ${MAX_GROUP_DEPTH} levels` });
22883
+ function conditionAt(levels) {
22884
+ const predicate = levels === MAX_GROUP_DEPTH ? predicateSchema : groupedPredicateSchema;
22885
+ const group = levels === 0 ? tooDeepSchema : groupSchema(levels);
22886
+ const union2 = external_exports.union(levels === 0 ? [predicate] : [predicate, group]);
22887
+ return dispatchByShape(
22888
+ union2,
22889
+ (value) => typeof value === "object" && value !== null && (Object.hasOwn(value, "or") || Object.hasOwn(value, "and")) ? group : predicate
22890
+ );
22891
+ }
22892
+ function dispatchByShape(union2, pick2) {
22893
+ union2._zod.run = union2._zod.parse = (payload, ctx) => pick2(payload.value)._zod.run(payload, ctx);
22894
+ return union2;
22895
+ }
22896
+ function groupSchema(levels) {
22897
+ const children = external_exports.array(conditionAt(levels - 1)).min(1, "A group needs at least one condition");
22898
+ return external_exports.partialRecord(external_exports.enum(["or", "and"]), children).refine((group) => Object.keys(group).length === 1, 'A group takes "or" or "and", not both').meta({ minProperties: 1, maxProperties: 1 });
22899
+ }
22900
+ var conditionSchema = conditionAt(MAX_GROUP_DEPTH);
22886
22901
  var queryOrderSchema = external_exports.object({
22887
22902
  field: external_exports.string().min(1),
22888
22903
  direction: external_exports.enum(["asc", "desc"])
@@ -22892,7 +22907,7 @@ var querySearchSchema = external_exports.object({
22892
22907
  query: external_exports.string()
22893
22908
  });
22894
22909
  var querySchema = external_exports.object({
22895
- predicates: external_exports.array(predicateSchema).optional(),
22910
+ predicates: external_exports.array(conditionSchema).optional(),
22896
22911
  order: queryOrderSchema.optional(),
22897
22912
  search: querySearchSchema.optional(),
22898
22913
  /** Reserved — rejected by the planner until vector indexes exist in the manifest. */
@@ -22901,7 +22916,7 @@ var querySchema = external_exports.object({
22901
22916
  indexHint: external_exports.string().min(1).optional()
22902
22917
  });
22903
22918
  var clampQuerySchema = external_exports.object({
22904
- predicates: external_exports.array(predicateSchema).optional(),
22919
+ predicates: external_exports.array(conditionSchema).optional(),
22905
22920
  order: queryOrderSchema.optional(),
22906
22921
  search: querySearchSchema.optional()
22907
22922
  });
@@ -23046,6 +23061,7 @@ function isProtectedTransferTable(table) {
23046
23061
  // ../shared/src/bffProtocol.ts
23047
23062
  var COLUMNUS_BFF_PROTOCOL_VERSION = 1;
23048
23063
  var COLUMNUS_BFF_API_PREFIX = "/api/columnus/v1";
23064
+ var READ_MODEL_API_PREFIX = `${COLUMNUS_BFF_API_PREFIX}/read-model`;
23049
23065
  var OPERATION_ID_RE = /^[A-Za-z0-9_-]{16,128}$/;
23050
23066
  var TRANSFER_ID_RE = /^[A-Za-z0-9_-]{16,64}$/;
23051
23067
  var MANIFEST_HASH_RE = /^[0-9a-f]{64}$/;
@@ -23317,6 +23333,9 @@ var MCP_ENDPOINT_PATH_PREFIX = `${COLUMNUS_BFF_API_PREFIX}/mcp/`;
23317
23333
  var MCP_OAUTH_PATH_PREFIX = `${COLUMNUS_BFF_API_PREFIX}/oauth`;
23318
23334
 
23319
23335
  // ../shared/src/queryPlan.ts
23336
+ import { compareValues as compareValues2 } from "convex/values";
23337
+
23338
+ // ../shared/src/queryBetween.ts
23320
23339
  import { compareValues } from "convex/values";
23321
23340
 
23322
23341
  // ../shared/src/richDoc.ts
@@ -23342,6 +23361,29 @@ var EMPTY_RICH_DOC = JSON.stringify({
23342
23361
  blocks: [emptyParagraphBlock()]
23343
23362
  });
23344
23363
 
23364
+ // ../shared/src/rowTrash.ts
23365
+ import { ConvexError as ConvexError2 } from "convex/values";
23366
+ var TRASH_DELETED_AT_FIELD = "columnusDeletedAt";
23367
+ var TRASH_DELETED_BY_FIELD = "columnusDeletedBy";
23368
+ var TRASH_FIELD_NAMES = [
23369
+ TRASH_DELETED_AT_FIELD,
23370
+ TRASH_DELETED_BY_FIELD
23371
+ ];
23372
+ var TRASH_INDEX_NAME = "by_columnusDeletedAt";
23373
+ var TRASH_RETENTION_DAYS = 30;
23374
+ var TRASH_RETENTION_MS = TRASH_RETENTION_DAYS * 24 * 60 * 60 * 1e3;
23375
+ function withTrashFields(table) {
23376
+ return {
23377
+ ...table,
23378
+ fields: [
23379
+ ...table.fields,
23380
+ { name: TRASH_DELETED_AT_FIELD, type: { kind: "number" }, optional: true },
23381
+ { name: TRASH_DELETED_BY_FIELD, type: { kind: "string" }, optional: true }
23382
+ ],
23383
+ indexes: [...table.indexes, { name: TRASH_INDEX_NAME, fields: [TRASH_DELETED_AT_FIELD] }]
23384
+ };
23385
+ }
23386
+
23345
23387
  // ../shared/src/schemaTypes.ts
23346
23388
  var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
23347
23389
  var RESERVED_TABLE_NAMES = /* @__PURE__ */ new Set([
@@ -23524,8 +23566,24 @@ var manifestSchema = external_exports.object({
23524
23566
  });
23525
23567
  }
23526
23568
  fieldNames.add(f.name);
23569
+ if (TRASH_FIELD_NAMES.includes(f.name)) {
23570
+ ctx.addIssue({
23571
+ code: external_exports.ZodIssueCode.custom,
23572
+ message: `${t.name}.${f.name}: field name is reserved for row trash`,
23573
+ path: ["tables"]
23574
+ });
23575
+ }
23527
23576
  assertAssetBindingAllowed(ctx, t, f);
23528
23577
  }
23578
+ for (const idx of [...t.indexes, ...t.searchIndexes]) {
23579
+ if (idx.name === TRASH_INDEX_NAME) {
23580
+ ctx.addIssue({
23581
+ code: external_exports.ZodIssueCode.custom,
23582
+ message: `${t.name}.${idx.name}: index name is reserved for row trash`,
23583
+ path: ["tables"]
23584
+ });
23585
+ }
23586
+ }
23529
23587
  }
23530
23588
  for (const t of manifest.tables) {
23531
23589
  for (const f of t.fields) {
@@ -23829,24 +23887,26 @@ ${schemaBody}});
23829
23887
  `;
23830
23888
  }
23831
23889
  function renderTable(t) {
23832
- const fields = isAssetTable(t) ? [
23833
- ...t.fields,
23834
- {
23835
- name: "assetId",
23836
- type: { kind: "id", table: ASSETS_TABLE_NAME },
23837
- optional: false
23838
- }
23839
- ] : t.fields;
23840
- const fieldsBlock = fields.length ? `{
23841
- ${fields.map((f) => {
23890
+ const { fields, indexes, searchIndexes } = isAssetTable(t) ? {
23891
+ fields: [
23892
+ ...t.fields,
23893
+ {
23894
+ name: "assetId",
23895
+ type: { kind: "id", table: ASSETS_TABLE_NAME },
23896
+ optional: false
23897
+ }
23898
+ ],
23899
+ indexes: [{ name: "by_assetId", fields: ["assetId"] }],
23900
+ searchIndexes: []
23901
+ } : withTrashFields(t);
23902
+ const fieldsBlock = fields.map((f) => {
23842
23903
  const inner = renderType(f.type);
23843
23904
  const value = f.optional ? `v.optional(${inner})` : inner;
23844
23905
  return ` ${f.name}: ${value},`;
23845
- }).join("\n")}
23846
- }` : `{}`;
23847
- let out = `defineTable(${fieldsBlock})`;
23848
- const indexes = isAssetTable(t) ? [{ name: "by_assetId", fields: ["assetId"] }] : t.indexes;
23849
- const searchIndexes = isAssetTable(t) ? [] : t.searchIndexes;
23906
+ }).join("\n");
23907
+ let out = `defineTable({
23908
+ ${fieldsBlock}
23909
+ })`;
23850
23910
  const inlineSingleIndex = indexes.length === 1 && searchIndexes.length === 0;
23851
23911
  for (const idx of indexes) {
23852
23912
  const cols = idx.fields.map((c) => JSON.stringify(c)).join(", ");
@@ -23970,6 +24030,10 @@ function emitQueryTs(banner) {
23970
24030
  const value = variant.value === "unknownArray" ? "unknown[]" : variant.value === "between" ? "{ min: unknown; max: unknown }" : variant.value === "none" ? "null" : "unknown";
23971
24031
  return ` | { field: string; op: ${quotedUnion(variant.ops.map(({ op }) => op))}; value: ${value} }`;
23972
24032
  }).join("\n");
24033
+ let condition = "Predicate";
24034
+ for (let level = 0; level < MAX_GROUP_DEPTH; level++) {
24035
+ condition = `Predicate | Group<${condition}>`;
24036
+ }
23973
24037
  return `${banner}export type PredicateOp =
23974
24038
  ${multilineUnion(PREDICATE_OPS)};
23975
24039
 
@@ -23980,8 +24044,14 @@ export type QueryOrder = { field: string; direction: "asc" | "desc" };
23980
24044
 
23981
24045
  export type QuerySearch = { index: string; query: string };
23982
24046
 
24047
+ type Group<C> = { or: C[] } | { and: C[] };
24048
+
24049
+ /** A predicate, or an \`or\`/\`and\` group of conditions, up to ${MAX_GROUP_DEPTH} group levels deep. */
24050
+ export type Condition = ${condition};
24051
+
23983
24052
  export type Query = {
23984
- predicates?: Predicate[];
24053
+ /** ANDed. */
24054
+ predicates?: Condition[];
23985
24055
  order?: QueryOrder;
23986
24056
  search?: QuerySearch;
23987
24057
  maxScan?: number;
@@ -24647,8 +24717,43 @@ var DEFAULT_MEDIA_REJECT_BYTES = 100 * 1024 * 1024 * 1024;
24647
24717
  // ../shared/src/csv.ts
24648
24718
  var import_papaparse = __toESM(require_papaparse(), 1);
24649
24719
 
24720
+ // ../shared/src/gridQuery.ts
24721
+ var GROUP_BUCKETS = ["day", "week", "month", "quarter", "year"];
24722
+ var MAX_GRID_KEYS = 3;
24723
+ var gridGroupBySchema = external_exports.object({
24724
+ field: external_exports.string().min(1),
24725
+ direction: external_exports.enum(["asc", "desc"]).optional(),
24726
+ /** Date and date-time fields only; buckets start in the request's timezone. */
24727
+ bucket: external_exports.enum(GROUP_BUCKETS).optional()
24728
+ });
24729
+ var gridQuerySchema = querySchema.extend({
24730
+ order: external_exports.union([queryOrderSchema, external_exports.array(queryOrderSchema).max(MAX_GRID_KEYS)]).optional(),
24731
+ groupBy: external_exports.array(gridGroupBySchema).max(MAX_GRID_KEYS).optional()
24732
+ });
24733
+
24650
24734
  // ../shared/src/queryValidators.ts
24651
24735
  import { v as v2 } from "convex/values";
24736
+
24737
+ // ../shared/src/readModelLimits.ts
24738
+ var FACET_LIMITS = {
24739
+ perRequest: 12,
24740
+ page: 10,
24741
+ more: 50,
24742
+ searchMax: 50,
24743
+ suggestFields: 8,
24744
+ suggestPerField: 3
24745
+ };
24746
+
24747
+ // ../shared/src/facets.ts
24748
+ var FACET_SORTS = ["count", "label", "options"];
24749
+ var facetSpecSchema = external_exports.object({
24750
+ field: external_exports.string().min(1),
24751
+ bucket: external_exports.enum(GROUP_BUCKETS).optional(),
24752
+ sort: external_exports.enum(FACET_SORTS).optional()
24753
+ });
24754
+ var facetListSchema = external_exports.array(facetSpecSchema).max(FACET_LIMITS.perRequest);
24755
+
24756
+ // ../shared/src/queryValidators.ts
24652
24757
  var predicateValidators = PREDICATE_VARIANTS.flatMap(
24653
24758
  (variant) => variant.ops.map(
24654
24759
  ({ op }) => v2.object({
@@ -24661,6 +24766,16 @@ var predicateValidators = PREDICATE_VARIANTS.flatMap(
24661
24766
  var predicateValidator = v2.union(
24662
24767
  ...predicateValidators
24663
24768
  );
24769
+ function conditionValidator(levels) {
24770
+ if (levels === 0) return predicateValidator;
24771
+ const children = v2.array(conditionValidator(levels - 1));
24772
+ return v2.union(
24773
+ ...predicateValidator.members,
24774
+ v2.object({ or: children }),
24775
+ v2.object({ and: children })
24776
+ );
24777
+ }
24778
+ var conditionsValidator = v2.array(conditionValidator(MAX_GROUP_DEPTH));
24664
24779
  var queryOrderValidator = v2.object({
24665
24780
  field: v2.string(),
24666
24781
  direction: v2.union(v2.literal("asc"), v2.literal("desc"))
@@ -24670,15 +24785,39 @@ var querySearchValidator = v2.object({
24670
24785
  query: v2.string()
24671
24786
  });
24672
24787
  var queryValidator = v2.object({
24673
- predicates: v2.optional(v2.array(predicateValidator)),
24788
+ predicates: v2.optional(conditionsValidator),
24674
24789
  order: v2.optional(queryOrderValidator),
24675
24790
  search: v2.optional(querySearchValidator),
24676
24791
  maxScan: v2.optional(v2.number()),
24677
24792
  indexHint: v2.optional(v2.string()),
24678
24793
  vector: v2.optional(v2.any())
24679
24794
  });
24795
+ function literals(values) {
24796
+ return v2.union(
24797
+ ...values.map((value) => v2.literal(value))
24798
+ );
24799
+ }
24800
+ var groupBucketValidator = literals(GROUP_BUCKETS);
24801
+ var gridQueryValidator = v2.object({
24802
+ ...queryValidator.fields,
24803
+ order: v2.optional(v2.union(queryOrderValidator, v2.array(queryOrderValidator))),
24804
+ groupBy: v2.optional(
24805
+ v2.array(
24806
+ v2.object({
24807
+ field: v2.string(),
24808
+ direction: v2.optional(v2.union(v2.literal("asc"), v2.literal("desc"))),
24809
+ bucket: v2.optional(groupBucketValidator)
24810
+ })
24811
+ )
24812
+ )
24813
+ });
24814
+ var facetSpecValidator = v2.object({
24815
+ field: v2.string(),
24816
+ bucket: v2.optional(groupBucketValidator),
24817
+ sort: v2.optional(literals(FACET_SORTS))
24818
+ });
24680
24819
  var clampQueryValidator = v2.object({
24681
- predicates: v2.optional(v2.array(predicateValidator)),
24820
+ predicates: v2.optional(conditionsValidator),
24682
24821
  order: v2.optional(queryOrderValidator),
24683
24822
  search: v2.optional(querySearchValidator)
24684
24823
  });
@@ -24741,6 +24880,9 @@ var stagedApiAccessValidator = v3.array(
24741
24880
  })
24742
24881
  );
24743
24882
 
24883
+ // ../shared/src/failureMessage.ts
24884
+ import { ConvexError as ConvexError3 } from "convex/values";
24885
+
24744
24886
  // ../shared/src/refsRecompute.ts
24745
24887
  var REFS_RECOMPUTE_STALE_MS = 10 * 60 * 1e3;
24746
24888
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@columnus/api-cli",
3
- "version": "0.2.2",
3
+ "version": "0.2.4",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "columnus-api pull and dev — live-sync read API codegen for Columnus consumer apps",