@kalada/core 0.0.0

package/dist/kuery-v1/inspect.js

@@ -0,0 +1,160 @@
+import { ExpressionFailure } from './result.js';
+
+const UNSAFE_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+function dataProperties(input, path, allowed, maxProperties, maxKeyLength) {
+  if (!isPlainObject(input)) throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+  try {
+    return readDataProperties(input, path, allowed, maxProperties, maxKeyLength);
+  } catch (error) {
+    if (error instanceof ExpressionFailure) throw error;
+    throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+  }
+}
+function readDataProperties(input, path, allowed, maxProperties, maxKeyLength) {
+  const keys = Reflect.ownKeys(input);
+  if (maxProperties !== void 0 && keys.length > maxProperties) {
+    throw new ExpressionFailure("EXPRESSION_LIMIT_EXCEEDED", path);
+  }
+  const output = {};
+  for (const key of keys) {
+    if (typeof key !== "string") {
+      throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", [...path, String(key)]);
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(input, key);
+    if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+      throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", [...path, key]);
+    }
+    if (maxKeyLength !== void 0 && exceedsStringLimit(key, maxKeyLength)) {
+      throw new ExpressionFailure("EXPRESSION_LIMIT_EXCEEDED", [...path, key]);
+    }
+    if (UNSAFE_KEYS.has(key) || allowed && !allowed.has(key)) {
+      throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", [...path, key]);
+    }
+    Object.defineProperty(output, key, {
+      value: descriptor.value,
+      enumerable: true,
+      writable: true
+    });
+  }
+  return output;
+}
+function isPlainObject(input) {
+  if (typeof input !== "object" || input === null || Array.isArray(input)) return false;
+  try {
+    const prototype = Object.getPrototypeOf(input);
+    return prototype === Object.prototype || prototype === null;
+  } catch {
+    return false;
+  }
+}
+function cloneJson(input, path, depth, state) {
+  countValue(input, path, depth, state);
+  if (input === null || typeof input === "boolean") return input;
+  if (typeof input === "number") return input;
+  if (typeof input === "string") return cloneString(input, path, state.maxStringLength);
+  if (Array.isArray(input)) return cloneArray(input, path, depth, state);
+  return cloneObject(input, path, depth, state);
+}
+function countValue(input, path, depth, state) {
+  state.nodes += 1;
+  if (depth > state.maxDepth || state.nodes > state.maxNodes) {
+    throw new ExpressionFailure("EXPRESSION_LIMIT_EXCEEDED", path);
+  }
+  if (typeof input === "number" && !Number.isFinite(input)) {
+    throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+  }
+  if (input === null || ["boolean", "number", "string"].includes(typeof input)) return;
+  if (typeof input !== "object") throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+}
+function cloneString(input, path, maxLength) {
+  if (exceedsStringLimit(input, maxLength))
+    throw new ExpressionFailure("EXPRESSION_LIMIT_EXCEEDED", path);
+  return input;
+}
+function exceedsStringLimit(input, maxLength) {
+  let length = 0;
+  for (const _codePoint of input) {
+    length += 1;
+    if (length > maxLength) return true;
+  }
+  return false;
+}
+function cloneArray(input, path, depth, state) {
+  enter(input, path, state);
+  try {
+    const length = arrayLength(input, path);
+    if (length > state.maxNodes - state.nodes) {
+      throw new ExpressionFailure("EXPRESSION_LIMIT_EXCEEDED", path);
+    }
+    const keys = Reflect.ownKeys(input);
+    if (keys.some(
+      (key) => typeof key === "symbol" || key !== "length" && !isArrayIndex(key, length)
+    )) {
+      throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+    }
+    const values = [];
+    for (let index = 0; index < length; index += 1) {
+      const descriptor = Object.getOwnPropertyDescriptor(input, String(index));
+      if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+        throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", [...path, index]);
+      }
+      values.push(cloneJson(descriptor.value, [...path, index], depth + 1, state));
+    }
+    return Object.freeze(values);
+  } catch (error) {
+    if (error instanceof ExpressionFailure) throw error;
+    throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+  } finally {
+    state.active.delete(input);
+  }
+}
+function cloneObject(input, path, depth, state) {
+  enter(input, path, state);
+  try {
+    const properties = dataProperties(
+      input,
+      path,
+      void 0,
+      state.maxNodes - state.nodes,
+      state.maxStringLength
+    );
+    const output = {};
+    for (const key of Object.keys(properties).sort()) {
+      Object.defineProperty(output, key, {
+        value: cloneJson(properties[key], [...path, key], depth + 1, state),
+        enumerable: true
+      });
+    }
+    return Object.freeze(output);
+  } finally {
+    state.active.delete(input);
+  }
+}
+function arrayLength(input, path) {
+  try {
+    const descriptor = Object.getOwnPropertyDescriptor(input, "length");
+    if (!descriptor || !("value" in descriptor) || !Number.isSafeInteger(descriptor.value) || descriptor.value < 0 || descriptor.value > 4294967295) {
+      throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+    }
+    return descriptor.value;
+  } catch (error) {
+    if (error instanceof ExpressionFailure) throw error;
+    throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+  }
+}
+function enter(input, path, state) {
+  if (state.active.has(input)) throw new ExpressionFailure("EXPRESSION_INVALID_INPUT", path);
+  state.active.add(input);
+}
+function isArrayIndex(key, length) {
+  if (!/^(0|[1-9]\d*)$/.test(key)) return false;
+  const index = Number(key);
+  return Number.isSafeInteger(index) && index < length;
+}
+function stableJson(value) {
+  return JSON.stringify(value);
+}
+
+export { UNSAFE_KEYS, arrayLength, cloneJson, dataProperties, exceedsStringLimit, stableJson };
+//# sourceMappingURL=inspect.js.map
+//# sourceMappingURL=inspect.js.map

