@lunora/bindings 1.0.0-alpha.8 → 1.0.0-alpha.81

package/dist/packem_shared/R2SqlError-drPKSCZ3.mjs

@@ -1,65 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import SelectBuilder from './SelectBuilder-BOqJQHEv.mjs';
-import { ident, toText } from './Sql-B3zq2YGx.mjs';
-
-const API_BASE = "https://api.sql.cloudflarestorage.com/api/v1/accounts";
-const inferColumns = (rows) => {
-  if (rows[0] === void 0) {
-    return [];
-  }
-  return Object.keys(rows[0]).map((name) => {
-    return { name };
-  });
-};
-class R2SqlError extends LunoraError {
-  constructor(status, body) {
-    super("R2_SQL_ERROR", `R2 SQL query failed (${String(status)}): ${body}`, { name: "R2SqlError", status });
-  }
-}
-const createR2Sql = (config) => {
-  const fetchImpl = config.fetch ?? globalThis.fetch;
-  const base = config.endpoint ?? API_BASE;
-  const endpoint = `${base}/${encodeURIComponent(config.accountId)}/r2-sql/query/${encodeURIComponent(config.bucket)}`;
-  const warehouse = `${config.accountId}_${config.bucket}`;
-  const exec = async (statement) => {
-    const response = await fetchImpl(endpoint, {
-      body: JSON.stringify({ query: statement, warehouse }),
-      headers: {
-        Authorization: `Bearer ${config.apiToken}`,
-        "Content-Type": "application/json"
-      },
-      method: "POST"
-    });
-    if (!response.ok) {
-      throw new R2SqlError(response.status, await response.text());
-    }
-    let raw;
-    try {
-      raw = await response.json();
-    } catch {
-      throw new R2SqlError(response.status, "R2 SQL returned a non-JSON body.");
-    }
-    const body = raw;
-    if (body.success === false || body.errors !== void 0 && body.errors.length > 0) {
-      throw new R2SqlError(response.status, JSON.stringify(body.errors ?? body));
-    }
-    const rows = body.result?.rows ?? [];
-    return {
-      columns: body.result?.schema ?? inferColumns(rows),
-      rowCount: rows.length,
-      rows
-    };
-  };
-  return {
-    describe: async (table) => exec(`DESCRIBE ${ident(table)}`),
-    explain: async (statement, options) => exec(`EXPLAIN ${options?.format === "json" ? "FORMAT JSON " : ""}${toText(statement)}`),
-    // `SelectBuilder`'s constructor validates the table reference (allowing an
-    // optional `[AS] alias`), so no pre-validation here.
-    from: (table) => new SelectBuilder(exec, table),
-    query: async (statement) => exec(toText(statement)),
-    showDatabases: async () => exec("SHOW DATABASES"),
-    showTables: async (namespace) => exec(`SHOW TABLES IN ${ident(namespace)}`)
-  };
-};
-
-export { R2SqlError, createR2Sql };

package/dist/packem_shared/SelectBuilder-BOqJQHEv.mjs

