@xano/sdk 1.0.0

package/dist/chunk-I4F5TCJH.js

@@ -0,0 +1,130 @@
+import {
+  contextFlags
+} from "./chunk-NAQDMEHV.js";
+import {
+  backendDirFor,
+  backendDirIn
+} from "./chunk-5A2PLKZB.js";
+import {
+  projectRootFrom
+} from "./chunk-ROY4YAEQ.js";
+import {
+  atomicWrite
+} from "./chunk-LLNZGEFK.js";
+import {
+  LocalFileNotFoundError,
+  displayPath,
+  relForwardSlash
+} from "./chunk-PTHVMXZI.js";
+import {
+  normalizeDocumentationScopeKey
+} from "./chunk-3JDU4VRL.js";
+import {
+  shellQuote
+} from "./chunk-5ZSO4T2G.js";
+
+// src/emit/secrets-file.ts
+import { randomBytes } from "crypto";
+import { existsSync, readFileSync, realpathSync } from "fs";
+import { dirname, join, resolve } from "path";
+var SECRETS_FILE_VERSION = 1;
+var DOCUMENTATION_TOKEN_BYTES = 20;
+function generateDocumentationToken() {
+  return randomBytes(DOCUMENTATION_TOKEN_BYTES).toString("base64url");
+}
+function workspaceSecretsPathIn(cwd) {
+  return join(backendDirIn(projectRootFrom(cwd)), ".secrets.json");
+}
+function defaultWorkspaceSecretsPath(file) {
+  return join(backendDirFor(file), ".secrets.json");
+}
+function renderSecretsFile(file) {
+  return JSON.stringify(file, null, 2) + "\n";
+}
+function writeSecretsFile(path, file) {
+  atomicWrite(path, renderSecretsFile(file), { mode: 384 });
+}
+function entryWordFor(path) {
+  const entry = join(dirname(resolve(path)), "index.ts");
+  return existsSync(entry) ? entryWordOf(entry) : "";
+}
+function entryWordOf(entry) {
+  const real = (p) => {
+    try {
+      return realpathSync(p);
+    } catch {
+      return p;
+    }
+  };
+  const cwd = real(process.cwd());
+  const target = real(resolve(entry));
+  if (real(join(backendDirIn(cwd), "index.ts")) === target) return "";
+  const rel = relForwardSlash(cwd, target);
+  return ` ${shellQuote(rel === "" ? target : `./${rel}`)}`;
+}
+function readSecretsFile(path, label) {
+  const where = displayPath(path);
+  if (!existsSync(path)) {
+    if (label === void 0) return void 0;
+    throw new LocalFileNotFoundError(
+      `${label}: could not read ${where}. Check the path, and make sure the file is present wherever this runs (a CI secret mounted at deploy time, not a file committed to the repo).`
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    throw new Error(
+      `${where} is not valid JSON. It is written by \`xanosdk pull\` and is not meant to be hand-edited \u2014 delete it and pull again to rebuild it.`
+    );
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`${where} must be a JSON object. Delete it and pull again to rebuild it.`);
+  }
+  const record = parsed;
+  if (record.version !== SECRETS_FILE_VERSION) {
+    const what = record.version === void 0 ? `${where} has no \`version\` field, so it is not a file this SDK wrote` : `${where} is version ${JSON.stringify(record.version)}, and this SDK reads version ${SECRETS_FILE_VERSION}`;
+    throw new Error(
+      `${what}. Delete it, then run \`xanosdk secrets fill${entryWordFor(path)}\` to mint the tokens your source's gates declare, or \`xanosdk pull${contextFlags()}\` to store the target's existing ones.`
+    );
+  }
+  const tokens = record.documentationTokens;
+  if (tokens === void 0 || tokens === null || typeof tokens !== "object" || Array.isArray(tokens)) {
+    throw new Error(
+      `${where} has no \`documentationTokens\` object. Delete it and pull again to rebuild it.`
+    );
+  }
+  const out = /* @__PURE__ */ Object.create(null);
+  for (const [key, entry] of Object.entries(tokens)) {
+    if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
+      throw new Error(
+        `${where}: the entry for ${JSON.stringify(key)} is not an object. Delete the file and pull again to rebuild it.`
+      );
+    }
+    const { value, label: label2 } = entry;
+    if (typeof value !== "string") {
+      throw new Error(
+        `${where}: the entry for ${JSON.stringify(key)} has no string \`value\`. Delete the file and pull again to rebuild it.`
+      );
+    }
+    out[normalizeDocumentationScopeKey(key)] = { value, label: typeof label2 === "string" && label2 !== "" ? label2 : key };
+  }
+  const provenance = record.pulledFrom;
+  return {
+    version: SECRETS_FILE_VERSION,
+    pulledFrom: provenance !== null && typeof provenance === "object" && !Array.isArray(provenance) ? provenance : { instance: "(unrecorded)", at: "(unrecorded)" },
+    documentationTokens: out
+  };
+}
+
+export {
+  SECRETS_FILE_VERSION,
+  generateDocumentationToken,
+  workspaceSecretsPathIn,
+  defaultWorkspaceSecretsPath,
+  renderSecretsFile,
+  writeSecretsFile,
+  entryWordOf,
+  readSecretsFile
+};
+//# sourceMappingURL=chunk-I4F5TCJH.js.map