package/dist/kuery-v1/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kuery-v1/inspect.ts"],"names":[],"mappings":"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","file":"inspect.js","sourcesContent":["import { ExpressionFailure } from \"./result.js\";\nimport type { ExpressionPath, JsonObject, JsonValue } from \"./types.js\";\n\nexport const UNSAFE_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\nexport interface ValidationState {\n  readonly maxDepth: number;\n  readonly maxNodes: number;\n  readonly maxStringLength: number;\n  nodes: number;\n  readonly active: WeakSet<object>;\n}\n\nexport function dataProperties(\n  input: unknown,\n  path: ExpressionPath,\n  allowed?: ReadonlySet<string>,\n  maxProperties?: number,\n  maxKeyLength?: number,\n): Readonly<Record<string, unknown>> {\n  if (!isPlainObject(input)) throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n  try {\n    return readDataProperties(input, path, allowed, maxProperties, maxKeyLength);\n  } catch (error) {\n    if (error instanceof ExpressionFailure) throw error;\n    throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n  }\n}\n\nfunction readDataProperties(\n  input: object,\n  path: ExpressionPath,\n  allowed?: ReadonlySet<string>,\n  maxProperties?: number,\n  maxKeyLength?: number,\n): Readonly<Record<string, unknown>> {\n  const keys = Reflect.ownKeys(input);\n  if (maxProperties !== undefined && keys.length > maxProperties) {\n    throw new ExpressionFailure(\"EXPRESSION_LIMIT_EXCEEDED\", path);\n  }\n  const output: Record<string, unknown> = {};\n  for (const key of keys) {\n    if (typeof key !== \"string\") {\n      throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", [...path, String(key)]);\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(input, key);\n    if (!descriptor || !(\"value\" in descriptor) || !descriptor.enumerable) {\n      throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", [...path, key]);\n    }\n    if (maxKeyLength !== undefined && exceedsStringLimit(key, maxKeyLength)) {\n      throw new ExpressionFailure(\"EXPRESSION_LIMIT_EXCEEDED\", [...path, key]);\n    }\n    if (UNSAFE_KEYS.has(key) || (allowed && !allowed.has(key))) {\n      throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", [...path, key]);\n    }\n    Object.defineProperty(output, key, {\n      value: descriptor.value,\n      enumerable: true,\n      writable: true,\n    });\n  }\n  return output;\n}\n\nfunction isPlainObject(input: unknown): input is object {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) return false;\n  try {\n    const prototype = Object.getPrototypeOf(input);\n    return prototype === Object.prototype || prototype === null;\n  } catch {\n    return false;\n  }\n}\n\nexport function cloneJson(\n  input: unknown,\n  path: ExpressionPath,\n  depth: number,\n  state: ValidationState,\n): JsonValue {\n  countValue(input, path, depth, state);\n  if (input === null || typeof input === \"boolean\") return input;\n  if (typeof input === \"number\") return input;\n  if (typeof input === \"string\") return cloneString(input, path, state.maxStringLength);\n  if (Array.isArray(input)) return cloneArray(input, path, depth, state);\n  return cloneObject(input as object, path, depth, state);\n}\n\nfunction countValue(\n  input: unknown,\n  path: ExpressionPath,\n  depth: number,\n  state: ValidationState,\n): void {\n  state.nodes += 1;\n  if (depth > state.maxDepth || state.nodes > state.maxNodes) {\n    throw new ExpressionFailure(\"EXPRESSION_LIMIT_EXCEEDED\", path);\n  }\n  if (typeof input === \"number\" && !Number.isFinite(input)) {\n    throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n  }\n  if (input === null || [\"boolean\", \"number\", \"string\"].includes(typeof input)) return;\n  if (typeof input !== \"object\") throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n}\n\nfunction cloneString(input: string, path: ExpressionPath, maxLength: number): string {\n  if (exceedsStringLimit(input, maxLength))\n    throw new ExpressionFailure(\"EXPRESSION_LIMIT_EXCEEDED\", path);\n  return input;\n}\n\nexport function exceedsStringLimit(input: string, maxLength: number): boolean {\n  let length = 0;\n  for (const _codePoint of input) {\n    length += 1;\n    if (length > maxLength) return true;\n  }\n  return false;\n}\n\nfunction cloneArray(\n  input: unknown[],\n  path: ExpressionPath,\n  depth: number,\n  state: ValidationState,\n): JsonValue {\n  enter(input, path, state);\n  try {\n    const length = arrayLength(input, path);\n    if (length > state.maxNodes - state.nodes) {\n      throw new ExpressionFailure(\"EXPRESSION_LIMIT_EXCEEDED\", path);\n    }\n    const keys = Reflect.ownKeys(input);\n    if (\n      keys.some(\n        (key) => typeof key === \"symbol\" || (key !== \"length\" && !isArrayIndex(key, length)),\n      )\n    ) {\n      throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n    }\n    const values: JsonValue[] = [];\n    for (let index = 0; index < length; index += 1) {\n      const descriptor = Object.getOwnPropertyDescriptor(input, String(index));\n      if (!descriptor || !(\"value\" in descriptor) || !descriptor.enumerable) {\n        throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", [...path, index]);\n      }\n      values.push(cloneJson(descriptor.value, [...path, index], depth + 1, state));\n    }\n    return Object.freeze(values);\n  } catch (error) {\n    if (error instanceof ExpressionFailure) throw error;\n    throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n  } finally {\n    state.active.delete(input);\n  }\n}\n\nfunction cloneObject(\n  input: object,\n  path: ExpressionPath,\n  depth: number,\n  state: ValidationState,\n): JsonObject {\n  enter(input, path, state);\n  try {\n    const properties = dataProperties(\n      input,\n      path,\n      undefined,\n      state.maxNodes - state.nodes,\n      state.maxStringLength,\n    );\n    const output: Record<string, JsonValue> = {};\n    for (const key of Object.keys(properties).sort()) {\n      Object.defineProperty(output, key, {\n        value: cloneJson(properties[key], [...path, key], depth + 1, state),\n        enumerable: true,\n      });\n    }\n    return Object.freeze(output);\n  } finally {\n    state.active.delete(input);\n  }\n}\n\nexport function arrayLength(input: unknown[], path: ExpressionPath): number {\n  try {\n    const descriptor = Object.getOwnPropertyDescriptor(input, \"length\");\n    if (\n      !descriptor ||\n      !(\"value\" in descriptor) ||\n      !Number.isSafeInteger(descriptor.value) ||\n      descriptor.value < 0 ||\n      descriptor.value > 0xffff_ffff\n    ) {\n      throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n    }\n    return descriptor.value as number;\n  } catch (error) {\n    if (error instanceof ExpressionFailure) throw error;\n    throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n  }\n}\n\nfunction enter(input: object, path: ExpressionPath, state: ValidationState): void {\n  if (state.active.has(input)) throw new ExpressionFailure(\"EXPRESSION_INVALID_INPUT\", path);\n  state.active.add(input);\n}\n\nfunction isArrayIndex(key: string, length: number): boolean {\n  if (!/^(0|[1-9]\\d*)$/.test(key)) return false;\n  const index = Number(key);\n  return Number.isSafeInteger(index) && index < length;\n}\n\nexport function stableJson(value: JsonValue): string {\n  return JSON.stringify(value);\n}\n"]}

package/dist/kuery-v1/json-schema.cjs

@@ -0,0 +1,108 @@
+'use strict';
+
+var limits_js = require('./limits.js');
+var profile_js = require('./profile.js');
+var standardProfile_js = require('./standard-profile.js');
+
+const jsonValueSchema = deepFreeze({
+  anyOf: [
+    { type: "null" },
+    { type: "boolean" },
+    { type: "number", minimum: -17976931348623157e292, maximum: 17976931348623157e292 },
+    { type: "string", maxLength: limits_js.DEFAULT_EXPRESSION_LIMITS.maxStringLength },
+    {
+      type: "array",
+      maxItems: limits_js.DEFAULT_EXPRESSION_LIMITS.maxNodes,
+      items: { $ref: "#/$defs/jsonValue" }
+    },
+    {
+      type: "object",
+      maxProperties: limits_js.DEFAULT_EXPRESSION_LIMITS.maxNodes,
+      propertyNames: {
+        allOf: [
+          { maxLength: limits_js.DEFAULT_EXPRESSION_LIMITS.maxStringLength },
+          { not: { enum: ["__proto__", "constructor", "prototype"] } }
+        ]
+      },
+      additionalProperties: { $ref: "#/$defs/jsonValue" }
+    }
+  ]
+});
+function generateExpressionJsonSchema(profile) {
+  if (!(profile instanceof profile_js.ExpressionProfile))
+    throw new TypeError("An expression profile is required.");
+  const operatorSchemas = profile.definitions.map(operatorSchema);
+  return deepFreeze({
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: `https://kuery.dev/schema/expression/${encodeURIComponent(profile.name)}`,
+    $comment: "This schema enforces recursive shape and profile constraints only; aggregate maxNodes and maxDepth limits are runtime-authoritative during canonicalization and compilation.",
+    $ref: "#/$defs/expression",
+    $defs: {
+      jsonValue: jsonValueSchema,
+      expression: {
+        oneOf: [
+          literalSchema(),
+          referenceSchema(),
+          ...operatorSchemas.length ? operatorSchemas : [neverSchema()]
+        ]
+      }
+    }
+  });
+}
+function neverSchema() {
+  return false;
+}
+function getStandardExpressionJsonSchema() {
+  return generateExpressionJsonSchema(standardProfile_js.standardV1);
+}
+function literalSchema() {
+  return {
+    type: "object",
+    properties: { kind: { const: "literal" }, value: { $ref: "#/$defs/jsonValue" } },
+    required: ["kind", "value"],
+    additionalProperties: false
+  };
+}
+function referenceSchema() {
+  return {
+    type: "object",
+    properties: {
+      kind: { const: "ref" },
+      ref: {
+        type: "string",
+        minLength: 1,
+        maxLength: limits_js.DEFAULT_EXPRESSION_LIMITS.maxReferenceLength
+      }
+    },
+    required: ["kind", "ref"],
+    additionalProperties: false
+  };
+}
+function operatorSchema(operator) {
+  const args = {
+    type: "array",
+    items: { $ref: "#/$defs/expression" },
+    minItems: operator.arity ?? operator.minArgs ?? 0,
+    maxItems: operator.arity ?? operator.maxArgs ?? profile_js.MAX_EXPRESSION_OPERATOR_ARGS
+  };
+  return {
+    type: "object",
+    properties: {
+      kind: { const: "op" },
+      op: { const: operator.name },
+      args
+    },
+    required: ["kind", "op", "args"],
+    additionalProperties: false
+  };
+}
+function deepFreeze(value) {
+  if (typeof value !== "object" || value === null) return value;
+  for (const child of Object.values(value)) deepFreeze(child);
+  return Object.isFrozen(value) ? value : Object.freeze(value);
+}
+
+exports.generateExpressionJsonSchema = generateExpressionJsonSchema;
+exports.getStandardExpressionJsonSchema = getStandardExpressionJsonSchema;
+//# sourceMappingURL=json-schema.cjs.map
+//# sourceMappingURL=json-schema.cjs.map

package/dist/kuery-v1/json-schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kuery-v1/json-schema.ts"],"names":["DEFAULT_EXPRESSION_LIMITS","ExpressionProfile","standardV1","MAX_EXPRESSION_OPERATOR_ARGS"],"mappings":"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","file":"json-schema.cjs","sourcesContent":["import { DEFAULT_EXPRESSION_LIMITS } from \"./limits.js\";\nimport {\n  type ExpressionOperator,\n  ExpressionProfile,\n  MAX_EXPRESSION_OPERATOR_ARGS,\n} from \"./profile.js\";\nimport { standardV1 } from \"./standard-profile.js\";\n\nexport type ExpressionJsonSchema = Readonly<Record<string, unknown>>;\n\nconst jsonValueSchema = deepFreeze({\n  anyOf: [\n    { type: \"null\" },\n    { type: \"boolean\" },\n    { type: \"number\", minimum: -1.7976931348623157e308, maximum: 1.7976931348623157e308 },\n    { type: \"string\", maxLength: DEFAULT_EXPRESSION_LIMITS.maxStringLength },\n    {\n      type: \"array\",\n      maxItems: DEFAULT_EXPRESSION_LIMITS.maxNodes,\n      items: { $ref: \"#/$defs/jsonValue\" },\n    },\n    {\n      type: \"object\",\n      maxProperties: DEFAULT_EXPRESSION_LIMITS.maxNodes,\n      propertyNames: {\n        allOf: [\n          { maxLength: DEFAULT_EXPRESSION_LIMITS.maxStringLength },\n          { not: { enum: [\"__proto__\", \"constructor\", \"prototype\"] } },\n        ],\n      },\n      additionalProperties: { $ref: \"#/$defs/jsonValue\" },\n    },\n  ],\n});\n\n/** Generate a strict JSON Schema from one profile's public operator metadata. */\nexport function generateExpressionJsonSchema(profile: ExpressionProfile): ExpressionJsonSchema {\n  if (!(profile instanceof ExpressionProfile))\n    throw new TypeError(\"An expression profile is required.\");\n  const operatorSchemas = profile.definitions.map(operatorSchema);\n  return deepFreeze({\n    $schema: \"https://json-schema.org/draft/2020-12/schema\",\n    $id: `https://kuery.dev/schema/expression/${encodeURIComponent(profile.name)}`,\n    $comment:\n      \"This schema enforces recursive shape and profile constraints only; aggregate maxNodes and maxDepth limits are runtime-authoritative during canonicalization and compilation.\",\n    $ref: \"#/$defs/expression\",\n    $defs: {\n      jsonValue: jsonValueSchema,\n      expression: {\n        oneOf: [\n          literalSchema(),\n          referenceSchema(),\n          ...(operatorSchemas.length ? operatorSchemas : [neverSchema()]),\n        ],\n      },\n    },\n  });\n}\n\nfunction neverSchema(): false {\n  return false;\n}\n\n/** Strict schema for the built-in standard-v1 profile and default string references. */\nexport function getStandardExpressionJsonSchema(): ExpressionJsonSchema {\n  return generateExpressionJsonSchema(standardV1);\n}\n\nfunction literalSchema(): Record<string, unknown> {\n  return {\n    type: \"object\",\n    properties: { kind: { const: \"literal\" }, value: { $ref: \"#/$defs/jsonValue\" } },\n    required: [\"kind\", \"value\"],\n    additionalProperties: false,\n  };\n}\n\nfunction referenceSchema(): Record<string, unknown> {\n  return {\n    type: \"object\",\n    properties: {\n      kind: { const: \"ref\" },\n      ref: {\n        type: \"string\",\n        minLength: 1,\n        maxLength: DEFAULT_EXPRESSION_LIMITS.maxReferenceLength,\n      },\n    },\n    required: [\"kind\", \"ref\"],\n    additionalProperties: false,\n  };\n}\n\nfunction operatorSchema(operator: ExpressionOperator): Record<string, unknown> {\n  const args: Record<string, unknown> = {\n    type: \"array\",\n    items: { $ref: \"#/$defs/expression\" },\n    minItems: operator.arity ?? operator.minArgs ?? 0,\n    maxItems: operator.arity ?? operator.maxArgs ?? MAX_EXPRESSION_OPERATOR_ARGS,\n  };\n  return {\n    type: \"object\",\n    properties: {\n      kind: { const: \"op\" },\n      op: { const: operator.name },\n      args,\n    },\n    required: [\"kind\", \"op\", \"args\"],\n    additionalProperties: false,\n  };\n}\n\nfunction deepFreeze<T>(value: T): T {\n  if (typeof value !== \"object\" || value === null) return value;\n  for (const child of Object.values(value)) deepFreeze(child);\n  return Object.isFrozen(value) ? value : Object.freeze(value);\n}\n"]}

