@kalada/core 0.0.0

package/dist/kuery-v1/profile.cjs

@@ -0,0 +1,224 @@
+'use strict';
+
+const MAX_EXPRESSION_OPERATOR_ARGS = 32;
+const OPERATOR_NAME = /^[a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;
+const NAMESPACED_OPERATOR_NAME = /^[a-z][a-z0-9-]*[.:/][a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;
+const PROFILE_NAME = /^[A-Za-z][A-Za-z0-9._:/@-]{0,127}$/;
+const EXPRESSION_VALUE_TYPES = /* @__PURE__ */ new Set([
+  "any",
+  "null",
+  "boolean",
+  "number",
+  "string",
+  "array",
+  "object"
+]);
+const PROFILE_STATE = /* @__PURE__ */ new WeakMap();
+const OPERATOR_STRATEGIES = /* @__PURE__ */ new WeakMap();
+const INVALID_INPUT_TYPES = /* @__PURE__ */ Symbol("invalid input types");
+class ExpressionProfile {
+  name;
+  constructor(name, operators) {
+    validateProfileName(name);
+    const snapshot = /* @__PURE__ */ new Map();
+    addDefinitions(operators, snapshot);
+    this.name = name;
+    PROFILE_STATE.set(this, snapshot);
+    Object.freeze(this);
+  }
+  /** Derive a new immutable profile while preserving this profile's evaluation semantics. */
+  extend(name, operators) {
+    validateProfileName(name);
+    const snapshot = new Map(profileOperators(this));
+    for (const definition of operators) {
+      const captured = captureDefinition(definition);
+      validateCustomDefinition(captured);
+      if (snapshot.has(captured.name))
+        throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+      snapshot.set(captured.name, freezeDefinition(captured));
+    }
+    return createProfileSnapshot(name, snapshot);
+  }
+  get(name) {
+    validateLookupName(name);
+    return profileOperators(this).get(name);
+  }
+  has(name) {
+    validateLookupName(name);
+    return profileOperators(this).has(name);
+  }
+  get definitions() {
+    return Object.freeze([...profileOperators(this).values()]);
+  }
+}
+function profileOperators(profile) {
+  const operators = PROFILE_STATE.get(profile);
+  if (!operators) throw new TypeError("Invalid expression profile receiver.");
+  return operators;
+}
+function addDefinitions(operators, snapshot) {
+  for (const definition of operators) {
+    const captured = captureDefinition(definition);
+    validateDefinition(captured);
+    if (snapshot.has(captured.name))
+      throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+    snapshot.set(captured.name, freezeDefinition(captured));
+  }
+}
+function createProfileSnapshot(name, operators) {
+  validateProfileName(name);
+  const profile = Object.create(ExpressionProfile.prototype);
+  const snapshot = new Map(operators);
+  Object.defineProperty(profile, "name", { value: name, enumerable: true });
+  PROFILE_STATE.set(profile, snapshot);
+  Object.freeze(profile);
+  return profile;
+}
+class ExpressionProfileBuilder {
+  definitions = /* @__PURE__ */ new Map();
+  name;
+  constructor(name) {
+    validateProfileName(name);
+    this.name = name;
+  }
+  add(definition) {
+    const captured = captureDefinition(definition);
+    validateCustomDefinition(captured);
+    if (this.definitions.has(captured.name))
+      throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+    this.definitions.set(captured.name, captured);
+    return this;
+  }
+  build() {
+    const operators = /* @__PURE__ */ new Map();
+    for (const [name, definition] of this.definitions)
+      operators.set(name, freezeDefinition(definition));
+    return createProfileSnapshot(this.name, operators);
+  }
+}
+function validateDefinition(definition) {
+  if (typeof definition.name !== "string" || !OPERATOR_NAME.test(definition.name) || typeof definition.execute !== "function") {
+    throw new TypeError("Expression operator name or implementation is invalid.");
+  }
+  const inputTypes = validatedInputTypes(definition.inputTypes);
+  validateResultType(definition.resultType);
+  const arity = definition.arity;
+  const minArgs = definition.minArgs;
+  const maxArgs = definition.maxArgs;
+  const hasExact = arity !== void 0;
+  if (hasExact === (minArgs !== void 0 || maxArgs !== void 0)) {
+    throw new TypeError("Expression operators require exact arity or min/max arity.");
+  }
+  if (hasExact) validateCount(arity);
+  if (minArgs !== void 0) validateCount(minArgs);
+  if (maxArgs !== void 0) validateCount(maxArgs);
+  if ((minArgs ?? 0) > (maxArgs ?? Number.MAX_SAFE_INTEGER)) {
+    throw new TypeError("Expression operator minimum arity exceeds maximum arity.");
+  }
+  if (inputTypes && hasExact && inputTypes.length !== arity) {
+    throw new TypeError("Expression operator input metadata must match exact arity.");
+  }
+  if (inputTypes && !hasExact && inputTypes.length !== 1) {
+    throw new TypeError("Variadic expression operators accept one repeated input type.");
+  }
+}
+function validateCustomDefinition(definition) {
+  validateDefinition(definition);
+  if (typeof definition.name !== "string" || !NAMESPACED_OPERATOR_NAME.test(definition.name)) {
+    throw new TypeError("Custom expression operators require a namespaced name.");
+  }
+}
+function validateProfileName(name) {
+  if (typeof name !== "string" || !PROFILE_NAME.test(name))
+    throw new TypeError("Expression profile name is invalid.");
+}
+function validateLookupName(name) {
+  if (typeof name !== "string")
+    throw new TypeError("Expression operator name must be a primitive string.");
+}
+function validatedInputTypes(input) {
+  if (input !== void 0 && !validInputTypes(input)) {
+    throw new TypeError("Expression operator input metadata is invalid.");
+  }
+  return input;
+}
+function validateResultType(input) {
+  if (input !== void 0 && !isExpressionValueType(input)) {
+    throw new TypeError("Expression operator result metadata is invalid.");
+  }
+}
+function validInputTypes(input) {
+  if (!Array.isArray(input)) return false;
+  for (let index = 0; index < input.length; index += 1) {
+    if (!Object.hasOwn(input, index) || !isExpressionValueType(input[index])) return false;
+  }
+  return true;
+}
+function isExpressionValueType(value) {
+  return typeof value === "string" && EXPRESSION_VALUE_TYPES.has(value);
+}
+function validateCount(value) {
+  if (!Number.isSafeInteger(value) || value < 0 || value > MAX_EXPRESSION_OPERATOR_ARGS) {
+    throw new TypeError("Expression operator arity is invalid.");
+  }
+}
+function freezeDefinition(definition) {
+  const operator = Object.freeze({
+    name: definition.name,
+    arity: definition.arity,
+    minArgs: definition.minArgs,
+    maxArgs: definition.maxArgs,
+    inputTypes: definition.inputTypes,
+    resultType: definition.resultType,
+    execute: definition.execute
+  });
+  if (definition.strategy) OPERATOR_STRATEGIES.set(operator, definition.strategy);
+  return operator;
+}
+function createStandardProfile(name, operators) {
+  const snapshot = /* @__PURE__ */ new Map();
+  for (const definition of operators) {
+    const captured = captureDefinition(definition, true);
+    validateDefinition(captured);
+    if (snapshot.has(captured.name))
+      throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+    snapshot.set(captured.name, freezeDefinition(captured));
+  }
+  return createProfileSnapshot(name, snapshot);
+}
+function getEvaluationStrategy(operator) {
+  return OPERATOR_STRATEGIES.get(operator);
+}
+const internalProfile = Object.freeze({ createStandardProfile, getEvaluationStrategy });
+function captureDefinition(definition, includeStrategy = false) {
+  const inputTypes = definition.inputTypes;
+  return Object.freeze({
+    name: definition.name,
+    arity: definition.arity,
+    minArgs: definition.minArgs,
+    maxArgs: definition.maxArgs,
+    inputTypes: captureInputTypes(inputTypes),
+    resultType: definition.resultType,
+    execute: definition.execute,
+    strategy: includeStrategy ? definition.strategy : void 0
+  });
+}
+function captureInputTypes(input) {
+  if (input === void 0 || !Array.isArray(input)) return input;
+  try {
+    const length = input.length;
+    if (length > MAX_EXPRESSION_OPERATOR_ARGS) return INVALID_INPUT_TYPES;
+    const output = [];
+    for (let index = 0; index < length; index += 1) output.push(input[index]);
+    return Object.freeze(output);
+  } catch {
+    return INVALID_INPUT_TYPES;
+  }
+}
+
+exports.ExpressionProfile = ExpressionProfile;
+exports.ExpressionProfileBuilder = ExpressionProfileBuilder;
+exports.MAX_EXPRESSION_OPERATOR_ARGS = MAX_EXPRESSION_OPERATOR_ARGS;
+exports.internalProfile = internalProfile;
+//# sourceMappingURL=profile.cjs.map
+//# sourceMappingURL=profile.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kuery-v1/profile.ts"],"names":[],"mappings":"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","file":"profile.cjs","sourcesContent":["import type { JsonValue } from \"./types.js\";\n\nexport type ExpressionValueType =\n  | \"any\"\n  | \"null\"\n  | \"boolean\"\n  | \"number\"\n  | \"string\"\n  | \"array\"\n  | \"object\";\nexport const MAX_EXPRESSION_OPERATOR_ARGS = 32;\nexport type ExpressionOperatorFn = (args: readonly JsonValue[]) => JsonValue;\ntype ExpressionEvaluationStrategy = \"and\" | \"or\" | \"coalesce\" | \"exists\" | \"if\";\n\nexport interface ExpressionOperatorDefinition {\n  readonly name: string;\n  readonly arity?: number;\n  readonly minArgs?: number;\n  readonly maxArgs?: number;\n  readonly inputTypes?: readonly ExpressionValueType[];\n  readonly resultType?: ExpressionValueType;\n  readonly execute: ExpressionOperatorFn;\n}\n\nexport interface ExpressionOperator extends ExpressionOperatorDefinition {}\n\nconst OPERATOR_NAME = /^[a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;\nconst NAMESPACED_OPERATOR_NAME = /^[a-z][a-z0-9-]*[.:/][a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;\nconst PROFILE_NAME = /^[A-Za-z][A-Za-z0-9._:/@-]{0,127}$/;\nconst EXPRESSION_VALUE_TYPES = new Set<ExpressionValueType>([\n  \"any\",\n  \"null\",\n  \"boolean\",\n  \"number\",\n  \"string\",\n  \"array\",\n  \"object\",\n]);\nconst PROFILE_STATE = new WeakMap<ExpressionProfile, ReadonlyMap<string, ExpressionOperator>>();\nconst OPERATOR_STRATEGIES = new WeakMap<ExpressionOperator, ExpressionEvaluationStrategy>();\nconst INVALID_INPUT_TYPES = Symbol(\"invalid input types\");\n\ninterface DefinitionSnapshot {\n  readonly name: unknown;\n  readonly arity: unknown;\n  readonly minArgs: unknown;\n  readonly maxArgs: unknown;\n  readonly inputTypes: unknown;\n  readonly resultType: unknown;\n  readonly execute: unknown;\n  readonly strategy: unknown;\n}\n\ntype ValidDefinitionSnapshot = DefinitionSnapshot & {\n  readonly name: string;\n  readonly arity: number | undefined;\n  readonly minArgs: number | undefined;\n  readonly maxArgs: number | undefined;\n  readonly inputTypes: readonly ExpressionValueType[] | undefined;\n  readonly resultType: ExpressionValueType | undefined;\n  readonly execute: ExpressionOperatorFn;\n  readonly strategy: ExpressionEvaluationStrategy | undefined;\n};\n/**\n * Structurally immutable snapshot of operator metadata and callback identities.\n * Callbacks are trusted host code; their closed-over or function-object state remains producer-owned.\n */\nexport class ExpressionProfile {\n  readonly name: string;\n\n  constructor(name: string, operators: Iterable<ExpressionOperatorDefinition>) {\n    validateProfileName(name);\n    const snapshot = new Map<string, ExpressionOperator>();\n    addDefinitions(operators, snapshot);\n    this.name = name;\n    PROFILE_STATE.set(this, snapshot);\n    Object.freeze(this);\n  }\n\n  /** Derive a new immutable profile while preserving this profile's evaluation semantics. */\n  extend(name: string, operators: Iterable<ExpressionOperatorDefinition>): ExpressionProfile {\n    validateProfileName(name);\n    const snapshot = new Map(profileOperators(this));\n    for (const definition of operators) {\n      const captured = captureDefinition(definition);\n      validateCustomDefinition(captured);\n      if (snapshot.has(captured.name))\n        throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n      snapshot.set(captured.name, freezeDefinition(captured));\n    }\n    return createProfileSnapshot(name, snapshot);\n  }\n\n  get(name: string): ExpressionOperator | undefined {\n    validateLookupName(name);\n    return profileOperators(this).get(name);\n  }\n\n  has(name: string): boolean {\n    validateLookupName(name);\n    return profileOperators(this).has(name);\n  }\n\n  get definitions(): readonly ExpressionOperator[] {\n    return Object.freeze([...profileOperators(this).values()]);\n  }\n}\n\nfunction profileOperators(profile: ExpressionProfile): ReadonlyMap<string, ExpressionOperator> {\n  const operators = PROFILE_STATE.get(profile);\n  if (!operators) throw new TypeError(\"Invalid expression profile receiver.\");\n  return operators;\n}\n\nfunction addDefinitions(\n  operators: Iterable<ExpressionOperatorDefinition>,\n  snapshot: Map<string, ExpressionOperator>,\n): void {\n  for (const definition of operators) {\n    const captured = captureDefinition(definition);\n    validateDefinition(captured);\n    if (snapshot.has(captured.name))\n      throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n    snapshot.set(captured.name, freezeDefinition(captured));\n  }\n}\n\nfunction createProfileSnapshot(\n  name: string,\n  operators: ReadonlyMap<string, ExpressionOperator>,\n): ExpressionProfile {\n  validateProfileName(name);\n  const profile = Object.create(ExpressionProfile.prototype) as ExpressionProfile;\n  const snapshot = new Map(operators);\n  Object.defineProperty(profile, \"name\", { value: name, enumerable: true });\n  PROFILE_STATE.set(profile, snapshot);\n  Object.freeze(profile);\n  return profile;\n}\n\n/** Mutable construction helper whose build result is an independent structural snapshot. */\nexport class ExpressionProfileBuilder {\n  private readonly definitions = new Map<string, ValidDefinitionSnapshot>();\n  private readonly name: string;\n\n  constructor(name: string) {\n    validateProfileName(name);\n    this.name = name;\n  }\n\n  add(definition: ExpressionOperatorDefinition): this {\n    const captured = captureDefinition(definition);\n    validateCustomDefinition(captured);\n    if (this.definitions.has(captured.name))\n      throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n    this.definitions.set(captured.name, captured);\n    return this;\n  }\n\n  build(): ExpressionProfile {\n    const operators = new Map<string, ExpressionOperator>();\n    for (const [name, definition] of this.definitions)\n      operators.set(name, freezeDefinition(definition));\n    return createProfileSnapshot(this.name, operators);\n  }\n}\n\nfunction validateDefinition(\n  definition: DefinitionSnapshot,\n): asserts definition is ValidDefinitionSnapshot {\n  if (\n    typeof definition.name !== \"string\" ||\n    !OPERATOR_NAME.test(definition.name) ||\n    typeof definition.execute !== \"function\"\n  ) {\n    throw new TypeError(\"Expression operator name or implementation is invalid.\");\n  }\n  const inputTypes = validatedInputTypes(definition.inputTypes);\n  validateResultType(definition.resultType);\n  const arity = definition.arity;\n  const minArgs = definition.minArgs;\n  const maxArgs = definition.maxArgs;\n  const hasExact = arity !== undefined;\n  if (hasExact === (minArgs !== undefined || maxArgs !== undefined)) {\n    throw new TypeError(\"Expression operators require exact arity or min/max arity.\");\n  }\n  if (hasExact) validateCount(arity);\n  if (minArgs !== undefined) validateCount(minArgs);\n  if (maxArgs !== undefined) validateCount(maxArgs);\n  if ((minArgs ?? 0) > (maxArgs ?? Number.MAX_SAFE_INTEGER)) {\n    throw new TypeError(\"Expression operator minimum arity exceeds maximum arity.\");\n  }\n  if (inputTypes && hasExact && inputTypes.length !== arity) {\n    throw new TypeError(\"Expression operator input metadata must match exact arity.\");\n  }\n  if (inputTypes && !hasExact && inputTypes.length !== 1) {\n    throw new TypeError(\"Variadic expression operators accept one repeated input type.\");\n  }\n}\n\nfunction validateCustomDefinition(\n  definition: DefinitionSnapshot,\n): asserts definition is ValidDefinitionSnapshot {\n  validateDefinition(definition);\n  if (typeof definition.name !== \"string\" || !NAMESPACED_OPERATOR_NAME.test(definition.name)) {\n    throw new TypeError(\"Custom expression operators require a namespaced name.\");\n  }\n}\n\nfunction validateProfileName(name: string): void {\n  if (typeof name !== \"string\" || !PROFILE_NAME.test(name))\n    throw new TypeError(\"Expression profile name is invalid.\");\n}\n\nfunction validateLookupName(name: string): void {\n  if (typeof name !== \"string\")\n    throw new TypeError(\"Expression operator name must be a primitive string.\");\n}\n\nfunction validatedInputTypes(input: unknown): readonly ExpressionValueType[] | undefined {\n  if (input !== undefined && !validInputTypes(input)) {\n    throw new TypeError(\"Expression operator input metadata is invalid.\");\n  }\n  return input;\n}\n\nfunction validateResultType(input: unknown): asserts input is ExpressionValueType | undefined {\n  if (input !== undefined && !isExpressionValueType(input)) {\n    throw new TypeError(\"Expression operator result metadata is invalid.\");\n  }\n}\n\nfunction validInputTypes(input: unknown): input is readonly ExpressionValueType[] {\n  if (!Array.isArray(input)) return false;\n  for (let index = 0; index < input.length; index += 1) {\n    if (!Object.hasOwn(input, index) || !isExpressionValueType(input[index])) return false;\n  }\n  return true;\n}\n\nfunction isExpressionValueType(value: unknown): value is ExpressionValueType {\n  return typeof value === \"string\" && EXPRESSION_VALUE_TYPES.has(value as ExpressionValueType);\n}\n\nfunction validateCount(value: unknown): asserts value is number {\n  if (\n    !Number.isSafeInteger(value) ||\n    (value as number) < 0 ||\n    (value as number) > MAX_EXPRESSION_OPERATOR_ARGS\n  ) {\n    throw new TypeError(\"Expression operator arity is invalid.\");\n  }\n}\n\nfunction freezeDefinition(definition: ValidDefinitionSnapshot): ExpressionOperator {\n  const operator = Object.freeze({\n    name: definition.name,\n    arity: definition.arity,\n    minArgs: definition.minArgs,\n    maxArgs: definition.maxArgs,\n    inputTypes: definition.inputTypes,\n    resultType: definition.resultType,\n    execute: definition.execute,\n  });\n  if (definition.strategy) OPERATOR_STRATEGIES.set(operator, definition.strategy);\n  return operator;\n}\n\nfunction createStandardProfile(\n  name: string,\n  operators: Iterable<\n    ExpressionOperatorDefinition & { readonly strategy?: ExpressionEvaluationStrategy }\n  >,\n): ExpressionProfile {\n  const snapshot = new Map<string, ExpressionOperator>();\n  for (const definition of operators) {\n    const captured = captureDefinition(definition, true);\n    validateDefinition(captured);\n    if (snapshot.has(captured.name))\n      throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n    snapshot.set(captured.name, freezeDefinition(captured));\n  }\n  return createProfileSnapshot(name, snapshot);\n}\n\nfunction getEvaluationStrategy(\n  operator: ExpressionOperator,\n): ExpressionEvaluationStrategy | undefined {\n  return OPERATOR_STRATEGIES.get(operator);\n}\n\nexport const internalProfile = Object.freeze({ createStandardProfile, getEvaluationStrategy });\n\nfunction captureDefinition(\n  definition: ExpressionOperatorDefinition,\n  includeStrategy = false,\n): DefinitionSnapshot {\n  const inputTypes = definition.inputTypes;\n  return Object.freeze({\n    name: definition.name,\n    arity: definition.arity,\n    minArgs: definition.minArgs,\n    maxArgs: definition.maxArgs,\n    inputTypes: captureInputTypes(inputTypes),\n    resultType: definition.resultType,\n    execute: definition.execute,\n    strategy: includeStrategy\n      ? (\n          definition as ExpressionOperatorDefinition & {\n            readonly strategy?: ExpressionEvaluationStrategy;\n          }\n        ).strategy\n      : undefined,\n  });\n}\n\nfunction captureInputTypes(input: unknown): unknown {\n  if (input === undefined || !Array.isArray(input)) return input;\n  try {\n    const length = input.length;\n    if (length > MAX_EXPRESSION_OPERATOR_ARGS) return INVALID_INPUT_TYPES;\n    const output: unknown[] = [];\n    for (let index = 0; index < length; index += 1) output.push(input[index]);\n    return Object.freeze(output);\n  } catch {\n    return INVALID_INPUT_TYPES;\n  }\n}\n"]}

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

@@ -0,0 +1,48 @@
+import { JsonValue } from './types.cjs';
+
+type ExpressionValueType = "any" | "null" | "boolean" | "number" | "string" | "array" | "object";
+declare const MAX_EXPRESSION_OPERATOR_ARGS = 32;
+type ExpressionOperatorFn = (args: readonly JsonValue[]) => JsonValue;
+type ExpressionEvaluationStrategy = "and" | "or" | "coalesce" | "exists" | "if";
+interface ExpressionOperatorDefinition {
+    readonly name: string;
+    readonly arity?: number;
+    readonly minArgs?: number;
+    readonly maxArgs?: number;
+    readonly inputTypes?: readonly ExpressionValueType[];
+    readonly resultType?: ExpressionValueType;
+    readonly execute: ExpressionOperatorFn;
+}
+interface ExpressionOperator extends ExpressionOperatorDefinition {
+}
+/**
+ * Structurally immutable snapshot of operator metadata and callback identities.
+ * Callbacks are trusted host code; their closed-over or function-object state remains producer-owned.
+ */
+declare class ExpressionProfile {
+    readonly name: string;
+    constructor(name: string, operators: Iterable<ExpressionOperatorDefinition>);
+    /** Derive a new immutable profile while preserving this profile's evaluation semantics. */
+    extend(name: string, operators: Iterable<ExpressionOperatorDefinition>): ExpressionProfile;
+    get(name: string): ExpressionOperator | undefined;
+    has(name: string): boolean;
+    get definitions(): readonly ExpressionOperator[];
+}
+/** Mutable construction helper whose build result is an independent structural snapshot. */
+declare class ExpressionProfileBuilder {
+    private readonly definitions;
+    private readonly name;
+    constructor(name: string);
+    add(definition: ExpressionOperatorDefinition): this;
+    build(): ExpressionProfile;
+}
+declare function createStandardProfile(name: string, operators: Iterable<ExpressionOperatorDefinition & {
+    readonly strategy?: ExpressionEvaluationStrategy;
+}>): ExpressionProfile;
+declare function getEvaluationStrategy(operator: ExpressionOperator): ExpressionEvaluationStrategy | undefined;
+declare const internalProfile: Readonly<{
+    createStandardProfile: typeof createStandardProfile;
+    getEvaluationStrategy: typeof getEvaluationStrategy;
+}>;
+
+export { type ExpressionOperator, type ExpressionOperatorDefinition, type ExpressionOperatorFn, ExpressionProfile, ExpressionProfileBuilder, type ExpressionValueType, MAX_EXPRESSION_OPERATOR_ARGS, internalProfile };

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

@@ -0,0 +1,48 @@
+import { JsonValue } from './types.js';
+
+type ExpressionValueType = "any" | "null" | "boolean" | "number" | "string" | "array" | "object";
+declare const MAX_EXPRESSION_OPERATOR_ARGS = 32;
+type ExpressionOperatorFn = (args: readonly JsonValue[]) => JsonValue;
+type ExpressionEvaluationStrategy = "and" | "or" | "coalesce" | "exists" | "if";
+interface ExpressionOperatorDefinition {
+    readonly name: string;
+    readonly arity?: number;
+    readonly minArgs?: number;
+    readonly maxArgs?: number;
+    readonly inputTypes?: readonly ExpressionValueType[];
+    readonly resultType?: ExpressionValueType;
+    readonly execute: ExpressionOperatorFn;
+}
+interface ExpressionOperator extends ExpressionOperatorDefinition {
+}
+/**
+ * Structurally immutable snapshot of operator metadata and callback identities.
+ * Callbacks are trusted host code; their closed-over or function-object state remains producer-owned.
+ */
+declare class ExpressionProfile {
+    readonly name: string;
+    constructor(name: string, operators: Iterable<ExpressionOperatorDefinition>);
+    /** Derive a new immutable profile while preserving this profile's evaluation semantics. */
+    extend(name: string, operators: Iterable<ExpressionOperatorDefinition>): ExpressionProfile;
+    get(name: string): ExpressionOperator | undefined;
+    has(name: string): boolean;
+    get definitions(): readonly ExpressionOperator[];
+}
+/** Mutable construction helper whose build result is an independent structural snapshot. */
+declare class ExpressionProfileBuilder {
+    private readonly definitions;
+    private readonly name;
+    constructor(name: string);
+    add(definition: ExpressionOperatorDefinition): this;
+    build(): ExpressionProfile;
+}
+declare function createStandardProfile(name: string, operators: Iterable<ExpressionOperatorDefinition & {
+    readonly strategy?: ExpressionEvaluationStrategy;
+}>): ExpressionProfile;
+declare function getEvaluationStrategy(operator: ExpressionOperator): ExpressionEvaluationStrategy | undefined;
+declare const internalProfile: Readonly<{
+    createStandardProfile: typeof createStandardProfile;
+    getEvaluationStrategy: typeof getEvaluationStrategy;
+}>;
+
+export { type ExpressionOperator, type ExpressionOperatorDefinition, type ExpressionOperatorFn, ExpressionProfile, ExpressionProfileBuilder, type ExpressionValueType, MAX_EXPRESSION_OPERATOR_ARGS, internalProfile };

package/dist/kuery-v1/profile.js

@@ -0,0 +1,219 @@
+const MAX_EXPRESSION_OPERATOR_ARGS = 32;
+const OPERATOR_NAME = /^[a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;
+const NAMESPACED_OPERATOR_NAME = /^[a-z][a-z0-9-]*[.:/][a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;
+const PROFILE_NAME = /^[A-Za-z][A-Za-z0-9._:/@-]{0,127}$/;
+const EXPRESSION_VALUE_TYPES = /* @__PURE__ */ new Set([
+  "any",
+  "null",
+  "boolean",
+  "number",
+  "string",
+  "array",
+  "object"
+]);
+const PROFILE_STATE = /* @__PURE__ */ new WeakMap();
+const OPERATOR_STRATEGIES = /* @__PURE__ */ new WeakMap();
+const INVALID_INPUT_TYPES = /* @__PURE__ */ Symbol("invalid input types");
+class ExpressionProfile {
+  name;
+  constructor(name, operators) {
+    validateProfileName(name);
+    const snapshot = /* @__PURE__ */ new Map();
+    addDefinitions(operators, snapshot);
+    this.name = name;
+    PROFILE_STATE.set(this, snapshot);
+    Object.freeze(this);
+  }
+  /** Derive a new immutable profile while preserving this profile's evaluation semantics. */
+  extend(name, operators) {
+    validateProfileName(name);
+    const snapshot = new Map(profileOperators(this));
+    for (const definition of operators) {
+      const captured = captureDefinition(definition);
+      validateCustomDefinition(captured);
+      if (snapshot.has(captured.name))
+        throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+      snapshot.set(captured.name, freezeDefinition(captured));
+    }
+    return createProfileSnapshot(name, snapshot);
+  }
+  get(name) {
+    validateLookupName(name);
+    return profileOperators(this).get(name);
+  }
+  has(name) {
+    validateLookupName(name);
+    return profileOperators(this).has(name);
+  }
+  get definitions() {
+    return Object.freeze([...profileOperators(this).values()]);
+  }
+}
+function profileOperators(profile) {
+  const operators = PROFILE_STATE.get(profile);
+  if (!operators) throw new TypeError("Invalid expression profile receiver.");
+  return operators;
+}
+function addDefinitions(operators, snapshot) {
+  for (const definition of operators) {
+    const captured = captureDefinition(definition);
+    validateDefinition(captured);
+    if (snapshot.has(captured.name))
+      throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+    snapshot.set(captured.name, freezeDefinition(captured));
+  }
+}
+function createProfileSnapshot(name, operators) {
+  validateProfileName(name);
+  const profile = Object.create(ExpressionProfile.prototype);
+  const snapshot = new Map(operators);
+  Object.defineProperty(profile, "name", { value: name, enumerable: true });
+  PROFILE_STATE.set(profile, snapshot);
+  Object.freeze(profile);
+  return profile;
+}
+class ExpressionProfileBuilder {
+  definitions = /* @__PURE__ */ new Map();
+  name;
+  constructor(name) {
+    validateProfileName(name);
+    this.name = name;
+  }
+  add(definition) {
+    const captured = captureDefinition(definition);
+    validateCustomDefinition(captured);
+    if (this.definitions.has(captured.name))
+      throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+    this.definitions.set(captured.name, captured);
+    return this;
+  }
+  build() {
+    const operators = /* @__PURE__ */ new Map();
+    for (const [name, definition] of this.definitions)
+      operators.set(name, freezeDefinition(definition));
+    return createProfileSnapshot(this.name, operators);
+  }
+}
+function validateDefinition(definition) {
+  if (typeof definition.name !== "string" || !OPERATOR_NAME.test(definition.name) || typeof definition.execute !== "function") {
+    throw new TypeError("Expression operator name or implementation is invalid.");
+  }
+  const inputTypes = validatedInputTypes(definition.inputTypes);
+  validateResultType(definition.resultType);
+  const arity = definition.arity;
+  const minArgs = definition.minArgs;
+  const maxArgs = definition.maxArgs;
+  const hasExact = arity !== void 0;
+  if (hasExact === (minArgs !== void 0 || maxArgs !== void 0)) {
+    throw new TypeError("Expression operators require exact arity or min/max arity.");
+  }
+  if (hasExact) validateCount(arity);
+  if (minArgs !== void 0) validateCount(minArgs);
+  if (maxArgs !== void 0) validateCount(maxArgs);
+  if ((minArgs ?? 0) > (maxArgs ?? Number.MAX_SAFE_INTEGER)) {
+    throw new TypeError("Expression operator minimum arity exceeds maximum arity.");
+  }
+  if (inputTypes && hasExact && inputTypes.length !== arity) {
+    throw new TypeError("Expression operator input metadata must match exact arity.");
+  }
+  if (inputTypes && !hasExact && inputTypes.length !== 1) {
+    throw new TypeError("Variadic expression operators accept one repeated input type.");
+  }
+}
+function validateCustomDefinition(definition) {
+  validateDefinition(definition);
+  if (typeof definition.name !== "string" || !NAMESPACED_OPERATOR_NAME.test(definition.name)) {
+    throw new TypeError("Custom expression operators require a namespaced name.");
+  }
+}
+function validateProfileName(name) {
+  if (typeof name !== "string" || !PROFILE_NAME.test(name))
+    throw new TypeError("Expression profile name is invalid.");
+}
+function validateLookupName(name) {
+  if (typeof name !== "string")
+    throw new TypeError("Expression operator name must be a primitive string.");
+}
+function validatedInputTypes(input) {
+  if (input !== void 0 && !validInputTypes(input)) {
+    throw new TypeError("Expression operator input metadata is invalid.");
+  }
+  return input;
+}
+function validateResultType(input) {
+  if (input !== void 0 && !isExpressionValueType(input)) {
+    throw new TypeError("Expression operator result metadata is invalid.");
+  }
+}
+function validInputTypes(input) {
+  if (!Array.isArray(input)) return false;
+  for (let index = 0; index < input.length; index += 1) {
+    if (!Object.hasOwn(input, index) || !isExpressionValueType(input[index])) return false;
+  }
+  return true;
+}
+function isExpressionValueType(value) {
+  return typeof value === "string" && EXPRESSION_VALUE_TYPES.has(value);
+}
+function validateCount(value) {
+  if (!Number.isSafeInteger(value) || value < 0 || value > MAX_EXPRESSION_OPERATOR_ARGS) {
+    throw new TypeError("Expression operator arity is invalid.");
+  }
+}
+function freezeDefinition(definition) {
+  const operator = Object.freeze({
+    name: definition.name,
+    arity: definition.arity,
+    minArgs: definition.minArgs,
+    maxArgs: definition.maxArgs,
+    inputTypes: definition.inputTypes,
+    resultType: definition.resultType,
+    execute: definition.execute
+  });
+  if (definition.strategy) OPERATOR_STRATEGIES.set(operator, definition.strategy);
+  return operator;
+}
+function createStandardProfile(name, operators) {
+  const snapshot = /* @__PURE__ */ new Map();
+  for (const definition of operators) {
+    const captured = captureDefinition(definition, true);
+    validateDefinition(captured);
+    if (snapshot.has(captured.name))
+      throw new TypeError(`Duplicate expression operator: ${captured.name}`);
+    snapshot.set(captured.name, freezeDefinition(captured));
+  }
+  return createProfileSnapshot(name, snapshot);
+}
+function getEvaluationStrategy(operator) {
+  return OPERATOR_STRATEGIES.get(operator);
+}
+const internalProfile = Object.freeze({ createStandardProfile, getEvaluationStrategy });
+function captureDefinition(definition, includeStrategy = false) {
+  const inputTypes = definition.inputTypes;
+  return Object.freeze({
+    name: definition.name,
+    arity: definition.arity,
+    minArgs: definition.minArgs,
+    maxArgs: definition.maxArgs,
+    inputTypes: captureInputTypes(inputTypes),
+    resultType: definition.resultType,
+    execute: definition.execute,
+    strategy: includeStrategy ? definition.strategy : void 0
+  });
+}
+function captureInputTypes(input) {
+  if (input === void 0 || !Array.isArray(input)) return input;
+  try {
+    const length = input.length;
+    if (length > MAX_EXPRESSION_OPERATOR_ARGS) return INVALID_INPUT_TYPES;
+    const output = [];
+    for (let index = 0; index < length; index += 1) output.push(input[index]);
+    return Object.freeze(output);
+  } catch {
+    return INVALID_INPUT_TYPES;
+  }
+}
+
+export { ExpressionProfile, ExpressionProfileBuilder, MAX_EXPRESSION_OPERATOR_ARGS, internalProfile };
+//# sourceMappingURL=profile.js.map
+//# sourceMappingURL=profile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kuery-v1/profile.ts"],"names":[],"mappings":"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","file":"profile.js","sourcesContent":["import type { JsonValue } from \"./types.js\";\n\nexport type ExpressionValueType =\n  | \"any\"\n  | \"null\"\n  | \"boolean\"\n  | \"number\"\n  | \"string\"\n  | \"array\"\n  | \"object\";\nexport const MAX_EXPRESSION_OPERATOR_ARGS = 32;\nexport type ExpressionOperatorFn = (args: readonly JsonValue[]) => JsonValue;\ntype ExpressionEvaluationStrategy = \"and\" | \"or\" | \"coalesce\" | \"exists\" | \"if\";\n\nexport interface ExpressionOperatorDefinition {\n  readonly name: string;\n  readonly arity?: number;\n  readonly minArgs?: number;\n  readonly maxArgs?: number;\n  readonly inputTypes?: readonly ExpressionValueType[];\n  readonly resultType?: ExpressionValueType;\n  readonly execute: ExpressionOperatorFn;\n}\n\nexport interface ExpressionOperator extends ExpressionOperatorDefinition {}\n\nconst OPERATOR_NAME = /^[a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;\nconst NAMESPACED_OPERATOR_NAME = /^[a-z][a-z0-9-]*[.:/][a-z][a-z0-9-]*(?:[.:/][a-z][a-z0-9-]*)*$/;\nconst PROFILE_NAME = /^[A-Za-z][A-Za-z0-9._:/@-]{0,127}$/;\nconst EXPRESSION_VALUE_TYPES = new Set<ExpressionValueType>([\n  \"any\",\n  \"null\",\n  \"boolean\",\n  \"number\",\n  \"string\",\n  \"array\",\n  \"object\",\n]);\nconst PROFILE_STATE = new WeakMap<ExpressionProfile, ReadonlyMap<string, ExpressionOperator>>();\nconst OPERATOR_STRATEGIES = new WeakMap<ExpressionOperator, ExpressionEvaluationStrategy>();\nconst INVALID_INPUT_TYPES = Symbol(\"invalid input types\");\n\ninterface DefinitionSnapshot {\n  readonly name: unknown;\n  readonly arity: unknown;\n  readonly minArgs: unknown;\n  readonly maxArgs: unknown;\n  readonly inputTypes: unknown;\n  readonly resultType: unknown;\n  readonly execute: unknown;\n  readonly strategy: unknown;\n}\n\ntype ValidDefinitionSnapshot = DefinitionSnapshot & {\n  readonly name: string;\n  readonly arity: number | undefined;\n  readonly minArgs: number | undefined;\n  readonly maxArgs: number | undefined;\n  readonly inputTypes: readonly ExpressionValueType[] | undefined;\n  readonly resultType: ExpressionValueType | undefined;\n  readonly execute: ExpressionOperatorFn;\n  readonly strategy: ExpressionEvaluationStrategy | undefined;\n};\n/**\n * Structurally immutable snapshot of operator metadata and callback identities.\n * Callbacks are trusted host code; their closed-over or function-object state remains producer-owned.\n */\nexport class ExpressionProfile {\n  readonly name: string;\n\n  constructor(name: string, operators: Iterable<ExpressionOperatorDefinition>) {\n    validateProfileName(name);\n    const snapshot = new Map<string, ExpressionOperator>();\n    addDefinitions(operators, snapshot);\n    this.name = name;\n    PROFILE_STATE.set(this, snapshot);\n    Object.freeze(this);\n  }\n\n  /** Derive a new immutable profile while preserving this profile's evaluation semantics. */\n  extend(name: string, operators: Iterable<ExpressionOperatorDefinition>): ExpressionProfile {\n    validateProfileName(name);\n    const snapshot = new Map(profileOperators(this));\n    for (const definition of operators) {\n      const captured = captureDefinition(definition);\n      validateCustomDefinition(captured);\n      if (snapshot.has(captured.name))\n        throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n      snapshot.set(captured.name, freezeDefinition(captured));\n    }\n    return createProfileSnapshot(name, snapshot);\n  }\n\n  get(name: string): ExpressionOperator | undefined {\n    validateLookupName(name);\n    return profileOperators(this).get(name);\n  }\n\n  has(name: string): boolean {\n    validateLookupName(name);\n    return profileOperators(this).has(name);\n  }\n\n  get definitions(): readonly ExpressionOperator[] {\n    return Object.freeze([...profileOperators(this).values()]);\n  }\n}\n\nfunction profileOperators(profile: ExpressionProfile): ReadonlyMap<string, ExpressionOperator> {\n  const operators = PROFILE_STATE.get(profile);\n  if (!operators) throw new TypeError(\"Invalid expression profile receiver.\");\n  return operators;\n}\n\nfunction addDefinitions(\n  operators: Iterable<ExpressionOperatorDefinition>,\n  snapshot: Map<string, ExpressionOperator>,\n): void {\n  for (const definition of operators) {\n    const captured = captureDefinition(definition);\n    validateDefinition(captured);\n    if (snapshot.has(captured.name))\n      throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n    snapshot.set(captured.name, freezeDefinition(captured));\n  }\n}\n\nfunction createProfileSnapshot(\n  name: string,\n  operators: ReadonlyMap<string, ExpressionOperator>,\n): ExpressionProfile {\n  validateProfileName(name);\n  const profile = Object.create(ExpressionProfile.prototype) as ExpressionProfile;\n  const snapshot = new Map(operators);\n  Object.defineProperty(profile, \"name\", { value: name, enumerable: true });\n  PROFILE_STATE.set(profile, snapshot);\n  Object.freeze(profile);\n  return profile;\n}\n\n/** Mutable construction helper whose build result is an independent structural snapshot. */\nexport class ExpressionProfileBuilder {\n  private readonly definitions = new Map<string, ValidDefinitionSnapshot>();\n  private readonly name: string;\n\n  constructor(name: string) {\n    validateProfileName(name);\n    this.name = name;\n  }\n\n  add(definition: ExpressionOperatorDefinition): this {\n    const captured = captureDefinition(definition);\n    validateCustomDefinition(captured);\n    if (this.definitions.has(captured.name))\n      throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n    this.definitions.set(captured.name, captured);\n    return this;\n  }\n\n  build(): ExpressionProfile {\n    const operators = new Map<string, ExpressionOperator>();\n    for (const [name, definition] of this.definitions)\n      operators.set(name, freezeDefinition(definition));\n    return createProfileSnapshot(this.name, operators);\n  }\n}\n\nfunction validateDefinition(\n  definition: DefinitionSnapshot,\n): asserts definition is ValidDefinitionSnapshot {\n  if (\n    typeof definition.name !== \"string\" ||\n    !OPERATOR_NAME.test(definition.name) ||\n    typeof definition.execute !== \"function\"\n  ) {\n    throw new TypeError(\"Expression operator name or implementation is invalid.\");\n  }\n  const inputTypes = validatedInputTypes(definition.inputTypes);\n  validateResultType(definition.resultType);\n  const arity = definition.arity;\n  const minArgs = definition.minArgs;\n  const maxArgs = definition.maxArgs;\n  const hasExact = arity !== undefined;\n  if (hasExact === (minArgs !== undefined || maxArgs !== undefined)) {\n    throw new TypeError(\"Expression operators require exact arity or min/max arity.\");\n  }\n  if (hasExact) validateCount(arity);\n  if (minArgs !== undefined) validateCount(minArgs);\n  if (maxArgs !== undefined) validateCount(maxArgs);\n  if ((minArgs ?? 0) > (maxArgs ?? Number.MAX_SAFE_INTEGER)) {\n    throw new TypeError(\"Expression operator minimum arity exceeds maximum arity.\");\n  }\n  if (inputTypes && hasExact && inputTypes.length !== arity) {\n    throw new TypeError(\"Expression operator input metadata must match exact arity.\");\n  }\n  if (inputTypes && !hasExact && inputTypes.length !== 1) {\n    throw new TypeError(\"Variadic expression operators accept one repeated input type.\");\n  }\n}\n\nfunction validateCustomDefinition(\n  definition: DefinitionSnapshot,\n): asserts definition is ValidDefinitionSnapshot {\n  validateDefinition(definition);\n  if (typeof definition.name !== \"string\" || !NAMESPACED_OPERATOR_NAME.test(definition.name)) {\n    throw new TypeError(\"Custom expression operators require a namespaced name.\");\n  }\n}\n\nfunction validateProfileName(name: string): void {\n  if (typeof name !== \"string\" || !PROFILE_NAME.test(name))\n    throw new TypeError(\"Expression profile name is invalid.\");\n}\n\nfunction validateLookupName(name: string): void {\n  if (typeof name !== \"string\")\n    throw new TypeError(\"Expression operator name must be a primitive string.\");\n}\n\nfunction validatedInputTypes(input: unknown): readonly ExpressionValueType[] | undefined {\n  if (input !== undefined && !validInputTypes(input)) {\n    throw new TypeError(\"Expression operator input metadata is invalid.\");\n  }\n  return input;\n}\n\nfunction validateResultType(input: unknown): asserts input is ExpressionValueType | undefined {\n  if (input !== undefined && !isExpressionValueType(input)) {\n    throw new TypeError(\"Expression operator result metadata is invalid.\");\n  }\n}\n\nfunction validInputTypes(input: unknown): input is readonly ExpressionValueType[] {\n  if (!Array.isArray(input)) return false;\n  for (let index = 0; index < input.length; index += 1) {\n    if (!Object.hasOwn(input, index) || !isExpressionValueType(input[index])) return false;\n  }\n  return true;\n}\n\nfunction isExpressionValueType(value: unknown): value is ExpressionValueType {\n  return typeof value === \"string\" && EXPRESSION_VALUE_TYPES.has(value as ExpressionValueType);\n}\n\nfunction validateCount(value: unknown): asserts value is number {\n  if (\n    !Number.isSafeInteger(value) ||\n    (value as number) < 0 ||\n    (value as number) > MAX_EXPRESSION_OPERATOR_ARGS\n  ) {\n    throw new TypeError(\"Expression operator arity is invalid.\");\n  }\n}\n\nfunction freezeDefinition(definition: ValidDefinitionSnapshot): ExpressionOperator {\n  const operator = Object.freeze({\n    name: definition.name,\n    arity: definition.arity,\n    minArgs: definition.minArgs,\n    maxArgs: definition.maxArgs,\n    inputTypes: definition.inputTypes,\n    resultType: definition.resultType,\n    execute: definition.execute,\n  });\n  if (definition.strategy) OPERATOR_STRATEGIES.set(operator, definition.strategy);\n  return operator;\n}\n\nfunction createStandardProfile(\n  name: string,\n  operators: Iterable<\n    ExpressionOperatorDefinition & { readonly strategy?: ExpressionEvaluationStrategy }\n  >,\n): ExpressionProfile {\n  const snapshot = new Map<string, ExpressionOperator>();\n  for (const definition of operators) {\n    const captured = captureDefinition(definition, true);\n    validateDefinition(captured);\n    if (snapshot.has(captured.name))\n      throw new TypeError(`Duplicate expression operator: ${captured.name}`);\n    snapshot.set(captured.name, freezeDefinition(captured));\n  }\n  return createProfileSnapshot(name, snapshot);\n}\n\nfunction getEvaluationStrategy(\n  operator: ExpressionOperator,\n): ExpressionEvaluationStrategy | undefined {\n  return OPERATOR_STRATEGIES.get(operator);\n}\n\nexport const internalProfile = Object.freeze({ createStandardProfile, getEvaluationStrategy });\n\nfunction captureDefinition(\n  definition: ExpressionOperatorDefinition,\n  includeStrategy = false,\n): DefinitionSnapshot {\n  const inputTypes = definition.inputTypes;\n  return Object.freeze({\n    name: definition.name,\n    arity: definition.arity,\n    minArgs: definition.minArgs,\n    maxArgs: definition.maxArgs,\n    inputTypes: captureInputTypes(inputTypes),\n    resultType: definition.resultType,\n    execute: definition.execute,\n    strategy: includeStrategy\n      ? (\n          definition as ExpressionOperatorDefinition & {\n            readonly strategy?: ExpressionEvaluationStrategy;\n          }\n        ).strategy\n      : undefined,\n  });\n}\n\nfunction captureInputTypes(input: unknown): unknown {\n  if (input === undefined || !Array.isArray(input)) return input;\n  try {\n    const length = input.length;\n    if (length > MAX_EXPRESSION_OPERATOR_ARGS) return INVALID_INPUT_TYPES;\n    const output: unknown[] = [];\n    for (let index = 0; index < length; index += 1) output.push(input[index]);\n    return Object.freeze(output);\n  } catch {\n    return INVALID_INPUT_TYPES;\n  }\n}\n"]}