package/dist/chunk-IDOTCMDV.js

@@ -0,0 +1,57 @@
+import {
+  questionOrCancel
+} from "./chunk-65HWOMGV.js";
+import {
+  style,
+  terminalText
+} from "./chunk-PTHVMXZI.js";
+
+// src/emit/plugin-prompt.ts
+import { createInterface } from "readline/promises";
+function canPrompt(opts = {}) {
+  if (opts.json === true) return false;
+  const stdin = opts.stdin ?? process.stdin;
+  const stderr = opts.stderr ?? process.stderr;
+  return stdin.isTTY === true && stderr.isTTY === true;
+}
+async function promptPluginQuestion(pkg, question, fallback, opts = {}) {
+  if (!canPrompt(opts)) return void 0;
+  const input = opts.stdin ?? process.stdin;
+  const output = opts.stderr ?? process.stderr;
+  const rl = createInterface({ input, output });
+  try {
+    output.write(terminalText(`
+${question.label} ${style.dim(`(${pkg})`)}
+`));
+    if (question.type === "boolean") {
+      const answer2 = (await questionOrCancel(rl, `  [Y/n] (default: ${fallback ? "yes" : "no"}): `, output)).trim().toLowerCase();
+      if (answer2 === "") return fallback;
+      return answer2 === "y" || answer2 === "yes";
+    }
+    if (question.type === "choice") {
+      const choices = question.choices ?? [];
+      output.write(choices.map((c, i) => `  ${i + 1}) ${c}`).join("\n") + "\n");
+      const answer2 = (await questionOrCancel(rl, `  Choose (default: ${String(fallback)}): `, output)).trim();
+      if (answer2 === "") return fallback;
+      const index = Number.parseInt(answer2, 10);
+      if (Number.isInteger(index) && index >= 1 && index <= choices.length) return choices[index - 1];
+      return choices.includes(answer2) ? answer2 : fallback;
+    }
+    const answer = (await questionOrCancel(rl, `  (default: ${String(fallback)}): `, output)).trim();
+    return answer === "" ? fallback : answer;
+  } finally {
+    rl.close();
+  }
+}
+function pluginPrompter(opts = {}) {
+  return {
+    ask: (pkg, question, fallback) => promptPluginQuestion(pkg, question, fallback, opts)
+  };
+}
+
+export {
+  canPrompt,
+  promptPluginQuestion,
+  pluginPrompter
+};
+//# sourceMappingURL=chunk-IDOTCMDV.js.map

package/dist/chunk-IGOLHKWF.js