@@ -1,168 +0,0 @@
-import { renderOrderTerm } from './asc-DZbQCxh1.mjs';
-import SetOperation from './SetOperation-DmPgUL8W.mjs';
-import { tableRef, toText, assertLimit, lit } from './Sql-B3zq2YGx.mjs';
-
-const JOIN_KEYWORDS = {
-  cross: "CROSS JOIN",
-  full: "FULL OUTER JOIN",
-  inner: "INNER JOIN",
-  left: "LEFT JOIN",
-  right: "RIGHT JOIN"
-};
-class SelectBuilder {
-  exec;
-  table;
-  selectItems = [];
-  distinctFlag = false;
-  distinctOnItems = [];
-  joins = [];
-  whereConditions = [];
-  groupByItems = [];
-  havingConditions = [];
-  qualifyCondition;
-  orderByItems = [];
-  limitValue;
-  constructor(exec, table) {
-    this.exec = exec;
-    this.table = tableRef(table);
-  }
-  /** The `SELECT` list. Omit/empty for `SELECT *`. Items are columns, expressions, or aliased window fragments (`fn.rowNumber().over(...).as("rk")`). */
-  select(...items) {
-    this.selectItems.push(...items.map((item) => toText(item)));
-    return this;
-  }
-  /** `SELECT DISTINCT` — unique rows. */
-  distinct() {
-    this.distinctFlag = true;
-    return this;
-  }
-  /** `DISTINCT ON (cols)` — the first row per distinct combination, ordered by {@link orderBy}. */
-  distinctOn(...columns) {
-    this.distinctOnItems.push(...columns.map((column) => toText(column)));
-    return this;
-  }
-  /** `INNER JOIN table ON condition`. */
-  innerJoin(table, on) {
-    return this.addJoin("inner", table, on);
-  }
-  /** `LEFT JOIN table ON condition`. */
-  leftJoin(table, on) {
-    return this.addJoin("left", table, on);
-  }
-  /** `RIGHT JOIN table ON condition`. */
-  rightJoin(table, on) {
-    return this.addJoin("right", table, on);
-  }
-  /** `FULL OUTER JOIN table ON condition`. */
-  fullJoin(table, on) {
-    return this.addJoin("full", table, on);
-  }
-  /** `CROSS JOIN table` (no `ON`). */
-  crossJoin(table) {
-    return this.addJoin("cross", table);
-  }
-  /** Add `WHERE` condition(s). Multiple calls (and multiple args) are `AND`-ed. Bind values with the `sql` tag. */
-  where(...conditions) {
-    this.whereConditions.push(...conditions.map((condition) => toText(condition)));
-    return this;
-  }
-  /** `GROUP BY` column(s)/expression(s). */
-  groupBy(...columns) {
-    this.groupByItems.push(...columns.map((column) => toText(column)));
-    return this;
-  }
-  /** Add `HAVING` condition(s) over aggregates; multiple are `AND`-ed. */
-  having(...conditions) {
-    this.havingConditions.push(...conditions.map((condition) => toText(condition)));
-    return this;
-  }
-  /**
-   * `QUALIFY` — filter on a window function without a subquery, e.g.
-   * `.qualify(fn.rowNumber().over({ partitionBy: "region", orderBy: desc("total") }).lte(3))`.
-   */
-  qualify(condition) {
-    this.qualifyCondition = toText(condition);
-    return this;
-  }
-  /** `ORDER BY` term(s) — bare strings (ASC) or {@link import("./order").asc | asc}/{@link import("./order").desc | desc} tags. */
-  orderBy(...terms) {
-    this.orderByItems.push(...terms.map((term) => renderOrderTerm(term)));
-    return this;
-  }
-  /** `LIMIT n` (R2 SQL: 1–10,000, default 500). */
-  limit(n) {
-    assertLimit(n);
-    this.limitValue = n;
-    return this;
-  }
-  /** Re-type the result rows without changing the query (the builder carries no schema of its own). */
-  returns() {
-    return this;
-  }
-  /** `this UNION other` — all rows from both, duplicates removed. */
-  union(other) {
-    return this.setOperation("UNION", other);
-  }
-  /** `this UNION ALL other` — all rows from both, duplicates kept. */
-  unionAll(other) {
-    return this.setOperation("UNION ALL", other);
-  }
-  /** `this INTERSECT other` — rows present in both. */
-  intersect(other) {
-    return this.setOperation("INTERSECT", other);
-  }
-  /** `this EXCEPT other` — rows in `this` but not `other`. */
-  except(other) {
-    return this.setOperation("EXCEPT", other);
-  }
-  /** True when this query carries its own `ORDER BY`/`LIMIT` — so a set operation must parenthesise it. */
-  get needsWrapForSetOperation() {
-    return this.orderByItems.length > 0 || this.limitValue !== void 0;
-  }
-  /** Render the `SELECT` statement (no trailing semicolon). */
-  toSQL() {
-    const parts = [`${this.renderHead()} ${this.selectItems.length > 0 ? this.selectItems.join(", ") : "*"}`, `FROM ${this.table}`];
-    for (const join of this.joins) {
-      parts.push(join.on === void 0 ? `${JOIN_KEYWORDS[join.kind]} ${join.table}` : `${JOIN_KEYWORDS[join.kind]} ${join.table} ON ${toText(join.on)}`);
-    }
-    if (this.whereConditions.length > 0) {
-      parts.push(`WHERE ${this.whereConditions.join(" AND ")}`);
-    }
-    if (this.groupByItems.length > 0) {
-      parts.push(`GROUP BY ${this.groupByItems.join(", ")}`);
-    }
-    if (this.havingConditions.length > 0) {
-      parts.push(`HAVING ${this.havingConditions.join(" AND ")}`);
-    }
-    if (this.qualifyCondition !== void 0) {
-      parts.push(`QUALIFY ${this.qualifyCondition}`);
-    }
-    if (this.orderByItems.length > 0) {
-      parts.push(`ORDER BY ${this.orderByItems.join(", ")}`);
-    }
-    if (this.limitValue !== void 0) {
-      parts.push(`LIMIT ${lit(this.limitValue)}`);
-    }
-    return parts.join(" ");
-  }
-  /** Execute the query and return the typed result. */
-  async run() {
-    return this.exec(this.toSQL());
-  }
-  /** The `SELECT [DISTINCT [ON (...)]]` head. */
-  renderHead() {
-    if (this.distinctOnItems.length > 0) {
-      return `SELECT DISTINCT ON (${this.distinctOnItems.join(", ")})`;
-    }
-    return this.distinctFlag ? "SELECT DISTINCT" : "SELECT";
-  }
-  addJoin(kind, table, on) {
-    this.joins.push({ kind, on, table: tableRef(table) });
-    return this;
-  }
-  setOperation(operator, other) {
-    return new SetOperation(this.exec, [{ query: this }, { operator, query: other }]);
-  }
-}
-
-export { SelectBuilder as default };