package/dist/kuery-v1/json-schema.d.cts

@@ -0,0 +1,10 @@
+import { ExpressionProfile } from './profile.cjs';
+import './types.cjs';
+
+type ExpressionJsonSchema = Readonly<Record<string, unknown>>;
+/** Generate a strict JSON Schema from one profile's public operator metadata. */
+declare function generateExpressionJsonSchema(profile: ExpressionProfile): ExpressionJsonSchema;
+/** Strict schema for the built-in standard-v1 profile and default string references. */
+declare function getStandardExpressionJsonSchema(): ExpressionJsonSchema;
+
+export { type ExpressionJsonSchema, generateExpressionJsonSchema, getStandardExpressionJsonSchema };

package/dist/kuery-v1/json-schema.d.ts

@@ -0,0 +1,10 @@
+import { ExpressionProfile } from './profile.js';
+import './types.js';
+
+type ExpressionJsonSchema = Readonly<Record<string, unknown>>;
+/** Generate a strict JSON Schema from one profile's public operator metadata. */
+declare function generateExpressionJsonSchema(profile: ExpressionProfile): ExpressionJsonSchema;
+/** Strict schema for the built-in standard-v1 profile and default string references. */
+declare function getStandardExpressionJsonSchema(): ExpressionJsonSchema;
+
+export { type ExpressionJsonSchema, generateExpressionJsonSchema, getStandardExpressionJsonSchema };

