apcore-js 0.5.0 → 0.7.0

package/dist/extensions.js

@@ -0,0 +1,239 @@
+/**
+ * Extension point framework for apcore.
+ *
+ * Provides a centralized mechanism to register, query, and wire custom
+ * extensions (discoverers, middleware, ACL providers, span exporters, and
+ * module validators) into the apcore runtime.
+ */
+import { TracingMiddleware } from './observability/tracing.js';
+/**
+ * Delegates span export to multiple underlying exporters.
+ */
+class CompositeExporter {
+    _exporters;
+    constructor(exporters) {
+        this._exporters = exporters;
+    }
+    export(span) {
+        for (const exp of this._exporters) {
+            try {
+                exp.export(span);
+            }
+            catch (e) {
+                console.warn('[apcore:extensions] Span exporter failed:', e);
+            }
+        }
+    }
+}
+/** Type guard: checks if value has a `discover` method. */
+function isDiscoverer(value) {
+    return typeof value === 'object' && value !== null && typeof value['discover'] === 'function';
+}
+/** Type guard: checks if value has a `validate` method. */
+function isModuleValidator(value) {
+    return typeof value === 'object' && value !== null && typeof value['validate'] === 'function';
+}
+/** Type guard: checks if value has at least one middleware method (before, after, onError). */
+function isMiddleware(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return typeof obj['before'] === 'function' || typeof obj['after'] === 'function' || typeof obj['onError'] === 'function';
+}
+/** Type guard: checks if value has a `check` method (ACL). */
+function isACL(value) {
+    return typeof value === 'object' && value !== null && typeof value['check'] === 'function';
+}
+/** Type guard: checks if value has an `export` method (SpanExporter). */
+function isSpanExporter(value) {
+    return typeof value === 'object' && value !== null && typeof value['export'] === 'function';
+}
+/** Type guard: checks if value has requestApproval and checkApproval methods. */
+function isApprovalHandler(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return typeof obj['requestApproval'] === 'function' && typeof obj['checkApproval'] === 'function';
+}
+function builtInPoints() {
+    return new Map([
+        ['discoverer', {
+                name: 'discoverer',
+                description: 'Custom module discovery strategy',
+                multiple: false,
+                typeCheck: isDiscoverer,
+                typeName: 'Discoverer',
+            }],
+        ['middleware', {
+                name: 'middleware',
+                description: 'Execution middleware',
+                multiple: true,
+                typeCheck: isMiddleware,
+                typeName: 'Middleware',
+            }],
+        ['acl', {
+                name: 'acl',
+                description: 'Access control provider',
+                multiple: false,
+                typeCheck: isACL,
+                typeName: 'ACL',
+            }],
+        ['span_exporter', {
+                name: 'span_exporter',
+                description: 'Tracing span exporter',
+                multiple: true,
+                typeCheck: isSpanExporter,
+                typeName: 'SpanExporter',
+            }],
+        ['module_validator', {
+                name: 'module_validator',
+                description: 'Custom module validation',
+                multiple: false,
+                typeCheck: isModuleValidator,
+                typeName: 'ModuleValidator',
+            }],
+        ['approval_handler', {
+                name: 'approval_handler',
+                description: 'Approval handler for Step 4.5 gate',
+                multiple: false,
+                typeCheck: isApprovalHandler,
+                typeName: 'ApprovalHandler',
+            }],
+    ]);
+}
+/**
+ * Manages extension points and their registered implementations.
+ *
+ * Pre-registers six built-in extension points: discoverer, middleware,
+ * acl, span_exporter, module_validator, and approval_handler.
+ */
+export class ExtensionManager {
+    _points;
+    _extensions;
+    constructor() {
+        this._points = builtInPoints();
+        this._extensions = new Map();
+        for (const name of this._points.keys()) {
+            this._extensions.set(name, []);
+        }
+    }
+    /**
+     * Register an extension for the given extension point.
+     *
+     * @throws Error if point_name is unknown.
+     * @throws Error if extension does not satisfy the type constraint.
+     */
+    register(pointName, extension) {
+        const point = this._points.get(pointName);
+        if (point === undefined) {
+            throw new Error(`Unknown extension point: '${pointName}'. Available: ${[...this._points.keys()].sort().join(', ')}`);
+        }
+        if (!point.typeCheck(extension)) {
+            throw new TypeError(`Extension for '${pointName}' must satisfy the ${point.typeName} interface`);
+        }
+        if (point.multiple) {
+            this._extensions.get(pointName).push(extension);
+        }
+        else {
+            this._extensions.set(pointName, [extension]);
+        }
+    }
+    /**
+     * Return the single extension for a non-multiple point, or null.
+     */
+    get(pointName) {
+        if (!this._points.has(pointName)) {
+            throw new Error(`Unknown extension point: '${pointName}'`);
+        }
+        const exts = this._extensions.get(pointName);
+        return exts.length > 0 ? exts[0] : null;
+    }
+    /**
+     * Return all extensions for a multiple-type point.
+     */
+    getAll(pointName) {
+        if (!this._points.has(pointName)) {
+            throw new Error(`Unknown extension point: '${pointName}'`);
+        }
+        return [...this._extensions.get(pointName)];
+    }
+    /**
+     * Remove a specific extension from an extension point.
+     * Returns true if found and removed, false otherwise.
+     */
+    unregister(pointName, extension) {
+        if (!this._points.has(pointName)) {
+            throw new Error(`Unknown extension point: '${pointName}'`);
+        }
+        const exts = this._extensions.get(pointName);
+        const idx = exts.indexOf(extension);
+        if (idx === -1)
+            return false;
+        exts.splice(idx, 1);
+        return true;
+    }
+    /**
+     * Return all registered extension points.
+     */
+    listPoints() {
+        return [...this._points.values()].map(({ name, description, multiple }) => ({
+            name,
+            description,
+            multiple,
+        }));
+    }
+    /**
+     * Wire all registered extensions into the given registry and executor.
+     */
+    apply(registry, executor) {
+        // Discoverer
+        const discoverer = this.get('discoverer');
+        if (discoverer !== null) {
+            registry.setDiscoverer(discoverer);
+        }
+        // Module validator
+        const validator = this.get('module_validator');
+        if (validator !== null) {
+            registry.setValidator(validator);
+        }
+        // ACL
+        const acl = this.get('acl');
+        if (acl !== null) {
+            executor.setAcl(acl);
+        }
+        // Approval handler
+        const approvalHandler = this.get('approval_handler');
+        if (approvalHandler !== null) {
+            executor.setApprovalHandler(approvalHandler);
+        }
+        // Middleware
+        for (const mw of this.getAll('middleware')) {
+            executor.use(mw);
+        }
+        // Span exporters: find existing TracingMiddleware and set exporter(s)
+        const exporters = this.getAll('span_exporter');
+        if (exporters.length > 0) {
+            const tracingMw = this._findTracingMiddleware(executor);
+            if (tracingMw !== null) {
+                if (exporters.length === 1) {
+                    tracingMw.setExporter(exporters[0]);
+                }
+                else {
+                    tracingMw.setExporter(new CompositeExporter(exporters));
+                }
+            }
+            else {
+                console.warn('[apcore:extensions] span_exporter extensions registered but no TracingMiddleware found in executor middleware chain');
+            }
+        }
+    }
+    _findTracingMiddleware(executor) {
+        for (const mw of executor.middlewares) {
+            if (mw instanceof TracingMiddleware) {
+                return mw;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

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

package/{src/index.ts → dist/index.d.ts}

@@ -1,80 +1,29 @@
 /**
  * apcore - Schema-driven module development framework.
  */
-
-// Core
 export { CancelToken, ExecutionCancelledError } from './cancel.js';
 export { Context, createIdentity } from './context.js';
 export type { Identity, ContextFactory } from './context.js';
 export { Registry, REGISTRY_EVENTS, MODULE_ID_PATTERN, MAX_MODULE_ID_LENGTH, RESERVED_WORDS } from './registry/registry.js';
 export type { Discoverer, ModuleValidator } from './registry/registry.js';
 export { Executor, redactSensitive, REDACTED_VALUE } from './executor.js';
-
-// Module types
 export { DEFAULT_ANNOTATIONS } from './module.js';
 export type { ModuleAnnotations, ModuleExample, ValidationResult, Module } from './module.js';
-
-// Config
 export { Config } from './config.js';
-
-// Errors
-export {
-  ModuleError,
-  ConfigNotFoundError,
-  ConfigError,
-  ACLRuleError,
-  ACLDeniedError,
-  ModuleNotFoundError,
-  ModuleTimeoutError,
-  SchemaValidationError,
-  SchemaNotFoundError,
-  SchemaParseError,
-  SchemaCircularRefError,
-  CallDepthExceededError,
-  CircularCallError,
-  CallFrequencyExceededError,
-  InvalidInputError,
-  FuncMissingTypeHintError,
-  FuncMissingReturnTypeError,
-  BindingInvalidTargetError,
-  BindingModuleNotFoundError,
-  BindingCallableNotFoundError,
-  BindingNotCallableError,
-  BindingSchemaMissingError,
-  BindingFileInvalidError,
-  CircularDependencyError,
-  ModuleLoadError,
-  ModuleExecuteError,
-  InternalError,
-  ErrorCodes,
-} from './errors.js';
-export type { ErrorCode } from './errors.js';
-
-// ACL
+export { createApprovalRequest, createApprovalResult, AlwaysDenyHandler, AutoApproveHandler, CallbackApprovalHandler, } from './approval.js';
+export type { ApprovalRequest, ApprovalResult, ApprovalHandler } from './approval.js';
+export { ModuleError, ConfigNotFoundError, ConfigError, ACLRuleError, ACLDeniedError, ApprovalError, ApprovalDeniedError, ApprovalTimeoutError, ApprovalPendingError, ModuleNotFoundError, ModuleTimeoutError, SchemaValidationError, SchemaNotFoundError, SchemaParseError, SchemaCircularRefError, CallDepthExceededError, CircularCallError, CallFrequencyExceededError, InvalidInputError, FuncMissingTypeHintError, FuncMissingReturnTypeError, BindingInvalidTargetError, BindingModuleNotFoundError, BindingCallableNotFoundError, BindingNotCallableError, BindingSchemaMissingError, BindingFileInvalidError, CircularDependencyError, ModuleLoadError, ModuleExecuteError, InternalError, ErrorCodes, } from './errors.js';
+export type { ErrorCode, ErrorOptions } from './errors.js';
 export { ACL } from './acl.js';
 export type { ACLRule } from './acl.js';
-
-// Middleware
 export { Middleware, MiddlewareManager, MiddlewareChainError, BeforeMiddleware, AfterMiddleware, LoggingMiddleware } from './middleware/index.js';
-
-// Decorator
 export { module, FunctionModule, normalizeResult, makeAutoId } from './decorator.js';
-
-// Extensions
 export { ExtensionManager } from './extensions.js';
 export type { ExtensionPoint } from './extensions.js';
-
-// Async tasks
 export { AsyncTaskManager, TaskStatus } from './async-task.js';
 export type { TaskInfo } from './async-task.js';
-
-// Bindings
 export { BindingLoader } from './bindings.js';
-
-// Utils
 export { matchPattern } from './utils/pattern.js';
-
-// Schema
 export { SchemaLoader, jsonSchemaToTypeBox } from './schema/loader.js';
 export { SchemaValidator } from './schema/validator.js';
 export { SchemaExporter } from './schema/exporter.js';
@@ -82,18 +31,12 @@ export { SchemaStrategy, ExportProfile } from './schema/types.js';
 export type { SchemaDefinition, ResolvedSchema, SchemaValidationErrorDetail, SchemaValidationResult } from './schema/types.js';
 export { RefResolver } from './schema/ref-resolver.js';
 export { toStrictSchema, applyLlmDescriptions, stripExtensions } from './schema/strict.js';
-
-// Registry types
 export type { ModuleDescriptor, DiscoveredModule, DependencyInfo } from './registry/types.js';
-
-// Observability
 export { TracingMiddleware, StdoutExporter, InMemoryExporter, OTLPExporter, createSpan } from './observability/tracing.js';
 export type { Span, SpanExporter } from './observability/tracing.js';
 export { MetricsCollector, MetricsMiddleware } from './observability/metrics.js';
 export { ContextLogger, ObsLoggingMiddleware } from './observability/context-logger.js';
-
-// Trace Context
 export { TraceContext } from './trace-context.js';
 export type { TraceParent } from './trace-context.js';
-
-export const VERSION = '0.3.0';
+export declare const VERSION = "0.7.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,45 @@
+/**
+ * apcore - Schema-driven module development framework.
+ */
+// Core
+export { CancelToken, ExecutionCancelledError } from './cancel.js';
+export { Context, createIdentity } from './context.js';
+export { Registry, REGISTRY_EVENTS, MODULE_ID_PATTERN, MAX_MODULE_ID_LENGTH, RESERVED_WORDS } from './registry/registry.js';
+export { Executor, redactSensitive, REDACTED_VALUE } from './executor.js';
+// Module types
+export { DEFAULT_ANNOTATIONS } from './module.js';
+// Config
+export { Config } from './config.js';
+// Approval
+export { createApprovalRequest, createApprovalResult, AlwaysDenyHandler, AutoApproveHandler, CallbackApprovalHandler, } from './approval.js';
+// Errors
+export { ModuleError, ConfigNotFoundError, ConfigError, ACLRuleError, ACLDeniedError, ApprovalError, ApprovalDeniedError, ApprovalTimeoutError, ApprovalPendingError, ModuleNotFoundError, ModuleTimeoutError, SchemaValidationError, SchemaNotFoundError, SchemaParseError, SchemaCircularRefError, CallDepthExceededError, CircularCallError, CallFrequencyExceededError, InvalidInputError, FuncMissingTypeHintError, FuncMissingReturnTypeError, BindingInvalidTargetError, BindingModuleNotFoundError, BindingCallableNotFoundError, BindingNotCallableError, BindingSchemaMissingError, BindingFileInvalidError, CircularDependencyError, ModuleLoadError, ModuleExecuteError, InternalError, ErrorCodes, } from './errors.js';
+// ACL
+export { ACL } from './acl.js';
+// Middleware
+export { Middleware, MiddlewareManager, MiddlewareChainError, BeforeMiddleware, AfterMiddleware, LoggingMiddleware } from './middleware/index.js';
+// Decorator
+export { module, FunctionModule, normalizeResult, makeAutoId } from './decorator.js';
+// Extensions
+export { ExtensionManager } from './extensions.js';
+// Async tasks
+export { AsyncTaskManager, TaskStatus } from './async-task.js';
+// Bindings
+export { BindingLoader } from './bindings.js';
+// Utils
+export { matchPattern } from './utils/pattern.js';
+// Schema
+export { SchemaLoader, jsonSchemaToTypeBox } from './schema/loader.js';
+export { SchemaValidator } from './schema/validator.js';
+export { SchemaExporter } from './schema/exporter.js';
+export { SchemaStrategy, ExportProfile } from './schema/types.js';
+export { RefResolver } from './schema/ref-resolver.js';
+export { toStrictSchema, applyLlmDescriptions, stripExtensions } from './schema/strict.js';
+// Observability
+export { TracingMiddleware, StdoutExporter, InMemoryExporter, OTLPExporter, createSpan } from './observability/tracing.js';
+export { MetricsCollector, MetricsMiddleware } from './observability/metrics.js';
+export { ContextLogger, ObsLoggingMiddleware } from './observability/context-logger.js';
+// Trace Context
+export { TraceContext } from './trace-context.js';
+export const VERSION = '0.7.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/middleware/adapters.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Function adapter classes for the middleware system.
+ */
+import type { Context } from '../context.js';
+import { Middleware } from './base.js';
+export type BeforeCallback = (moduleId: string, inputs: Record<string, unknown>, context: Context) => Record<string, unknown> | null;
+export type AfterCallback = (moduleId: string, inputs: Record<string, unknown>, output: Record<string, unknown>, context: Context) => Record<string, unknown> | null;
+export declare class BeforeMiddleware extends Middleware {
+    private _callback;
+    constructor(callback: BeforeCallback);
+    before(moduleId: string, inputs: Record<string, unknown>, context: Context): Record<string, unknown> | null;
+}
+export declare class AfterMiddleware extends Middleware {
+    private _callback;
+    constructor(callback: AfterCallback);
+    after(moduleId: string, inputs: Record<string, unknown>, output: Record<string, unknown>, context: Context): Record<string, unknown> | null;
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/middleware/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/middleware/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,KACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,KACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AAEpC,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,SAAS,CAAiB;gBAEtB,QAAQ,EAAE,cAAc;IAK3B,MAAM,CACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlC;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAO,CAAC,SAAS,CAAgB;gBAErB,QAAQ,EAAE,aAAa;IAK1B,KAAK,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlC"}

package/dist/middleware/adapters.js

@@ -0,0 +1,25 @@
+/**
+ * Function adapter classes for the middleware system.
+ */
+import { Middleware } from './base.js';
+export class BeforeMiddleware extends Middleware {
+    _callback;
+    constructor(callback) {
+        super();
+        this._callback = callback;
+    }
+    before(moduleId, inputs, context) {
+        return this._callback(moduleId, inputs, context);
+    }
+}
+export class AfterMiddleware extends Middleware {
+    _callback;
+    constructor(callback) {
+        super();
+        this._callback = callback;
+    }
+    after(moduleId, inputs, output, context) {
+        return this._callback(moduleId, inputs, output, context);
+    }
+}
+//# sourceMappingURL=adapters.js.map

package/dist/middleware/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/middleware/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAevC,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IACtC,SAAS,CAAiB;IAElC,YAAY,QAAwB;QAClC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEQ,MAAM,CACb,QAAgB,EAChB,MAA+B,EAC/B,OAAgB;QAEhB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IACrC,SAAS,CAAgB;IAEjC,YAAY,QAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEQ,KAAK,CACZ,QAAgB,EAChB,MAA+B,EAC/B,MAA+B,EAC/B,OAAgB;QAEhB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/middleware/base.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Middleware base class for apcore.
+ */
+import type { Context } from '../context.js';
+export declare class Middleware {
+    before(_moduleId: string, _inputs: Record<string, unknown>, _context: Context): Record<string, unknown> | null;
+    after(_moduleId: string, _inputs: Record<string, unknown>, _output: Record<string, unknown>, _context: Context): Record<string, unknown> | null;
+    onError(_moduleId: string, _inputs: Record<string, unknown>, _error: Error, _context: Context): Record<string, unknown> | null;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/middleware/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/middleware/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,qBAAa,UAAU;IACrB,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjC,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjC,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlC"}

package/dist/middleware/base.js

@@ -0,0 +1,15 @@
+/**
+ * Middleware base class for apcore.
+ */
+export class Middleware {
+    before(_moduleId, _inputs, _context) {
+        return null;
+    }
+    after(_moduleId, _inputs, _output, _context) {
+        return null;
+    }
+    onError(_moduleId, _inputs, _error, _context) {
+        return null;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/middleware/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/middleware/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAO,UAAU;IACrB,MAAM,CACJ,SAAiB,EACjB,OAAgC,EAChC,QAAiB;QAEjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CACH,SAAiB,EACjB,OAAgC,EAChC,OAAgC,EAChC,QAAiB;QAEjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,SAAiB,EACjB,OAAgC,EAChC,MAAa,EACb,QAAiB;QAEjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/{src/middleware/index.ts → dist/middleware/index.d.ts}

@@ -4,3 +4,4 @@ export { BeforeMiddleware, AfterMiddleware } from './adapters.js';
 export type { BeforeCallback, AfterCallback } from './adapters.js';
 export { LoggingMiddleware } from './logging.js';
 export type { Logger } from './logging.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,5 @@
+export { Middleware } from './base.js';
+export { MiddlewareManager, MiddlewareChainError } from './manager.js';
+export { BeforeMiddleware, AfterMiddleware } from './adapters.js';
+export { LoggingMiddleware } from './logging.js';
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/logging.d.ts

@@ -0,0 +1,25 @@
+/**
+ * LoggingMiddleware for structured module call logging.
+ */
+import type { Context } from '../context.js';
+import { Middleware } from './base.js';
+export interface Logger {
+    info(message: string, extra?: Record<string, unknown>): void;
+    error(message: string, extra?: Record<string, unknown>): void;
+}
+export declare class LoggingMiddleware extends Middleware {
+    private _logger;
+    private _logInputs;
+    private _logOutputs;
+    private _logErrors;
+    constructor(options?: {
+        logger?: Logger;
+        logInputs?: boolean;
+        logOutputs?: boolean;
+        logErrors?: boolean;
+    });
+    before(moduleId: string, inputs: Record<string, unknown>, context: Context): null;
+    after(moduleId: string, _inputs: Record<string, unknown>, output: Record<string, unknown>, context: Context): null;
+    onError(moduleId: string, inputs: Record<string, unknown>, error: Error, context: Context): null;
+}
+//# sourceMappingURL=logging.d.ts.map

package/dist/middleware/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/middleware/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/D;AAWD,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,UAAU,CAAU;gBAEhB,OAAO,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;IAQQ,MAAM,CACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,GACf,IAAI;IAgBE,KAAK,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,GACf,IAAI;IAmBE,OAAO,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,GACf,IAAI;CAaR"}

package/dist/middleware/logging.js

@@ -0,0 +1,64 @@
+/**
+ * LoggingMiddleware for structured module call logging.
+ */
+import { Middleware } from './base.js';
+const defaultLogger = {
+    info(message, extra) {
+        console.info(message, extra ?? '');
+    },
+    error(message, extra) {
+        console.error(message, extra ?? '');
+    },
+};
+export class LoggingMiddleware extends Middleware {
+    _logger;
+    _logInputs;
+    _logOutputs;
+    _logErrors;
+    constructor(options) {
+        super();
+        this._logger = options?.logger ?? defaultLogger;
+        this._logInputs = options?.logInputs ?? true;
+        this._logOutputs = options?.logOutputs ?? true;
+        this._logErrors = options?.logErrors ?? true;
+    }
+    before(moduleId, inputs, context) {
+        context.data['_logging_mw_start'] = performance.now();
+        if (this._logInputs) {
+            const redacted = context.redactedInputs ?? inputs;
+            this._logger.info(`[${context.traceId}] START ${moduleId}`, {
+                traceId: context.traceId,
+                moduleId,
+                callerId: context.callerId,
+                inputs: redacted,
+            });
+        }
+        return null;
+    }
+    after(moduleId, _inputs, output, context) {
+        const startTime = context.data['_logging_mw_start'] ?? performance.now();
+        const durationMs = performance.now() - startTime;
+        if (this._logOutputs) {
+            this._logger.info(`[${context.traceId}] END ${moduleId} (${durationMs.toFixed(2)}ms)`, {
+                traceId: context.traceId,
+                moduleId,
+                durationMs,
+                output,
+            });
+        }
+        return null;
+    }
+    onError(moduleId, inputs, error, context) {
+        if (this._logErrors) {
+            const redacted = context.redactedInputs ?? inputs;
+            this._logger.error(`[${context.traceId}] ERROR ${moduleId}: ${error}`, {
+                traceId: context.traceId,
+                moduleId,
+                error: String(error),
+                inputs: redacted,
+            });
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/middleware/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/middleware/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAOvC,MAAM,aAAa,GAAW;IAC5B,IAAI,CAAC,OAAe,EAAE,KAA+B;QACnD,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,KAA+B;QACpD,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;CACF,CAAC;AAEF,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IACvC,OAAO,CAAS;IAChB,UAAU,CAAU;IACpB,WAAW,CAAU;IACrB,UAAU,CAAU;IAE5B,YAAY,OAKX;QACC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;IAC/C,CAAC;IAEQ,MAAM,CACb,QAAgB,EAChB,MAA+B,EAC/B,OAAgB;QAEhB,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC;YAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,WAAW,QAAQ,EAAE,EAAE;gBAC1D,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ;gBACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,KAAK,CACZ,QAAgB,EAChB,OAAgC,EAChC,MAA+B,EAC/B,OAAgB;QAEhB,MAAM,SAAS,GAAI,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAY,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;QACrF,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEjD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,IAAI,OAAO,CAAC,OAAO,SAAS,QAAQ,KAAK,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EACnE;gBACE,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ;gBACR,UAAU;gBACV,MAAM;aACP,CACF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,OAAO,CACd,QAAgB,EAChB,MAA+B,EAC/B,KAAY,EACZ,OAAgB;QAEhB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC;YAClD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,WAAW,QAAQ,KAAK,KAAK,EAAE,EAAE;gBACrE,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ;gBACR,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpB,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}