package/dist/packem_shared/SetOperation-DmPgUL8W.mjs

@@ -1,81 +0,0 @@
-import { renderOrderTerm } from './asc-DZbQCxh1.mjs';
-import { assertLimit, lit } from './Sql-B3zq2YGx.mjs';
-
-const renderMember = (query) => {
-  const text = query.toSQL();
-  return query.needsWrapForSetOperation === true ? `(${text})` : text;
-};
-class SetOperation {
-  /**
-   * Always `true`: a nested set operation must be parenthesised when it is a
-   * member of another set operation, or mixed operators mis-associate — e.g.
-   * `a.union(b.except(c))` must render `a UNION (b EXCEPT c)`, not the flat
-   * `a UNION b EXCEPT c`.
-   */
-  needsWrapForSetOperation = true;
-  exec;
-  members;
-  orderByItems = [];
-  limitValue;
-  constructor(exec, members) {
-    this.exec = exec;
-    this.members = members;
-  }
-  /** Append `UNION other`. */
-  union(other) {
-    return this.add("UNION", other);
-  }
-  /** Append `UNION ALL other`. */
-  unionAll(other) {
-    return this.add("UNION ALL", other);
-  }
-  /** Append `INTERSECT other`. */
-  intersect(other) {
-    return this.add("INTERSECT", other);
-  }
-  /** Append `EXCEPT other`. */
-  except(other) {
-    return this.add("EXCEPT", other);
-  }
-  /** `ORDER BY` applied to the combined result. */
-  orderBy(...terms) {
-    this.orderByItems.push(...terms.map((term) => renderOrderTerm(term)));
-    return this;
-  }
-  /** `LIMIT` applied to the combined result. */
-  limit(n) {
-    assertLimit(n);
-    this.limitValue = n;
-    return this;
-  }
-  /** Re-type the combined result rows. */
-  returns() {
-    return this;
-  }
-  /** Render the combined statement. */
-  toSQL() {
-    const parts = this.members.map((member) => {
-      const text = renderMember(member.query);
-      return member.operator === void 0 ? text : `${member.operator} ${text}`;
-    });
-    const combined = parts.join(" ");
-    const tail = [];
-    if (this.orderByItems.length > 0) {
-      tail.push(`ORDER BY ${this.orderByItems.join(", ")}`);
-    }
-    if (this.limitValue !== void 0) {
-      tail.push(`LIMIT ${lit(this.limitValue)}`);
-    }
-    return tail.length > 0 ? `${combined} ${tail.join(" ")}` : combined;
-  }
-  /** Execute the combined query and return the typed result. */
-  async run() {
-    return this.exec(this.toSQL());
-  }
-  add(operator, other) {
-    this.members.push({ operator, query: other });
-    return this;
-  }
-}
-
-export { SetOperation as default };