package/dist/kuery-v1/json-schema.js

@@ -0,0 +1,105 @@
+import { DEFAULT_EXPRESSION_LIMITS } from './limits.js';
+import { ExpressionProfile, MAX_EXPRESSION_OPERATOR_ARGS } from './profile.js';
+import { standardV1 } from './standard-profile.js';
+
+const jsonValueSchema = deepFreeze({
+  anyOf: [
+    { type: "null" },
+    { type: "boolean" },
+    { type: "number", minimum: -17976931348623157e292, maximum: 17976931348623157e292 },
+    { type: "string", maxLength: DEFAULT_EXPRESSION_LIMITS.maxStringLength },
+    {
+      type: "array",
+      maxItems: DEFAULT_EXPRESSION_LIMITS.maxNodes,
+      items: { $ref: "#/$defs/jsonValue" }
+    },
+    {
+      type: "object",
+      maxProperties: DEFAULT_EXPRESSION_LIMITS.maxNodes,
+      propertyNames: {
+        allOf: [
+          { maxLength: DEFAULT_EXPRESSION_LIMITS.maxStringLength },
+          { not: { enum: ["__proto__", "constructor", "prototype"] } }
+        ]
+      },
+      additionalProperties: { $ref: "#/$defs/jsonValue" }
+    }
+  ]
+});
+function generateExpressionJsonSchema(profile) {
+  if (!(profile instanceof ExpressionProfile))
+    throw new TypeError("An expression profile is required.");
+  const operatorSchemas = profile.definitions.map(operatorSchema);
+  return deepFreeze({
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: `https://kuery.dev/schema/expression/${encodeURIComponent(profile.name)}`,
+    $comment: "This schema enforces recursive shape and profile constraints only; aggregate maxNodes and maxDepth limits are runtime-authoritative during canonicalization and compilation.",
+    $ref: "#/$defs/expression",
+    $defs: {
+      jsonValue: jsonValueSchema,
+      expression: {
+        oneOf: [
+          literalSchema(),
+          referenceSchema(),
+          ...operatorSchemas.length ? operatorSchemas : [neverSchema()]
+        ]
+      }
+    }
+  });
+}
+function neverSchema() {
+  return false;
+}
+function getStandardExpressionJsonSchema() {
+  return generateExpressionJsonSchema(standardV1);
+}
+function literalSchema() {
+  return {
+    type: "object",
+    properties: { kind: { const: "literal" }, value: { $ref: "#/$defs/jsonValue" } },
+    required: ["kind", "value"],
+    additionalProperties: false
+  };
+}
+function referenceSchema() {
+  return {
+    type: "object",
+    properties: {
+      kind: { const: "ref" },
+      ref: {
+        type: "string",
+        minLength: 1,
+        maxLength: DEFAULT_EXPRESSION_LIMITS.maxReferenceLength
+      }
+    },
+    required: ["kind", "ref"],
+    additionalProperties: false
+  };
+}
+function operatorSchema(operator) {
+  const args = {
+    type: "array",
+    items: { $ref: "#/$defs/expression" },
+    minItems: operator.arity ?? operator.minArgs ?? 0,
+    maxItems: operator.arity ?? operator.maxArgs ?? MAX_EXPRESSION_OPERATOR_ARGS
+  };
+  return {
+    type: "object",
+    properties: {
+      kind: { const: "op" },
+      op: { const: operator.name },
+      args
+    },
+    required: ["kind", "op", "args"],
+    additionalProperties: false
+  };
+}
+function deepFreeze(value) {
+  if (typeof value !== "object" || value === null) return value;
+  for (const child of Object.values(value)) deepFreeze(child);
+  return Object.isFrozen(value) ? value : Object.freeze(value);
+}
+
+export { generateExpressionJsonSchema, getStandardExpressionJsonSchema };
+//# sourceMappingURL=json-schema.js.map
+//# sourceMappingURL=json-schema.js.map