@@ -0,0 +1,427 @@
+import {
+  fl
+} from "./chunk-6HO3NCSJ.js";
+import {
+  brandDef
+} from "./chunk-ERVIASGL.js";
+import {
+  nearestKey
+} from "./chunk-WTPZRR4I.js";
+import {
+  c
+} from "./chunk-OXA6PSZT.js";
+
+// src/function/define.ts
+function defineFunction(def) {
+  if (!def.name || typeof def.name !== "string") {
+    throw new Error("defineFunction: `name` is required and must be a non-empty string.");
+  }
+  return brandDef(def, "function");
+}
+
+// src/fields/file-url.ts
+function fileUrl(file, baseUrl) {
+  if (!file) return null;
+  if (typeof file.path === "string" && file.path !== "") {
+    const base = baseUrl.replace(/\/+$/, "");
+    return file.path.startsWith("/") ? base + file.path : `${base}/${file.path}`;
+  }
+  return typeof file.url === "string" && file.url !== "" ? file.url : null;
+}
+
+// src/values/fl.ts
+var FILTER_ALIASES = {
+  multiply: "mul",
+  times: "mul",
+  divide: "div",
+  subtract: "sub",
+  minus: "sub",
+  plus: "add",
+  modulo: "mod",
+  uppercase: "upper",
+  toupper: "upper",
+  touppercase: "upper",
+  lowercase: "lower",
+  tolower: "lower",
+  tolowercase: "lower",
+  len: "strlen",
+  includes: "contains",
+  startswith: "starts_with",
+  endswith: "ends_with",
+  replace: "string_replace",
+  replaceall: "string_replace",
+  tostring: "to_text",
+  tostr: "to_text",
+  parseint: "to_int",
+  tonumber: "to_decimal",
+  parsefloat: "to_decimal",
+  jsonparse: "json_decode",
+  jsonstringify: "json_encode",
+  stringify: "json_encode",
+  keys: "array_keys",
+  values: "array_values",
+  slice: "array_slice",
+  isempty: "empty"
+};
+function suggestFilter(name) {
+  const names = Object.keys(fl);
+  const alias = FILTER_ALIASES[name.toLowerCase().replace(/_/g, "")];
+  if (alias !== void 0 && names.includes(alias)) return alias;
+  return nearestKey(name, names);
+}
+var fl2 = /* @__PURE__ */ new Proxy(fl, {
+  get(target, prop, receiver) {
+    if (typeof prop !== "string" || prop in target || !/^[a-z]/i.test(prop)) return Reflect.get(target, prop, receiver);
+    const near = suggestFilter(prop);
+    if (near !== void 0) {
+      throw new Error(`fl.${prop} is not a filter \u2014 did you mean fl.${near}? Every filter is listed in manifest.json \`filters\`.`);
+    }
+    return Reflect.get(target, prop, receiver);
+  }
+});
+
+// src/values/generated/query-filters.generated.ts
+var v = (x) => {
+  if (typeof x === "string") return c.text(x);
+  if (typeof x === "number") return Number.isInteger(x) ? c.int(x) : c.decimal(x);
+  if (typeof x === "boolean") return c.bool(x);
+  return x;
+};
+var step = (name, ...args) => args.length === 0 ? { name } : { name, arg: args.map(v) };
+var QUERY_FILTER_NAMES = ["add", "array_length", "at_timezone", "avg", "between_filter", "ceil", "coalesce", "concat", "count", "count_distinct", "covers", "distance", "div", "epochms_add_day", "epochms_add_hour", "epochms_add_minute", "epochms_add_month", "epochms_add_sec", "epochms_add_year", "epochms_day", "epochms_dow", "epochms_doy", "epochms_epoch_day", "epochms_epoch_hour", "epochms_epoch_minute", "epochms_epoch_sec", "epochms_hour", "epochms_minute", "epochms_month", "epochms_sub_day", "epochms_sub_hour", "epochms_sub_minute", "epochms_sub_month", "epochms_sub_sec", "epochms_sub_year", "epochms_week", "epochms_year", "floor", "length", "lower", "max", "max_timestamp", "median", "min", "min_timestamp", "mul", "round", "search_rank", "sub", "substr", "sum", "time", "to_decimal", "to_distinct_list", "to_distinct_list_asc", "to_distinct_list_desc", "to_int", "to_list", "to_list_asc", "to_list_desc", "to_text", "to_timestamp", "unaccent", "upper", "vector_cos_distance", "vector_cos_similarity", "vector_hamming_distance", "vector_inner_product", "vector_jaccard_distance", "vector_l1_distance", "vector_l2_distance", "vector_negative_inner_product", "within"];
+var QUERY_AGGREGATE_NAMES = ["avg", "count", "count_distinct", "max", "max_timestamp", "median", "min", "min_timestamp", "sum", "to_distinct_list", "to_distinct_list_asc", "to_distinct_list_desc", "to_list", "to_list_asc", "to_list_desc"];
+var QUERY_FILTER_SPECS = { "add": { "kind": "filter", "args": [{ "name": "value", "type": "decimal" }], "arity": 1, "result": "decimal", "entry": ["int", "decimal"] }, "array_length": { "kind": "filter", "args": [], "arity": 0, "result": "int" }, "at_timezone": { "kind": "filter", "args": [{ "name": "value", "type": "text" }], "arity": 1, "result": "timestamp", "entry": ["timestamp"] }, "avg": { "kind": "aggregate", "args": [], "arity": 0, "result": "decimal", "entry": ["int[]", "decimal[]"] }, "between_filter": { "kind": "filter", "args": [{ "name": "left", "type": "any" }, { "name": "right", "type": "any" }], "arity": 2, "result": "bool", "entry": ["decimal", "int", "timestamp", "epochms"] }, "ceil": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["decimal", "int"] }, "coalesce": { "kind": "filter", "args": [{ "name": "value", "type": "json" }], "arity": 1, "result": "json", "entry": ["json"] }, "concat": { "kind": "filter", "args": [{ "name": "value", "type": "json" }], "arity": 1, "result": "text", "entry": ["text", "int", "decimal", "boolean"] }, "count": { "kind": "aggregate", "args": [], "arity": 0, "result": "int", "entry": ["int[]", "decimal[]"] }, "count_distinct": { "kind": "aggregate", "args": [], "arity": 0, "result": "int", "entry": ["int[]", "decimal[]"] }, "covers": { "kind": "filter", "args": [{ "name": "point", "type": "geo_point" }], "arity": 1, "result": "bool", "entry": ["geo_point", "geo_multipoint", "geo_linestring", "geo_multilinestring", "geo_polygon", "geo_multipolygon"] }, "distance": { "kind": "filter", "args": [{ "name": "point", "type": "geo_point" }], "arity": 1, "result": "decimal", "entry": ["geo_point", "geo_multipoint", "geo_linestring", "geo_multilinestring", "geo_polygon", "geo_multipolygon"] }, "div": { "kind": "filter", "args": [{ "name": "value", "type": "decimal" }], "arity": 1, "result": "decimal", "entry": ["int", "decimal"] }, "epochms_add_day": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_add_hour": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_add_minute": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_add_month": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_add_sec": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_add_year": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_day": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "epochms_dow": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "epochms_doy": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "epochms_epoch_day": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["epochms"] }, "epochms_epoch_hour": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["epochms"] }, "epochms_epoch_minute": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["epochms"] }, "epochms_epoch_sec": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["epochms"] }, "epochms_hour": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "epochms_minute": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "epochms_month": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "epochms_sub_day": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_sub_hour": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_sub_minute": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_sub_month": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_sub_sec": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_sub_year": { "kind": "filter", "args": [{ "name": "amount", "type": "decimal" }], "arity": 1, "result": "epochms", "entry": ["epochms"] }, "epochms_week": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "epochms_year": { "kind": "filter", "args": [{ "name": "timezone", "type": "text" }], "arity": 1, "result": "int", "entry": ["epochms"] }, "floor": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["decimal", "int"] }, "length": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["text"] }, "lower": { "kind": "filter", "args": [], "arity": 0, "result": "text", "entry": ["text", "enum"] }, "max": { "kind": "aggregate", "args": [], "arity": 0, "result": "decimal", "entry": ["int[]", "decimal[]"] }, "max_timestamp": { "kind": "aggregate", "args": [], "arity": 0, "result": "timestamp", "entry": ["timestamp[]"] }, "median": { "kind": "aggregate", "args": [], "arity": 0, "result": "decimal", "entry": ["int[]", "decimal[]"] }, "min": { "kind": "aggregate", "args": [], "arity": 0, "result": "decimal", "entry": ["int[]", "decimal[]"] }, "min_timestamp": { "kind": "aggregate", "args": [], "arity": 0, "result": "timestamp", "entry": ["timestamp[]"] }, "mul": { "kind": "filter", "args": [{ "name": "value", "type": "decimal" }], "arity": 1, "result": "decimal", "entry": ["int", "decimal"] }, "round": { "kind": "filter", "args": [{ "name": "precision", "type": "int" }], "arity": 1, "result": "decimal", "entry": ["decimal", "int"] }, "search_rank": { "kind": "filter", "args": [{ "name": "q", "type": "text" }], "arity": 1, "result": "decimal", "entry": ["search"] }, "sub": { "kind": "filter", "args": [{ "name": "value", "type": "decimal" }], "arity": 1, "result": "decimal", "entry": ["int", "decimal"] }, "substr": { "kind": "filter", "args": [{ "name": "start", "type": "int" }, { "name": "length", "type": "int" }], "arity": 2, "result": "text", "entry": ["text"] }, "sum": { "kind": "aggregate", "args": [], "arity": 0, "result": "decimal", "entry": ["int[]", "decimal[]"] }, "time": { "kind": "filter", "args": [{ "name": "option", "type": "enum", "enum": ["century", "day", "decade", "dow", "doy", "epoch", "hour", "isodow", "isoyear", "microseconds", "millennium", "milliseconds", "minute", "month", "quarter", "second", "timezone", "timezone_hour", "timezone_minute", "week", "year"] }], "arity": 1, "result": "decimal", "entry": ["timestamp"] }, "to_decimal": { "kind": "filter", "args": [], "arity": 0, "result": "decimal", "entry": ["text"] }, "to_distinct_list": { "kind": "aggregate", "args": [], "arity": 0, "result": "json", "entry": ["int[]", "decimal[]"] }, "to_distinct_list_asc": { "kind": "aggregate", "args": [], "arity": 0, "result": "json", "entry": ["int[]", "decimal[]"] }, "to_distinct_list_desc": { "kind": "aggregate", "args": [], "arity": 0, "result": "json", "entry": ["int[]", "decimal[]"] }, "to_int": { "kind": "filter", "args": [], "arity": 0, "result": "int", "entry": ["text", "bool"] }, "to_list": { "kind": "aggregate", "args": [], "arity": 0, "result": "json", "entry": ["int[]", "decimal[]"] }, "to_list_asc": { "kind": "aggregate", "args": [], "arity": 0, "result": "json", "entry": ["int[]", "decimal[]"] }, "to_list_desc": { "kind": "aggregate", "args": [], "arity": 0, "result": "json", "entry": ["int[]", "decimal[]"] }, "to_text": { "kind": "filter", "args": [], "arity": 0, "result": "text", "entry": ["bool", "int", "decimal", "timestamp", "json"] }, "to_timestamp": { "kind": "filter", "args": [], "arity": 0, "result": "timestamp", "entry": ["text", "json", "int", "decimal"] }, "unaccent": { "kind": "filter", "args": [], "arity": 0, "result": "text", "entry": ["text", "enum"] }, "upper": { "kind": "filter", "args": [], "arity": 0, "result": "text", "entry": ["text", "enum"] }, "vector_cos_distance": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "vector_cos_similarity": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "vector_hamming_distance": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "vector_inner_product": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "vector_jaccard_distance": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "vector_l1_distance": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "vector_l2_distance": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "vector_negative_inner_product": { "kind": "filter", "args": [{ "name": "vector", "type": "decimal[]" }], "arity": 1, "result": "decimal", "entry": ["decimal[]", "int[]"] }, "within": { "kind": "filter", "args": [{ "name": "point", "type": "geo_point" }, { "name": "radius", "type": "decimal" }], "arity": 2, "result": "bool", "entry": ["geo_point", "geo_multipoint", "geo_linestring", "geo_multilinestring", "geo_polygon", "geo_multipolygon"] } };
+var qf = {
+  "add": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: int | decimal. Result: decimal. */
+    (value) => step("add", value)
+  ),
+  "array_length": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Result: int. */
+    () => step("array_length")
+  ),
+  "at_timezone": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: timestamp. Result: timestamp. */
+    (value) => step("at_timezone", value)
+  ),
+  "avg": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: decimal. */
+    () => step("avg")
+  ),
+  "between_filter": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal | int | timestamp | epochms. Result: bool. */
+    (left, right) => step("between_filter", left, right)
+  ),
+  "ceil": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal | int. Result: int. */
+    () => step("ceil")
+  ),
+  "coalesce": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: json. Result: json. */
+    (value) => step("coalesce", value)
+  ),
+  "concat": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text | int | decimal | boolean. Result: text. */
+    (value) => step("concat", value)
+  ),
+  "count": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: int. */
+    () => step("count")
+  ),
+  "count_distinct": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: int. */
+    () => step("count_distinct")
+  ),
+  "covers": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: geo_point | geo_multipoint | geo_linestring | geo_multilinestring | geo_polygon | geo_multipolygon. Result: bool. */
+    (point) => step("covers", point)
+  ),
+  "distance": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: geo_point | geo_multipoint | geo_linestring | geo_multilinestring | geo_polygon | geo_multipolygon. Result: decimal. */
+    (point) => step("distance", point)
+  ),
+  "div": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: int | decimal. Result: decimal. */
+    (value) => step("div", value)
+  ),
+  "epochms_add_day": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_add_day", amount)
+  ),
+  "epochms_add_hour": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_add_hour", amount)
+  ),
+  "epochms_add_minute": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_add_minute", amount)
+  ),
+  "epochms_add_month": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_add_month", amount)
+  ),
+  "epochms_add_sec": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_add_sec", amount)
+  ),
+  "epochms_add_year": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_add_year", amount)
+  ),
+  "epochms_day": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_day", timezone)
+  ),
+  "epochms_dow": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_dow", timezone)
+  ),
+  "epochms_doy": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_doy", timezone)
+  ),
+  "epochms_epoch_day": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    () => step("epochms_epoch_day")
+  ),
+  "epochms_epoch_hour": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    () => step("epochms_epoch_hour")
+  ),
+  "epochms_epoch_minute": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    () => step("epochms_epoch_minute")
+  ),
+  "epochms_epoch_sec": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    () => step("epochms_epoch_sec")
+  ),
+  "epochms_hour": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_hour", timezone)
+  ),
+  "epochms_minute": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_minute", timezone)
+  ),
+  "epochms_month": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_month", timezone)
+  ),
+  "epochms_sub_day": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_sub_day", amount)
+  ),
+  "epochms_sub_hour": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_sub_hour", amount)
+  ),
+  "epochms_sub_minute": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_sub_minute", amount)
+  ),
+  "epochms_sub_month": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_sub_month", amount)
+  ),
+  "epochms_sub_sec": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_sub_sec", amount)
+  ),
+  "epochms_sub_year": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: epochms. */
+    (amount) => step("epochms_sub_year", amount)
+  ),
+  "epochms_week": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_week", timezone)
+  ),
+  "epochms_year": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: epochms. Result: int. */
+    (timezone) => step("epochms_year", timezone)
+  ),
+  "floor": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal | int. Result: int. */
+    () => step("floor")
+  ),
+  "length": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text. Result: int. */
+    () => step("length")
+  ),
+  "lower": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text | enum. Result: text. */
+    () => step("lower")
+  ),
+  "max": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: decimal. */
+    () => step("max")
+  ),
+  "max_timestamp": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: timestamp[]. Result: timestamp. */
+    () => step("max_timestamp")
+  ),
+  "median": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: decimal. */
+    () => step("median")
+  ),
+  "min": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: decimal. */
+    () => step("min")
+  ),
+  "min_timestamp": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: timestamp[]. Result: timestamp. */
+    () => step("min_timestamp")
+  ),
+  "mul": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: int | decimal. Result: decimal. */
+    (value) => step("mul", value)
+  ),
+  "round": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal | int. Result: decimal. */
+    (precision) => step("round", precision)
+  ),
+  "search_rank": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: search. Result: decimal. */
+    (q) => step("search_rank", q)
+  ),
+  "sub": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: int | decimal. Result: decimal. */
+    (value) => step("sub", value)
+  ),
+  "substr": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text. Result: text. */
+    (start, length) => step("substr", start, length)
+  ),
+  "sum": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: decimal. */
+    () => step("sum")
+  ),
+  "time": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: timestamp. Result: decimal. */
+    (option) => step("time", option)
+  ),
+  "to_decimal": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text. Result: decimal. */
+    () => step("to_decimal")
+  ),
+  "to_distinct_list": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: json. */
+    () => step("to_distinct_list")
+  ),
+  "to_distinct_list_asc": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: json. */
+    () => step("to_distinct_list_asc")
+  ),
+  "to_distinct_list_desc": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: json. */
+    () => step("to_distinct_list_desc")
+  ),
+  "to_int": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text | bool. Result: int. */
+    () => step("to_int")
+  ),
+  "to_list": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: json. */
+    () => step("to_list")
+  ),
+  "to_list_asc": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: json. */
+    () => step("to_list_asc")
+  ),
+  "to_list_desc": (
+    /** SQL AGGREGATE — valid only in an aggregate query's `eval`/`group`, computed by the database over the grouped result. Piped value: int[] | decimal[]. Result: json. */
+    () => step("to_list_desc")
+  ),
+  "to_text": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: bool | int | decimal | timestamp | json. Result: text. */
+    () => step("to_text")
+  ),
+  "to_timestamp": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text | json | int | decimal. Result: timestamp. */
+    () => step("to_timestamp")
+  ),
+  "unaccent": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text | enum. Result: text. */
+    () => step("unaccent")
+  ),
+  "upper": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: text | enum. Result: text. */
+    () => step("upper")
+  ),
+  "vector_cos_distance": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_cos_distance", vector)
+  ),
+  "vector_cos_similarity": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_cos_similarity", vector)
+  ),
+  "vector_hamming_distance": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_hamming_distance", vector)
+  ),
+  "vector_inner_product": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_inner_product", vector)
+  ),
+  "vector_jaccard_distance": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_jaccard_distance", vector)
+  ),
+  "vector_l1_distance": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_l1_distance", vector)
+  ),
+  "vector_l2_distance": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_l2_distance", vector)
+  ),
+  "vector_negative_inner_product": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: decimal[] | int[]. Result: decimal. */
+    (vector) => step("vector_negative_inner_product", vector)
+  ),
+  "within": (
+    /** Compiled into SQL, so it resolves only in a db-query `eval`, `sort` or `where` — never in a value `filters[]` pipeline. Piped value: geo_point | geo_multipoint | geo_linestring | geo_multilinestring | geo_polygon | geo_multipolygon. Result: bool. */
+    (point, radius) => step("within", point, radius)
+  )
+};
+
+// src/util/duration.ts
+var UNIT_SECONDS = {
+  s: 1,
+  m: 60,
+  h: 3600,
+  d: 86400,
+  w: 604800
+};
+var TERM = /(\d+)([smhdw])/g;
+var WHOLE = /^(\d+[smhdw])+$/;
+function every(duration) {
+  if (!WHOLE.test(duration)) {
+    throw new Error(
+      `every(${JSON.stringify(duration)}): not a duration. Write one or more <number><unit> terms with no spaces \u2014 "30s", "15m", "1h", "7d", "2w", "1h30m". Units are s/m/h/d/w; there is no month or year unit because neither is a fixed number of seconds. For a plain second count, pass the number itself.`
+    );
+  }
+  let total = 0;
+  for (const match of duration.matchAll(TERM)) {
+    total += Number(match[1]) * UNIT_SECONDS[match[2]];
+  }
+  if (total === 0) {
+    throw new Error(
+      `every(${JSON.stringify(duration)}) is zero seconds. A repeat frequency of 0 is not a schedule \u2014 the task would re-fire as fast as the scheduler dequeues it.`
+    );
+  }
+  return total;
+}
+
+export {
+  defineFunction,
+  fileUrl,
+  fl2 as fl,
+  QUERY_FILTER_NAMES,
+  QUERY_AGGREGATE_NAMES,
+  QUERY_FILTER_SPECS,
+  qf,
+  every
+};
+//# sourceMappingURL=chunk-IGOLHKWF.js.map