package/dist/packem_shared/Sql-B3zq2YGx.mjs

@@ -1,74 +0,0 @@
-const quoteString = (value) => `'${value.replaceAll("'", "''")}'`;
-const IDENTIFIER_RE = /^\w+(?:\.\w+)*$/;
-const TABLE_REF_RE = /^\w+(?:\.\w+)*(?:\s+(?:as\s+)?\w+)?$/i;
-const MAX_LIMIT = 1e4;
-class Sql {
-  text;
-  constructor(text) {
-    this.text = text;
-  }
-  toString() {
-    return this.text;
-  }
-}
-const isSql = (value) => value instanceof Sql;
-const raw = (text) => new Sql(text);
-const toText = (value) => isSql(value) ? value.text : value;
-const ident = (name) => {
-  if (typeof name !== "string" || !IDENTIFIER_RE.test(name)) {
-    throw new TypeError(`r2sql: invalid identifier ${JSON.stringify(name)} — expected dotted [A-Za-z0-9_] segments (e.g. "namespace.table").`);
-  }
-  return name;
-};
-const tableRef = (ref) => {
-  if (typeof ref !== "string" || !TABLE_REF_RE.test(ref)) {
-    throw new TypeError(`r2sql: invalid table reference ${JSON.stringify(ref)} — expected "namespace.table" with an optional "[AS] alias".`);
-  }
-  return ref;
-};
-const lit = (value) => {
-  if (value === null || value === void 0) {
-    return "NULL";
-  }
-  if (typeof value === "boolean") {
-    return value ? "true" : "false";
-  }
-  if (typeof value === "bigint") {
-    return value.toString();
-  }
-  if (typeof value === "number") {
-    if (!Number.isFinite(value)) {
-      throw new TypeError(`r2sql: cannot inline a non-finite number (${String(value)}) as a SQL literal.`);
-    }
-    return String(value);
-  }
-  if (typeof value === "string") {
-    return quoteString(value);
-  }
-  if (value instanceof Date) {
-    return quoteString(value.toISOString());
-  }
-  if (Array.isArray(value)) {
-    if (value.length === 0) {
-      throw new TypeError("r2sql: cannot inline an empty array — `IN ()` is not valid SQL. Guard the empty case before building the query.");
-    }
-    return `(${value.map((element) => lit(element)).join(", ")})`;
-  }
-  throw new TypeError(`r2sql: cannot inline a value of type ${typeof value} as a SQL literal. Wrap trusted SQL with raw(), or pass a primitive/Date/array.`);
-};
-const sql = (strings, ...values) => {
-  let out = strings[0] ?? "";
-  for (const [index, value] of values.entries()) {
-    out += isSql(value) ? value.text : lit(value);
-    out += strings[index + 1] ?? "";
-  }
-  return new Sql(out);
-};
-const joinSql = (parts, separator) => new Sql(parts.map((part) => toText(part)).join(separator));
-const assertLimit = (n) => {
-  if (!Number.isInteger(n) || n < 1 || n > MAX_LIMIT) {
-    throw new RangeError(`r2sql: limit must be an integer between 1 and ${String(MAX_LIMIT)} (got ${String(n)}).`);
-  }
-};
-
-export { Sql, assertLimit, ident, isSql, joinSql, lit, raw, sql, tableRef, toText };

package/dist/packem_shared/WindowExpression-BT_uA6g1.mjs