package/dist/kuery-v1/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kuery-v1/json-schema.ts"],"names":[],"mappings":"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","file":"json-schema.js","sourcesContent":["import { DEFAULT_EXPRESSION_LIMITS } from \"./limits.js\";\nimport {\n  type ExpressionOperator,\n  ExpressionProfile,\n  MAX_EXPRESSION_OPERATOR_ARGS,\n} from \"./profile.js\";\nimport { standardV1 } from \"./standard-profile.js\";\n\nexport type ExpressionJsonSchema = Readonly<Record<string, unknown>>;\n\nconst jsonValueSchema = deepFreeze({\n  anyOf: [\n    { type: \"null\" },\n    { type: \"boolean\" },\n    { type: \"number\", minimum: -1.7976931348623157e308, maximum: 1.7976931348623157e308 },\n    { type: \"string\", maxLength: DEFAULT_EXPRESSION_LIMITS.maxStringLength },\n    {\n      type: \"array\",\n      maxItems: DEFAULT_EXPRESSION_LIMITS.maxNodes,\n      items: { $ref: \"#/$defs/jsonValue\" },\n    },\n    {\n      type: \"object\",\n      maxProperties: DEFAULT_EXPRESSION_LIMITS.maxNodes,\n      propertyNames: {\n        allOf: [\n          { maxLength: DEFAULT_EXPRESSION_LIMITS.maxStringLength },\n          { not: { enum: [\"__proto__\", \"constructor\", \"prototype\"] } },\n        ],\n      },\n      additionalProperties: { $ref: \"#/$defs/jsonValue\" },\n    },\n  ],\n});\n\n/** Generate a strict JSON Schema from one profile's public operator metadata. */\nexport function generateExpressionJsonSchema(profile: ExpressionProfile): ExpressionJsonSchema {\n  if (!(profile instanceof ExpressionProfile))\n    throw new TypeError(\"An expression profile is required.\");\n  const operatorSchemas = profile.definitions.map(operatorSchema);\n  return deepFreeze({\n    $schema: \"https://json-schema.org/draft/2020-12/schema\",\n    $id: `https://kuery.dev/schema/expression/${encodeURIComponent(profile.name)}`,\n    $comment:\n      \"This schema enforces recursive shape and profile constraints only; aggregate maxNodes and maxDepth limits are runtime-authoritative during canonicalization and compilation.\",\n    $ref: \"#/$defs/expression\",\n    $defs: {\n      jsonValue: jsonValueSchema,\n      expression: {\n        oneOf: [\n          literalSchema(),\n          referenceSchema(),\n          ...(operatorSchemas.length ? operatorSchemas : [neverSchema()]),\n        ],\n      },\n    },\n  });\n}\n\nfunction neverSchema(): false {\n  return false;\n}\n\n/** Strict schema for the built-in standard-v1 profile and default string references. */\nexport function getStandardExpressionJsonSchema(): ExpressionJsonSchema {\n  return generateExpressionJsonSchema(standardV1);\n}\n\nfunction literalSchema(): Record<string, unknown> {\n  return {\n    type: \"object\",\n    properties: { kind: { const: \"literal\" }, value: { $ref: \"#/$defs/jsonValue\" } },\n    required: [\"kind\", \"value\"],\n    additionalProperties: false,\n  };\n}\n\nfunction referenceSchema(): Record<string, unknown> {\n  return {\n    type: \"object\",\n    properties: {\n      kind: { const: \"ref\" },\n      ref: {\n        type: \"string\",\n        minLength: 1,\n        maxLength: DEFAULT_EXPRESSION_LIMITS.maxReferenceLength,\n      },\n    },\n    required: [\"kind\", \"ref\"],\n    additionalProperties: false,\n  };\n}\n\nfunction operatorSchema(operator: ExpressionOperator): Record<string, unknown> {\n  const args: Record<string, unknown> = {\n    type: \"array\",\n    items: { $ref: \"#/$defs/expression\" },\n    minItems: operator.arity ?? operator.minArgs ?? 0,\n    maxItems: operator.arity ?? operator.maxArgs ?? MAX_EXPRESSION_OPERATOR_ARGS,\n  };\n  return {\n    type: \"object\",\n    properties: {\n      kind: { const: \"op\" },\n      op: { const: operator.name },\n      args,\n    },\n    required: [\"kind\", \"op\", \"args\"],\n    additionalProperties: false,\n  };\n}\n\nfunction deepFreeze<T>(value: T): T {\n  if (typeof value !== \"object\" || value === null) return value;\n  for (const child of Object.values(value)) deepFreeze(child);\n  return Object.isFrozen(value) ? value : Object.freeze(value);\n}\n"]}

