apcore-js 0.5.0 → 0.7.0

package/src/config.ts

@@ -1,24 +0,0 @@
-/**
- * Configuration accessor with dot-path key support.
- */
-
-export class Config {
-  private _data: Record<string, unknown>;
-
-  constructor(data?: Record<string, unknown>) {
-    this._data = data ?? {};
-  }
-
-  get(key: string, defaultValue?: unknown): unknown {
-    const parts = key.split('.');
-    let current: unknown = this._data;
-    for (const part of parts) {
-      if (current !== null && typeof current === 'object' && part in (current as Record<string, unknown>)) {
-        current = (current as Record<string, unknown>)[part];
-      } else {
-        return defaultValue;
-      }
-    }
-    return current;
-  }
-}

package/src/context.ts

@@ -1,160 +0,0 @@
-
-import { v4 as uuidv4 } from 'uuid';
-import type { CancelToken } from './cancel.js';
-import type { TraceParent } from './trace-context.js';
-
-/**
- * Execution context, identity, and context creation.
- */
-
-export interface Identity {
-  readonly id: string;
-  readonly type: string;
-  readonly roles: readonly string[];
-  readonly attrs: Readonly<Record<string, unknown>>;
-}
-
-export function createIdentity(
-  id: string,
-  type: string = 'user',
-  roles: string[] = [],
-  attrs: Record<string, unknown> = {},
-): Identity {
-  return Object.freeze({ id, type, roles: Object.freeze([...roles]), attrs: Object.freeze({ ...attrs }) });
-}
-
-export class Context {
-  readonly traceId: string;
-  readonly callerId: string | null;
-  readonly callChain: readonly string[];
-  readonly executor: unknown;
-  readonly identity: Identity | null;
-  redactedInputs: Record<string, unknown> | null;
-  readonly data: Record<string, unknown>;
-  readonly cancelToken: CancelToken | null;
-
-  constructor(
-    traceId: string,
-    callerId: string | null = null,
-    callChain: string[] = [],
-    executor: unknown = null,
-    identity: Identity | null = null,
-    redactedInputs: Record<string, unknown> | null = null,
-    data: Record<string, unknown> = {},
-    cancelToken: CancelToken | null = null,
-  ) {
-    this.traceId = traceId;
-    this.callerId = callerId;
-    this.callChain = Object.freeze([...callChain]);
-    this.executor = executor;
-    this.identity = identity;
-    this.redactedInputs = redactedInputs;
-    this.data = data;
-    this.cancelToken = cancelToken;
-  }
-
-  /**
-   * Create a new top-level Context with a generated UUID v4 traceId.
-   *
-   * When `traceParent` is provided, its `traceId` (32 hex chars) is
-   * converted to UUID format (8-4-4-4-12) and used instead of generating
-   * a new one.
-   */
-  static create(
-    executor: unknown = null,
-    identity: Identity | null = null,
-    data?: Record<string, unknown>,
-    traceParent?: TraceParent | null,
-  ): Context {
-    let traceId: string;
-    if (traceParent) {
-      const h = traceParent.traceId;
-      traceId = `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
-    } else {
-      traceId = uuidv4();
-    }
-    return new Context(
-      traceId,
-      null,
-      [],
-      executor,
-      identity,
-      null,
-      data ?? {},
-    );
-  }
-
-  toJSON(): Record<string, unknown> {
-    const publicData: Record<string, unknown> = {};
-    for (const [key, value] of Object.entries(this.data)) {
-      if (!key.startsWith('_')) {
-        publicData[key] = value;
-      }
-    }
-    return {
-      traceId: this.traceId,
-      callerId: this.callerId,
-      callChain: [...this.callChain],
-      identity: this.identity ? {
-        id: this.identity.id,
-        type: this.identity.type,
-        roles: [...this.identity.roles],
-        attrs: { ...this.identity.attrs },
-      } : null,
-      redactedInputs: this.redactedInputs ? { ...this.redactedInputs } : null,
-      data: publicData,
-    };
-  }
-
-  static fromJSON(data: Record<string, unknown>, executor?: unknown): Context {
-    const identityData = data.identity as Record<string, unknown> | null;
-    const identity = identityData ? {
-      id: identityData.id as string,
-      type: (identityData.type as string) ?? 'user',
-      roles: Object.freeze([...(Array.isArray(identityData.roles) ? identityData.roles : [])]),
-      attrs: Object.freeze((identityData.attrs && typeof identityData.attrs === 'object' ? identityData.attrs : {}) as Record<string, unknown>),
-    } : null;
-    return new Context(
-      data.traceId as string,
-      (data.callerId as string) ?? null,
-      (data.callChain as string[]) ?? [],
-      executor ?? null,
-      identity,
-      (data.redactedInputs as Record<string, unknown>) ?? null,
-      data.data ? { ...(data.data as Record<string, unknown>) } : {},
-    );
-  }
-
-  get logger(): { debug: (...args: unknown[]) => void; info: (...args: unknown[]) => void; warn: (...args: unknown[]) => void; error: (...args: unknown[]) => void } {
-    const prefix = `[apcore:${this.callerId ?? 'unknown'}]`;
-    return {
-      debug: (...args: unknown[]) => console.debug(prefix, ...args),
-      info: (...args: unknown[]) => console.info(prefix, ...args),
-      warn: (...args: unknown[]) => console.warn(prefix, ...args),
-      error: (...args: unknown[]) => console.error(prefix, ...args),
-    };
-  }
-
-  child(targetModuleId: string): Context {
-    return new Context(
-      this.traceId,
-      this.callChain.length > 0 ? this.callChain[this.callChain.length - 1] : null,
-      [...this.callChain, targetModuleId],
-      this.executor,
-      this.identity,
-      null,
-      this.data, // shared reference
-      this.cancelToken,
-    );
-  }
-}
-
-/**
- * Interface for creating Context from framework-specific requests.
- *
- * Web framework integrations should implement this to extract Identity
- * from HTTP requests (e.g., Express request, JWT tokens, API keys).
- */
-export interface ContextFactory {
-  createContext(request: unknown): Context;
-}

package/src/decorator.ts

@@ -1,110 +0,0 @@
-/**
- * Module factory, FunctionModule wrapper.
- *
- * TypeScript version uses explicit TypeBox schemas instead of runtime type inference.
- */
-
-import type { TSchema } from '@sinclair/typebox';
-import type { Context } from './context.js';
-import type { ModuleAnnotations, ModuleExample } from './module.js';
-
-export function normalizeResult(result: unknown): Record<string, unknown> {
-  if (result === null || result === undefined) return {};
-  if (typeof result === 'object' && !Array.isArray(result)) return result as Record<string, unknown>;
-  return { result };
-}
-
-export class FunctionModule {
-  readonly moduleId: string;
-  readonly inputSchema: TSchema;
-  readonly outputSchema: TSchema;
-  readonly description: string;
-  readonly documentation: string | null;
-  readonly tags: string[] | null;
-  readonly version: string;
-  readonly annotations: ModuleAnnotations | null;
-  readonly metadata: Record<string, unknown> | null;
-  readonly examples: ModuleExample[] | null;
-
-  private _executeFn: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
-
-  constructor(options: {
-    execute: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
-    moduleId: string;
-    inputSchema: TSchema;
-    outputSchema: TSchema;
-    description?: string;
-    documentation?: string | null;
-    tags?: string[] | null;
-    version?: string;
-    annotations?: ModuleAnnotations | null;
-    metadata?: Record<string, unknown> | null;
-    examples?: ModuleExample[] | null;
-  }) {
-    this.moduleId = options.moduleId;
-    this.inputSchema = options.inputSchema;
-    this.outputSchema = options.outputSchema;
-    this.description = options.description ?? `Module ${options.moduleId}`;
-    this.documentation = options.documentation ?? null;
-    this.tags = options.tags ?? null;
-    this.version = options.version ?? '1.0.0';
-    this.annotations = options.annotations ?? null;
-    this.metadata = options.metadata ?? null;
-    this.examples = options.examples ?? null;
-    this._executeFn = options.execute;
-  }
-
-  async execute(inputs: Record<string, unknown>, context: Context): Promise<Record<string, unknown>> {
-    const result = await this._executeFn(inputs, context);
-    return normalizeResult(result);
-  }
-}
-
-export function makeAutoId(name: string): string {
-  let raw = name.toLowerCase();
-  raw = raw.replace(/[^a-z0-9_.]/g, '_');
-  const segments = raw.split('.');
-  return segments
-    .map((s) => (s && s[0] >= '0' && s[0] <= '9' ? '_' + s : s))
-    .join('.');
-}
-
-/**
- * Create a FunctionModule from options. TypeScript version requires explicit schemas.
- */
-export function module(options: {
-  id?: string;
-  inputSchema: TSchema;
-  outputSchema: TSchema;
-  description?: string;
-  documentation?: string | null;
-  annotations?: ModuleAnnotations | null;
-  tags?: string[] | null;
-  version?: string;
-  metadata?: Record<string, unknown> | null;
-  examples?: ModuleExample[] | null;
-  execute: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
-  registry?: { register(moduleId: string, module: unknown): void } | null;
-}): FunctionModule {
-  const moduleId = options.id ?? makeAutoId('anonymous');
-
-  const fm = new FunctionModule({
-    execute: options.execute,
-    moduleId,
-    inputSchema: options.inputSchema,
-    outputSchema: options.outputSchema,
-    description: options.description,
-    documentation: options.documentation,
-    tags: options.tags,
-    version: options.version,
-    annotations: options.annotations,
-    metadata: options.metadata,
-    examples: options.examples,
-  });
-
-  if (options.registry) {
-    options.registry.register(fm.moduleId, fm);
-  }
-
-  return fm;
-}