apcore-js 0.4.0 → 0.6.0

package/dist/schema/strict.js

@@ -0,0 +1,127 @@
+/**
+ * Strict mode conversion for JSON Schemas (Algorithm A23).
+ */
+import { deepCopy } from '../utils/index.js';
+export function toStrictSchema(schema) {
+    const result = deepCopy(schema);
+    stripExtensions(result);
+    convertToStrict(result);
+    return result;
+}
+export function applyLlmDescriptions(node) {
+    if (typeof node !== 'object' || node === null || Array.isArray(node))
+        return;
+    const obj = node;
+    if ('x-llm-description' in obj) {
+        obj['description'] = obj['x-llm-description'];
+    }
+    if ('properties' in obj && typeof obj['properties'] === 'object' && obj['properties'] !== null) {
+        for (const prop of Object.values(obj['properties'])) {
+            applyLlmDescriptions(prop);
+        }
+    }
+    if ('items' in obj && typeof obj['items'] === 'object') {
+        applyLlmDescriptions(obj['items']);
+    }
+    for (const keyword of ['oneOf', 'anyOf', 'allOf']) {
+        if (keyword in obj && Array.isArray(obj[keyword])) {
+            for (const sub of obj[keyword]) {
+                applyLlmDescriptions(sub);
+            }
+        }
+    }
+    for (const defsKey of ['definitions', '$defs']) {
+        if (defsKey in obj && typeof obj[defsKey] === 'object' && obj[defsKey] !== null) {
+            for (const defn of Object.values(obj[defsKey])) {
+                applyLlmDescriptions(defn);
+            }
+        }
+    }
+}
+export function stripExtensions(node) {
+    if (typeof node !== 'object' || node === null || Array.isArray(node))
+        return;
+    const obj = node;
+    const keysToRemove = Object.keys(obj).filter((k) => (typeof k === 'string' && k.startsWith('x-')) || k === 'default');
+    for (const k of keysToRemove) {
+        delete obj[k];
+    }
+    for (const value of Object.values(obj)) {
+        if (typeof value === 'object' && value !== null) {
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    if (typeof item === 'object' && item !== null) {
+                        stripExtensions(item);
+                    }
+                }
+            }
+            else {
+                stripExtensions(value);
+            }
+        }
+    }
+}
+function convertToStrict(node) {
+    if (typeof node !== 'object' || node === null || Array.isArray(node))
+        return;
+    const obj = node;
+    if (obj['type'] === 'object' && 'properties' in obj) {
+        obj['additionalProperties'] = false;
+        const existingRequired = new Set(Array.isArray(obj['required']) ? obj['required'] : []);
+        const properties = obj['properties'];
+        const allNames = Object.keys(properties);
+        const optionalNames = allNames.filter((n) => !existingRequired.has(n));
+        for (const name of optionalNames) {
+            const prop = properties[name];
+            if ('type' in prop) {
+                if (typeof prop['type'] === 'string') {
+                    prop['type'] = [prop['type'], 'null'];
+                }
+                else if (Array.isArray(prop['type'])) {
+                    if (!prop['type'].includes('null')) {
+                        prop['type'].push('null');
+                    }
+                }
+            }
+            else if ('oneOf' in prop && Array.isArray(prop['oneOf'])) {
+                const variants = prop['oneOf'];
+                if (!variants.some((v) => v['type'] === 'null')) {
+                    variants.push({ type: 'null' });
+                }
+            }
+            else if ('anyOf' in prop && Array.isArray(prop['anyOf'])) {
+                const variants = prop['anyOf'];
+                if (!variants.some((v) => v['type'] === 'null')) {
+                    variants.push({ type: 'null' });
+                }
+            }
+            else {
+                properties[name] = { oneOf: [prop, { type: 'null' }] };
+            }
+        }
+        obj['required'] = [...allNames].sort();
+    }
+    if ('properties' in obj && typeof obj['properties'] === 'object' && obj['properties'] !== null) {
+        for (const prop of Object.values(obj['properties'])) {
+            convertToStrict(prop);
+        }
+    }
+    if ('items' in obj && typeof obj['items'] === 'object') {
+        convertToStrict(obj['items']);
+    }
+    for (const keyword of ['oneOf', 'anyOf', 'allOf']) {
+        if (keyword in obj && Array.isArray(obj[keyword])) {
+            for (const sub of obj[keyword]) {
+                convertToStrict(sub);
+            }
+        }
+    }
+    for (const defsKey of ['definitions', '$defs']) {
+        if (defsKey in obj && typeof obj[defsKey] === 'object' && obj[defsKey] !== null) {
+            for (const defn of Object.values(obj[defsKey])) {
+                convertToStrict(defn);
+            }
+        }
+    }
+}
+//# sourceMappingURL=strict.js.map