package/dist/kuery-v1/limits.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+var profile_js = require('./profile.js');
+
+const DEFAULT_EXPRESSION_LIMITS = Object.freeze({
+  maxDepth: 64,
+  maxNodes: 1e4,
+  maxArgs: profile_js.MAX_EXPRESSION_OPERATOR_ARGS,
+  maxStringLength: 1e4,
+  maxReferenceLength: 1e3,
+  maxEvaluationSteps: 1e4
+});
+const MAX_EXPRESSION_LIMITS = Object.freeze({
+  maxDepth: 256,
+  maxNodes: 1e5,
+  maxArgs: profile_js.MAX_EXPRESSION_OPERATOR_ARGS,
+  maxStringLength: 1e6,
+  maxReferenceLength: 1e5,
+  maxEvaluationSteps: 1e5
+});
+function resolveLimits(input) {
+  const limits = { ...DEFAULT_EXPRESSION_LIMITS, ...input };
+  for (const key of Object.keys(limits)) {
+    const value = limits[key];
+    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_EXPRESSION_LIMITS[key]) {
+      throw new TypeError("Expression limits must be positive safe integers.");
+    }
+  }
+  return Object.freeze(limits);
+}
+
+exports.DEFAULT_EXPRESSION_LIMITS = DEFAULT_EXPRESSION_LIMITS;
+exports.resolveLimits = resolveLimits;
+//# sourceMappingURL=limits.cjs.map
+//# sourceMappingURL=limits.cjs.map