@@ -1,44 +0,0 @@
-import { Sql, lit } from './Sql-B3zq2YGx.mjs';
-
-const IDENTIFIER = /^[A-Z_][\w$]*$/i;
-const assertIdent = (name) => {
-  if (!IDENTIFIER.test(name)) {
-    throw new TypeError(`r2sql: invalid identifier ${JSON.stringify(name)} — expected a simple SQL name (letters, digits, underscore).`);
-  }
-  return name;
-};
-class WindowExpression extends Sql {
-  /** Alias the expression — `... AS alias` — for use in a `SELECT` list. */
-  as(alias) {
-    return new Sql(`${this.text} AS ${assertIdent(alias)}`);
-  }
-  /** `expr BETWEEN low AND high`. */
-  between(low, high) {
-    return new Sql(`${this.text} BETWEEN ${lit(low)} AND ${lit(high)}`);
-  }
-  /** `expr = value`. */
-  eq(value) {
-    return this.compare("=", value);
-  }
-  /** `expr > value`. */
-  gt(value) {
-    return this.compare(">", value);
-  }
-  /** `expr >= value`. */
-  gte(value) {
-    return this.compare(">=", value);
-  }
-  /** `expr < value`. */
-  lt(value) {
-    return this.compare("<", value);
-  }
-  /** `expr &lt;= value`. */
-  lte(value) {
-    return this.compare("<=", value);
-  }
-  compare(operator, value) {
-    return new Sql(`${this.text} ${operator} ${lit(value)}`);
-  }
-}
-
-export { WindowExpression as default };

package/dist/packem_shared/WindowFunction-DrnuZUF6.mjs

@@ -1,82 +0,0 @@
-import { renderOrderTerm } from './asc-DZbQCxh1.mjs';
-import { lit, toText } from './Sql-B3zq2YGx.mjs';
-import WindowExpression from './WindowExpression-BT_uA6g1.mjs';
-
-const toArray = (value) => {
-  if (value === void 0) {
-    return [];
-  }
-  return Array.isArray(value) ? value : [value];
-};
-const renderOver = (spec) => {
-  const clauses = [];
-  const partitions = toArray(spec.partitionBy).map((part) => toText(part));
-  if (partitions.length > 0) {
-    clauses.push(`PARTITION BY ${partitions.join(", ")}`);
-  }
-  const orders = toArray(spec.orderBy).map((order) => renderOrderTerm(order));
-  if (orders.length > 0) {
-    clauses.push(`ORDER BY ${orders.join(", ")}`);
-  }
-  if (spec.frame !== void 0 && spec.frame.length > 0) {
-    clauses.push(spec.frame);
-  }
-  return `OVER (${clauses.join(" ")})`;
-};
-const offsetArguments = (column, offset, fallback) => {
-  const parts = [toText(column)];
-  if (offset !== void 0) {
-    parts.push(lit(offset));
-  }
-  if (fallback !== void 0) {
-    parts.push(lit(fallback));
-  }
-  return parts.join(", ");
-};
-class WindowFunction {
-  callText;
-  constructor(callText) {
-    this.callText = callText;
-  }
-  /** Attach the window frame, yielding a {@link WindowExpression}. */
-  over(spec = {}) {
-    return new WindowExpression(`${this.callText} ${renderOver(spec)}`);
-  }
-}
-const windowFunction = (callText) => new WindowFunction(callText);
-const fn = {
-  /** `AVG(column) OVER (...)`. */
-  avg: (column) => windowFunction(`AVG(${toText(column)})`),
-  /** `COUNT(column) OVER (...)` — omit the column for `COUNT(*)`. */
-  count: (column) => windowFunction(`COUNT(${column === void 0 ? "*" : toText(column)})`),
-  /** `CUME_DIST() OVER (...)`. */
-  cumeDist: () => windowFunction("CUME_DIST()"),
-  /** `DENSE_RANK() OVER (...)`. */
-  denseRank: () => windowFunction("DENSE_RANK()"),
-  /** `FIRST_VALUE(column) OVER (...)`. */
-  firstValue: (column) => windowFunction(`FIRST_VALUE(${toText(column)})`),
-  /** `LAG(column[, offset[, default]]) OVER (...)`. */
-  lag: (column, offset, fallback) => windowFunction(`LAG(${offsetArguments(column, offset, fallback)})`),
-  /** `LAST_VALUE(column) OVER (...)`. */
-  lastValue: (column) => windowFunction(`LAST_VALUE(${toText(column)})`),
-  /** `LEAD(column[, offset[, default]]) OVER (...)`. */
-  lead: (column, offset, fallback) => windowFunction(`LEAD(${offsetArguments(column, offset, fallback)})`),
-  /** `MAX(column) OVER (...)`. */
-  max: (column) => windowFunction(`MAX(${toText(column)})`),
-  /** `MIN(column) OVER (...)`. */
-  min: (column) => windowFunction(`MIN(${toText(column)})`),
-  /** `NTH_VALUE(column, n) OVER (...)`. */
-  nthValue: (column, n) => windowFunction(`NTH_VALUE(${toText(column)}, ${lit(n)})`),
-  /** `NTILE(buckets) OVER (...)`. */
-  ntile: (buckets) => windowFunction(`NTILE(${lit(buckets)})`),
-  /** `PERCENT_RANK() OVER (...)`. */
-  percentRank: () => windowFunction("PERCENT_RANK()"),
-  /** `RANK() OVER (...)`. */
-  rank: () => windowFunction("RANK()"),
-  /** `ROW_NUMBER() OVER (...)`. */
-  rowNumber: () => windowFunction("ROW_NUMBER()"),
-  /** `SUM(column) OVER (...)`. */
-  sum: (column) => windowFunction(`SUM(${toText(column)})`)
-};
-
-export { WindowFunction, fn };