package/dist/schema/strict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict.js","sourceRoot":"","sources":["../../src/schema/strict.ts"],"names":[],"mappings":"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"}

package/dist/schema/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Schema type definitions and data structures for the apcore schema system.
+ */
+import type { TSchema } from '@sinclair/typebox';
+import { SchemaValidationError } from '../errors.js';
+export declare enum SchemaStrategy {
+    YamlFirst = "yaml_first",
+    NativeFirst = "native_first",
+    YamlOnly = "yaml_only"
+}
+export declare enum ExportProfile {
+    MCP = "mcp",
+    OpenAI = "openai",
+    Anthropic = "anthropic",
+    Generic = "generic"
+}
+export interface SchemaDefinition {
+    moduleId: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    errorSchema?: Record<string, unknown> | null;
+    definitions: Record<string, unknown>;
+    version: string;
+    documentation?: string | null;
+    schemaUrl?: string | null;
+}
+export interface ResolvedSchema {
+    jsonSchema: Record<string, unknown>;
+    schema: TSchema;
+    moduleId: string;
+    direction: string;
+}
+export interface SchemaValidationErrorDetail {
+    path: string;
+    message: string;
+    constraint?: string | null;
+    expected?: unknown;
+    actual?: unknown;
+}
+export interface SchemaValidationResult {
+    valid: boolean;
+    errors: SchemaValidationErrorDetail[];
+}
+export declare function validationResultToError(result: SchemaValidationResult): SchemaValidationError;
+export interface LLMExtensions {
+    llmDescription?: string | null;
+    examples?: unknown[] | null;
+    sensitive: boolean;
+    constraints?: string | null;
+    deprecated?: Record<string, unknown> | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,oBAAY,cAAc;IACxB,SAAS,eAAe;IACxB,WAAW,iBAAiB;IAC5B,QAAQ,cAAc;CACvB;AAED,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,2BAA2B,EAAE,CAAC;CACvC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,GAAG,qBAAqB,CAY7F;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7C"}

package/dist/schema/types.js

@@ -0,0 +1,31 @@
+/**
+ * Schema type definitions and data structures for the apcore schema system.
+ */
+import { SchemaValidationError } from '../errors.js';
+export var SchemaStrategy;
+(function (SchemaStrategy) {
+    SchemaStrategy["YamlFirst"] = "yaml_first";
+    SchemaStrategy["NativeFirst"] = "native_first";
+    SchemaStrategy["YamlOnly"] = "yaml_only";
+})(SchemaStrategy || (SchemaStrategy = {}));
+export var ExportProfile;
+(function (ExportProfile) {
+    ExportProfile["MCP"] = "mcp";
+    ExportProfile["OpenAI"] = "openai";
+    ExportProfile["Anthropic"] = "anthropic";
+    ExportProfile["Generic"] = "generic";
+})(ExportProfile || (ExportProfile = {}));
+export function validationResultToError(result) {
+    if (result.valid) {
+        throw new Error('Cannot convert valid result to error');
+    }
+    const errorDicts = result.errors.map((e) => ({
+        path: e.path,
+        message: e.message,
+        constraint: e.constraint ?? null,
+        expected: e.expected ?? null,
+        actual: e.actual ?? null,
+    }));
+    return new SchemaValidationError('Schema validation failed', errorDicts);
+}
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,0CAAwB,CAAA;IACxB,8CAA4B,CAAA;IAC5B,wCAAsB,CAAA;AACxB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;IACvB,oCAAmB,CAAA;AACrB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAkCD,MAAM,UAAU,uBAAuB,CAAC,MAA8B;IACpE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;QAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;KACzB,CAAC,CAAC,CAAC;IACJ,OAAO,IAAI,qBAAqB,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;AAC3E,CAAC"}

package/dist/schema/validator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SchemaValidator — validates runtime data against TypeBox schemas.
+ */
+import { type TSchema } from '@sinclair/typebox';
+import type { SchemaValidationResult } from './types.js';
+export declare class SchemaValidator {
+    private _coerceTypes;
+    constructor(coerceTypes?: boolean);
+    validate(data: Record<string, unknown>, schema: TSchema): SchemaValidationResult;
+    validateInput(data: Record<string, unknown>, schema: TSchema): Record<string, unknown>;
+    validateOutput(data: Record<string, unknown>, schema: TSchema): Record<string, unknown>;
+    private _validateAndReturn;
+    private _collectErrors;
+    private _typeboxErrorToDetail;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/schema/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/schema/validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAA+B,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGtF,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAU;gBAElB,WAAW,GAAE,OAAc;IAIvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,sBAAsB;IAgBhF,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAItF,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIvF,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,qBAAqB;CAS9B"}

package/dist/schema/validator.js

@@ -0,0 +1,71 @@
+/**
+ * SchemaValidator — validates runtime data against TypeBox schemas.
+ */
+import { Value } from '@sinclair/typebox/value';
+import { validationResultToError } from './types.js';
+export class SchemaValidator {
+    _coerceTypes;
+    constructor(coerceTypes = true) {
+        this._coerceTypes = coerceTypes;
+    }
+    validate(data, schema) {
+        if (this._coerceTypes) {
+            try {
+                Value.Decode(schema, data);
+                return { valid: true, errors: [] };
+            }
+            catch {
+                return { valid: false, errors: this._collectErrors(schema, data) };
+            }
+        }
+        if (Value.Check(schema, data)) {
+            return { valid: true, errors: [] };
+        }
+        return { valid: false, errors: this._collectErrors(schema, data) };
+    }
+    validateInput(data, schema) {
+        return this._validateAndReturn(data, schema);
+    }
+    validateOutput(data, schema) {
+        return this._validateAndReturn(data, schema);
+    }
+    _validateAndReturn(data, schema) {
+        if (this._coerceTypes) {
+            try {
+                return Value.Decode(schema, data);
+            }
+            catch {
+                const result = {
+                    valid: false,
+                    errors: this._collectErrors(schema, data),
+                };
+                throw validationResultToError(result);
+            }
+        }
+        if (Value.Check(schema, data)) {
+            return data;
+        }
+        const result = {
+            valid: false,
+            errors: this._collectErrors(schema, data),
+        };
+        throw validationResultToError(result);
+    }
+    _collectErrors(schema, data) {
+        const errors = [];
+        for (const error of Value.Errors(schema, data)) {
+            errors.push(this._typeboxErrorToDetail(error));
+        }
+        return errors;
+    }
+    _typeboxErrorToDetail(error) {
+        return {
+            path: error.path || '/',
+            message: error.message,
+            constraint: String(error.type),
+            expected: error.schema,
+            actual: error.value,
+        };
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/schema/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/schema/validator.ts"],"names":[],"mappings":"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"}

package/dist/trace-context.d.ts

@@ -0,0 +1,35 @@
+/**
+ * W3C Trace Context support: TraceParent parsing and TraceContext injection/extraction.
+ */
+import type { Context } from './context.js';
+export interface TraceParent {
+    readonly version: string;
+    readonly traceId: string;
+    readonly parentId: string;
+    readonly traceFlags: string;
+}
+export declare class TraceContext {
+    /**
+     * Build a traceparent header dict from an apcore Context.
+     *
+     * Converts `context.traceId` (UUID with dashes) to the 32-hex
+     * format required by the W3C traceparent spec. Uses the last span's
+     * `spanId` from the tracing stack if available, otherwise generates
+     * a random 16-hex parent id.
+     */
+    static inject(context: Context): Record<string, string>;
+    /**
+     * Parse the `traceparent` header from the given headers object.
+     *
+     * Returns `null` if the header is missing or malformed.
+     */
+    static extract(headers: Record<string, string>): TraceParent | null;
+    /**
+     * Strictly parse a traceparent string, throwing on invalid format.
+     *
+     * @throws {Error} If the traceparent does not match the expected
+     *   `00-<32 hex>-<16 hex>-<2 hex>` format.
+     */
+    static fromTraceparent(traceparent: string): TraceParent;
+}
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,YAAY;IACvB;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAevD;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,GAAG,IAAI;IA0BnE;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;CAuBzD"}

package/dist/trace-context.js

@@ -0,0 +1,86 @@
+/**
+ * W3C Trace Context support: TraceParent parsing and TraceContext injection/extraction.
+ */
+import { randomHex } from './utils/index.js';
+const TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+export class TraceContext {
+    /**
+     * Build a traceparent header dict from an apcore Context.
+     *
+     * Converts `context.traceId` (UUID with dashes) to the 32-hex
+     * format required by the W3C traceparent spec. Uses the last span's
+     * `spanId` from the tracing stack if available, otherwise generates
+     * a random 16-hex parent id.
+     */
+    static inject(context) {
+        const traceIdHex = context.traceId.replace(/-/g, '');
+        const spansStack = context.data['_tracing_spans'];
+        let parentId;
+        if (spansStack && spansStack.length > 0) {
+            parentId = spansStack[spansStack.length - 1].spanId;
+        }
+        else {
+            parentId = randomHex(8);
+        }
+        const traceparent = `00-${traceIdHex}-${parentId}-01`;
+        return { traceparent };
+    }
+    /**
+     * Parse the `traceparent` header from the given headers object.
+     *
+     * Returns `null` if the header is missing or malformed.
+     */
+    static extract(headers) {
+        const raw = headers['traceparent'];
+        if (raw === undefined) {
+            return null;
+        }
+        const match = TRACEPARENT_RE.exec(raw.trim().toLowerCase());
+        if (match === null) {
+            return null;
+        }
+        const version = match[1];
+        const traceId = match[2];
+        const parentId = match[3];
+        if (version === 'ff') {
+            return null;
+        }
+        if (traceId === '0'.repeat(32) || parentId === '0'.repeat(16)) {
+            return null;
+        }
+        return Object.freeze({
+            version,
+            traceId,
+            parentId,
+            traceFlags: match[4],
+        });
+    }
+    /**
+     * Strictly parse a traceparent string, throwing on invalid format.
+     *
+     * @throws {Error} If the traceparent does not match the expected
+     *   `00-<32 hex>-<16 hex>-<2 hex>` format.
+     */
+    static fromTraceparent(traceparent) {
+        const match = TRACEPARENT_RE.exec(traceparent.trim().toLowerCase());
+        if (match === null) {
+            throw new Error(`Malformed traceparent: ${JSON.stringify(traceparent.slice(0, 100))}. Expected format: 00-<32 hex>-<16 hex>-<2 hex>`);
+        }
+        const version = match[1];
+        const traceId = match[2];
+        const parentId = match[3];
+        if (version === 'ff') {
+            throw new Error('Invalid traceparent: version ff is not allowed');
+        }
+        if (traceId === '0'.repeat(32) || parentId === '0'.repeat(16)) {
+            throw new Error('Invalid traceparent: all-zero trace_id or parent_id');
+        }
+        return Object.freeze({
+            version,
+            traceId,
+            parentId,
+            traceFlags: match[4],
+        });
+    }
+}
+//# sourceMappingURL=trace-context.js.map

package/dist/trace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.js","sourceRoot":"","sources":["../src/trace-context.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+export { matchPattern } from './pattern.js';
+export declare function deepCopy<T>(obj: T): T;
+/**
+ * Generate a random hex string of the given byte length.
+ *
+ * Uses the Web Crypto API (`crypto.getRandomValues`) when available
+ * (all modern browsers, Node.js ≥ 19), falling back to `node:crypto`
+ * for Node.js < 19.
+ */
+export declare function randomHex(byteLength: number): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAErC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAYpD"}

package/dist/utils/index.js

@@ -0,0 +1,32 @@
+export { matchPattern } from './pattern.js';
+// Lazy-load node:crypto for environments without globalThis.crypto (Node.js < 19)
+let _nodeCrypto;
+try {
+    _nodeCrypto = await import('node:crypto');
+}
+catch { /* browser environment */ }
+export function deepCopy(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+/**
+ * Generate a random hex string of the given byte length.
+ *
+ * Uses the Web Crypto API (`crypto.getRandomValues`) when available
+ * (all modern browsers, Node.js ≥ 19), falling back to `node:crypto`
+ * for Node.js < 19.
+ */
+export function randomHex(byteLength) {
+    const bytes = new Uint8Array(byteLength);
+    const c = globalThis.crypto ?? _nodeCrypto?.webcrypto;
+    if (c) {
+        c.getRandomValues(bytes);
+    }
+    else {
+        // Last-resort fallback (sufficient for trace/span IDs, not for security)
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,kFAAkF;AAClF,IAAI,WAAqD,CAAC;AAC1D,IAAI,CAAC;IAAC,WAAW,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;AAEtF,MAAM,UAAU,QAAQ,CAAI,GAAM;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,IAAI,WAAW,EAAE,SAAS,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC;QACN,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,yEAAyE;QACzE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/utils/pattern.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Wildcard pattern matching for module IDs (Algorithm A08).
+ */
+export declare function matchPattern(pattern: string, moduleId: string): boolean;
+//# sourceMappingURL=pattern.d.ts.map

package/dist/utils/pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../src/utils/pattern.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAyBvE"}

package/dist/utils/pattern.js

@@ -0,0 +1,31 @@
+/**
+ * Wildcard pattern matching for module IDs (Algorithm A08).
+ */
+export function matchPattern(pattern, moduleId) {
+    if (pattern === '*')
+        return true;
+    if (!pattern.includes('*'))
+        return pattern === moduleId;
+    const segments = pattern.split('*');
+    let pos = 0;
+    if (!pattern.startsWith('*')) {
+        if (!moduleId.startsWith(segments[0]))
+            return false;
+        pos = segments[0].length;
+    }
+    for (let i = 1; i < segments.length; i++) {
+        const segment = segments[i];
+        if (!segment)
+            continue;
+        const idx = moduleId.indexOf(segment, pos);
+        if (idx === -1)
+            return false;
+        pos = idx + segment.length;
+    }
+    if (!pattern.endsWith('*')) {
+        if (!moduleId.endsWith(segments[segments.length - 1]))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=pattern.js.map

package/dist/utils/pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/utils/pattern.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,QAAgB;IAC5D,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,KAAK,QAAQ,CAAC;IAExD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACpD,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC3C,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7B,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACtE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apcore-js",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "AI-Perceivable Core — schema-driven module development framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,12 +11,18 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "pnpm run build"
   },
   "engines": {
     "node": ">=18.0.0"

package/.claude/settings.local.json

@@ -1,12 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx vitest run:*)",
-      "Bash(npm test:*)",
-      "Bash(npx tsc:*)",
-      "Bash(wc:*)",
-      "Bash(ls:*)",
-      "Skill(code-forge:review)"
-    ]
-  }
-}

package/.github/workflows/ci.yml

@@ -1,39 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  build-and-test:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-
-      - name: Install pnpm
-        run: npm install -g pnpm
-
-      - name: Install dependencies
-        run: pnpm install
-
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: '3.11'
-
-      - name: Install pre-commit
-        run: pip install pre-commit
-
-      - name: Run pre-commit checks
-        run: pre-commit run --all-files
-
-      - name: Run tests
-        run: pnpm test