package/dist/kuery-v1/limits.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kuery-v1/limits.ts"],"names":["MAX_EXPRESSION_OPERATOR_ARGS"],"mappings":";;;;AAGO,MAAM,yBAAA,GAA8C,OAAO,MAAA,CAAO;AAAA,EACvE,QAAA,EAAU,EAAA;AAAA,EACV,QAAA,EAAU,GAAA;AAAA,EACV,OAAA,EAASA,uCAAA;AAAA,EACT,eAAA,EAAiB,GAAA;AAAA,EACjB,kBAAA,EAAoB,GAAA;AAAA,EACpB,kBAAA,EAAoB;AACtB,CAAC;AAED,MAAM,qBAAA,GAA0C,OAAO,MAAA,CAAO;AAAA,EAC5D,QAAA,EAAU,GAAA;AAAA,EACV,QAAA,EAAU,GAAA;AAAA,EACV,OAAA,EAASA,uCAAA;AAAA,EACT,eAAA,EAAiB,GAAA;AAAA,EACjB,kBAAA,EAAoB,GAAA;AAAA,EACpB,kBAAA,EAAoB;AACtB,CAAC,CAAA;AAEM,SAAS,cAAc,KAAA,EAAqD;AACjF,EAAA,MAAM,MAAA,GAAS,EAAE,GAAG,yBAAA,EAA2B,GAAG,KAAA,EAAM;AACxD,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAiC;AACnE,IAAA,MAAM,KAAA,GAAQ,OAAO,GAAG,CAAA;AACxB,IAAA,IAAI,CAAC,MAAA,CAAO,aAAA,CAAc,KAAK,CAAA,IAAK,QAAQ,CAAA,IAAK,KAAA,GAAQ,qBAAA,CAAsB,GAAG,CAAA,EAAG;AACnF,MAAA,MAAM,IAAI,UAAU,mDAAmD,CAAA;AAAA,IACzE;AAAA,EACF;AACA,EAAA,OAAO,MAAA,CAAO,OAAO,MAAM,CAAA;AAC7B","file":"limits.cjs","sourcesContent":["import { MAX_EXPRESSION_OPERATOR_ARGS } from \"./profile.js\";\nimport type { ExpressionLimits } from \"./types.js\";\n\nexport const DEFAULT_EXPRESSION_LIMITS: ExpressionLimits = Object.freeze({\n  maxDepth: 64,\n  maxNodes: 10_000,\n  maxArgs: MAX_EXPRESSION_OPERATOR_ARGS,\n  maxStringLength: 10_000,\n  maxReferenceLength: 1_000,\n  maxEvaluationSteps: 10_000,\n});\n\nconst MAX_EXPRESSION_LIMITS: ExpressionLimits = Object.freeze({\n  maxDepth: 256,\n  maxNodes: 100_000,\n  maxArgs: MAX_EXPRESSION_OPERATOR_ARGS,\n  maxStringLength: 1_000_000,\n  maxReferenceLength: 100_000,\n  maxEvaluationSteps: 100_000,\n});\n\nexport function resolveLimits(input?: Partial<ExpressionLimits>): ExpressionLimits {\n  const limits = { ...DEFAULT_EXPRESSION_LIMITS, ...input };\n  for (const key of Object.keys(limits) as (keyof ExpressionLimits)[]) {\n    const value = limits[key];\n    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_EXPRESSION_LIMITS[key]) {\n      throw new TypeError(\"Expression limits must be positive safe integers.\");\n    }\n  }\n  return Object.freeze(limits);\n}\n"]}

package/dist/kuery-v1/limits.d.cts

@@ -0,0 +1,6 @@
+import { ExpressionLimits } from './types.cjs';
+
+declare const DEFAULT_EXPRESSION_LIMITS: ExpressionLimits;
+declare function resolveLimits(input?: Partial<ExpressionLimits>): ExpressionLimits;
+
+export { DEFAULT_EXPRESSION_LIMITS, resolveLimits };

