okmodel 0.6.0 → 0.8.0

package/dist/shared/bsek72fg.js

@@ -0,0 +1,225 @@
+import {
+  assertNoControl
+} from "./zchaghkf.js";
+import {
+  isOperator,
+  operatorName,
+  operatorValue,
+  tag
+} from "./cn0n68ft.js";
+import {
+  OkmError2
+} from "./52szzakm.js";
+
+// src/dialects/pg/ops/fragment.ts
+var IDENT = Symbol("okmodel.sql.ident");
+var COLUMN = Symbol("okmodel.sql.column");
+function fragmentError(message, fix) {
+  throw new OkmError2("OKM1125", message, { fix: { summary: fix } });
+}
+function isFragmentParts(value) {
+  return Array.isArray(value) && value.every(isPart);
+}
+function isPart(value) {
+  if (typeof value !== "object" || value === null || !("k" in value))
+    return false;
+  const kind = value.k;
+  if (kind === "t")
+    return "s" in value && typeof value.s === "string";
+  if (kind === "p")
+    return "v" in value && typeof value.v === "string";
+  if (kind === "n" || kind === "c")
+    return true;
+  if (kind === "i")
+    return "n" in value && typeof value.n === "string";
+  if (kind === "f")
+    return "parts" in value && isFragmentParts(value.parts);
+  return false;
+}
+function readSelectFragment(value) {
+  if (!isOperator(value) || operatorName(value) !== "sql")
+    return;
+  const named = value;
+  if (typeof named.as !== "string") {
+    fragmentError("A select fragment needs as(name).", 'Call .as("len") and pass that value in select.');
+  }
+  const stored = operatorValue(value);
+  if (!isFragmentParts(stored)) {
+    fragmentError("A fragment was not created by fragment``.", "Call fragment`...`.");
+  }
+  const textual = named.text === true;
+  return textual ? { as: named.as, parts: stored, textual: true } : { as: named.as, parts: stored };
+}
+function scanLiteral(literal, state) {
+  for (let index = 0;index < literal.length; index += 1) {
+    const char = literal[index] ?? "";
+    const code = literal.charCodeAt(index);
+    if (state.quote !== undefined) {
+      if (char !== state.quote)
+        continue;
+      if (literal[index + 1] === state.quote) {
+        index += 1;
+        continue;
+      }
+      state.quote = undefined;
+      continue;
+    }
+    if (code <= 31 && code !== 9 && code !== 10 && code !== 13 || code === 127) {
+      fragmentError("A fragment literal contains a control character.", "Remove NUL and other control characters. A newline, tab, or return is allowed.");
+    }
+    if (char === "'" || char === '"') {
+      state.quote = char;
+      continue;
+    }
+    if (char === "(") {
+      state.paren += 1;
+      continue;
+    }
+    if (char === ")") {
+      state.paren -= 1;
+      if (state.paren < 0) {
+        fragmentError("A fragment has unbalanced SQL.", "Keep parentheses and quotes balanced. A fragment cannot close the surrounding predicate.");
+      }
+      continue;
+    }
+    if (char === ";") {
+      fragmentError("A fragment cannot include a semicolon.", "Pass the value as an interpolation. The fragment is one expression.");
+    }
+    if (char === "$") {
+      fragmentError("A fragment cannot include a dollar quote or a parameter marker.", "Interpolate the value. The planner numbers parameters.");
+    }
+    if (char === "-" && literal[index + 1] === "-" || char === "/" && literal[index + 1] === "*") {
+      fragmentError("A fragment cannot include a comment.", "Remove the comment. A comment can hide the rest of the predicate.");
+    }
+  }
+}
+function appendText(parts, literal) {
+  if (literal.length === 0)
+    return;
+  parts.push({ k: "t", s: literal });
+}
+function appendValue(parts, value) {
+  if (value === null) {
+    parts.push({ k: "n" });
+    return;
+  }
+  if (typeof value === "string") {
+    parts.push({ k: "p", v: value });
+    return;
+  }
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      fragmentError("A fragment needs a finite number.", "Pass a finite number, or leave it out.");
+    }
+    parts.push({ k: "p", v: String(value) });
+    return;
+  }
+  if (typeof value === "boolean") {
+    parts.push({ k: "p", v: value ? "true" : "false" });
+    return;
+  }
+  if (typeof value === "bigint") {
+    parts.push({ k: "p", v: String(value) });
+    return;
+  }
+  if (typeof value === "object") {
+    if (COLUMN in value) {
+      parts.push({ k: "c" });
+      return;
+    }
+    if (IDENT in value) {
+      const name = value[IDENT];
+      if (typeof name === "string") {
+        parts.push({ k: "i", n: name });
+        return;
+      }
+    }
+    if (isOperator(value) && operatorName(value) === "sql") {
+      const nested = operatorValue(value);
+      if (!isFragmentParts(nested)) {
+        fragmentError("A fragment was not created by fragment``.", "Call fragment`...`.");
+      }
+      parts.push({ k: "f", parts: nested });
+      return;
+    }
+  }
+  fragmentError("A fragment cannot interpolate that value.", "Interpolate a string, number, boolean, null, ident(name), fragment.column, or another fragment.");
+}
+function hasSql(parts) {
+  for (const part of parts) {
+    if (part.k === "t") {
+      if (part.s.trim().length > 0)
+        return true;
+      continue;
+    }
+    return true;
+  }
+  return false;
+}
+function compile(strings, values) {
+  const state = { quote: undefined, paren: 0 };
+  const parts = [];
+  for (let index = 0;index < values.length + 1; index += 1) {
+    const literal = strings[index] ?? "";
+    scanLiteral(literal, state);
+    appendText(parts, literal);
+    if (index === values.length)
+      continue;
+    if (state.quote !== undefined) {
+      fragmentError("A fragment cannot interpolate inside quotes.", "Do not put an interpolation inside quotes. Write title = ${name}.");
+    }
+    appendValue(parts, values[index]);
+  }
+  if (state.quote !== undefined || state.paren !== 0) {
+    fragmentError("A fragment has unbalanced SQL.", "Keep parentheses and quotes balanced. A fragment cannot close the surrounding predicate.");
+  }
+  if (!hasSql(parts)) {
+    fragmentError("A fragment needs SQL text.", "Write an expression, or interpolate a value.");
+  }
+  return parts;
+}
+function isTemplate(value) {
+  return Array.isArray(value) && "raw" in value;
+}
+function bind(parts, textual = false) {
+  const tagged = tag("sql", parts);
+  return Object.assign(tagged, {
+    as(name) {
+      if (typeof name !== "string" || name.length === 0) {
+        fragmentError("as(name) needs a result name.", 'Call .as("len") with a name that is not a column.');
+      }
+      assertNoControl(name, "fragment as");
+      const selected = Object.assign(tag("sql", parts), { as: name });
+      return textual ? Object.assign(selected, { text: true }) : selected;
+    }
+  });
+}
+function sqlExpression(parts, textual = false) {
+  return bind(parts, textual);
+}
+function identName(value) {
+  if (typeof value !== "object" || value === null || !(IDENT in value))
+    return;
+  const stored = value[IDENT];
+  return typeof stored === "string" ? stored : undefined;
+}
+function fragmentTag(strings, ...values) {
+  if (!isTemplate(strings)) {
+    fragmentError("Call fragment as a template: fragment`...`.", "Write fragment`length(${fragment.column}) > ${1}`.");
+  }
+  return bind(compile(strings, values));
+}
+var fragment2 = Object.assign(fragmentTag, {
+  column: { [COLUMN]: true }
+});
+function ident2(name) {
+  if (typeof name !== "string" || name.length === 0) {
+    throw new OkmError2("OKM1122", "ident needs a name.", {
+      fix: { summary: "Pass the field name, such as title." }
+    });
+  }
+  assertNoControl(name, "ident");
+  return { [IDENT]: name };
+}
+
+export { isFragmentParts, readSelectFragment, sqlExpression, identName, fragment2, ident2 };