package/dist/packem_shared/asc-DZbQCxh1.mjs

@@ -1,16 +0,0 @@
-import { Sql, toText } from './Sql-B3zq2YGx.mjs';
-
-const asc = (expr) => {
-  return { dir: "ASC", expr };
-};
-const desc = (expr) => {
-  return { dir: "DESC", expr };
-};
-const renderOrderTerm = (term) => {
-  if (typeof term === "string" || term instanceof Sql) {
-    return toText(term);
-  }
-  return `${toText(term.expr)} ${term.dir}`;
-};
-
-export { asc, desc, renderOrderTerm };

package/dist/packem_shared/buildImageDeliveryUrl-qZ7XbqTL.mjs

@@ -1,35 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-
-const ABSOLUTE_URL_RE = /^[a-z][a-z\d+\-.]*:\/\//i;
-const FORBIDDEN_VALUE_CHARS = [",", "=", "#", "?", "/"];
-const stripTrailingSlash = (value) => value.endsWith("/") ? value.slice(0, -1) : value;
-const stripLeadingSlash = (value) => value.startsWith("/") ? value.slice(1) : value;
-const serializeTransform = (transform) => Object.entries(transform).filter(([, value]) => value !== void 0 && (typeof value === "string" || typeof value === "number")).map(([key, value]) => {
-  const serialized = String(value);
-  const offendingChar = FORBIDDEN_VALUE_CHARS.find((char) => serialized.includes(char));
-  if (offendingChar !== void 0) {
-    throw new LunoraError(
-      "INTERNAL",
-      `@lunora/bindings/images: transform option \`${key}\` value \`${serialized}\` contains a \`${offendingChar}\`, which the /cdn-cgi/image/ option path cannot represent (\`,\`/\`=\` are the option/key-value separators; \`#\`/\`?\`/\`/\` are URL-structural). Percent-encode the value — for colors use \`%23RRGGBB\`, not \`#RRGGBB\` or \`rgb(r,g,b)\`.`
-    );
-  }
-  return `${key}=${serialized}`;
-}).join(",");
-const encodeKey = (key) => key.split("/").map((segment) => encodeURIComponent(segment)).join("/");
-const buildImageDeliveryUrl = (options) => {
-  const base = stripTrailingSlash(options.baseUrl);
-  if (options.imageId !== void 0) {
-    const variant = options.variant ?? "public";
-    return `${base}/${encodeURIComponent(options.imageId)}/${encodeURIComponent(variant)}`;
-  }
-  if (options.key === void 0) {
-    throw new LunoraError("INTERNAL", "@lunora/bindings/images: buildImageDeliveryUrl requires either `imageId` or `key`");
-  }
-  const optionString = options.transform === void 0 ? "" : serializeTransform(options.transform);
-  const isAbsolute = ABSOLUTE_URL_RE.test(options.key);
-  const source = isAbsolute ? options.key : `/${encodeKey(stripLeadingSlash(options.key))}`;
-  const prefix = optionString === "" ? "/cdn-cgi/image" : `/cdn-cgi/image/${optionString}`;
-  return `${base}${prefix}${source.startsWith("/") ? source : `/${source}`}`;
-};
-
-export { buildImageDeliveryUrl };