package/dist/kuery-v1/limits.d.ts

@@ -0,0 +1,6 @@
+import { ExpressionLimits } from './types.js';
+
+declare const DEFAULT_EXPRESSION_LIMITS: ExpressionLimits;
+declare function resolveLimits(input?: Partial<ExpressionLimits>): ExpressionLimits;
+
+export { DEFAULT_EXPRESSION_LIMITS, resolveLimits };

package/dist/kuery-v1/limits.js

@@ -0,0 +1,32 @@
+import { MAX_EXPRESSION_OPERATOR_ARGS } from './profile.js';
+
+const DEFAULT_EXPRESSION_LIMITS = Object.freeze({
+  maxDepth: 64,
+  maxNodes: 1e4,
+  maxArgs: MAX_EXPRESSION_OPERATOR_ARGS,
+  maxStringLength: 1e4,
+  maxReferenceLength: 1e3,
+  maxEvaluationSteps: 1e4
+});
+const MAX_EXPRESSION_LIMITS = Object.freeze({
+  maxDepth: 256,
+  maxNodes: 1e5,
+  maxArgs: MAX_EXPRESSION_OPERATOR_ARGS,
+  maxStringLength: 1e6,
+  maxReferenceLength: 1e5,
+  maxEvaluationSteps: 1e5
+});
+function resolveLimits(input) {
+  const limits = { ...DEFAULT_EXPRESSION_LIMITS, ...input };
+  for (const key of Object.keys(limits)) {
+    const value = limits[key];
+    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_EXPRESSION_LIMITS[key]) {
+      throw new TypeError("Expression limits must be positive safe integers.");
+    }
+  }
+  return Object.freeze(limits);
+}
+
+export { DEFAULT_EXPRESSION_LIMITS, resolveLimits };
+//# sourceMappingURL=limits.js.map
+//# sourceMappingURL=limits.js.map

package/dist/kuery-v1/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kuery-v1/limits.ts"],"names":[],"mappings":";;AAGO,MAAM,yBAAA,GAA8C,OAAO,MAAA,CAAO;AAAA,EACvE,QAAA,EAAU,EAAA;AAAA,EACV,QAAA,EAAU,GAAA;AAAA,EACV,OAAA,EAAS,4BAAA;AAAA,EACT,eAAA,EAAiB,GAAA;AAAA,EACjB,kBAAA,EAAoB,GAAA;AAAA,EACpB,kBAAA,EAAoB;AACtB,CAAC;AAED,MAAM,qBAAA,GAA0C,OAAO,MAAA,CAAO;AAAA,EAC5D,QAAA,EAAU,GAAA;AAAA,EACV,QAAA,EAAU,GAAA;AAAA,EACV,OAAA,EAAS,4BAAA;AAAA,EACT,eAAA,EAAiB,GAAA;AAAA,EACjB,kBAAA,EAAoB,GAAA;AAAA,EACpB,kBAAA,EAAoB;AACtB,CAAC,CAAA;AAEM,SAAS,cAAc,KAAA,EAAqD;AACjF,EAAA,MAAM,MAAA,GAAS,EAAE,GAAG,yBAAA,EAA2B,GAAG,KAAA,EAAM;AACxD,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAiC;AACnE,IAAA,MAAM,KAAA,GAAQ,OAAO,GAAG,CAAA;AACxB,IAAA,IAAI,CAAC,MAAA,CAAO,aAAA,CAAc,KAAK,CAAA,IAAK,QAAQ,CAAA,IAAK,KAAA,GAAQ,qBAAA,CAAsB,GAAG,CAAA,EAAG;AACnF,MAAA,MAAM,IAAI,UAAU,mDAAmD,CAAA;AAAA,IACzE;AAAA,EACF;AACA,EAAA,OAAO,MAAA,CAAO,OAAO,MAAM,CAAA;AAC7B","file":"limits.js","sourcesContent":["import { MAX_EXPRESSION_OPERATOR_ARGS } from \"./profile.js\";\nimport type { ExpressionLimits } from \"./types.js\";\n\nexport const DEFAULT_EXPRESSION_LIMITS: ExpressionLimits = Object.freeze({\n  maxDepth: 64,\n  maxNodes: 10_000,\n  maxArgs: MAX_EXPRESSION_OPERATOR_ARGS,\n  maxStringLength: 10_000,\n  maxReferenceLength: 1_000,\n  maxEvaluationSteps: 10_000,\n});\n\nconst MAX_EXPRESSION_LIMITS: ExpressionLimits = Object.freeze({\n  maxDepth: 256,\n  maxNodes: 100_000,\n  maxArgs: MAX_EXPRESSION_OPERATOR_ARGS,\n  maxStringLength: 1_000_000,\n  maxReferenceLength: 100_000,\n  maxEvaluationSteps: 100_000,\n});\n\nexport function resolveLimits(input?: Partial<ExpressionLimits>): ExpressionLimits {\n  const limits = { ...DEFAULT_EXPRESSION_LIMITS, ...input };\n  for (const key of Object.keys(limits) as (keyof ExpressionLimits)[]) {\n    const value = limits[key];\n    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_EXPRESSION_LIMITS[key]) {\n      throw new TypeError(\"Expression limits must be positive safe integers.\");\n    }\n  }\n  return Object.freeze(limits);\n}\n"]}