veryfront 0.1.215 → 0.1.217

package/esm/src/extensions/interfaces/ai-model-provider.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Contract interface for AI/LLM model providers.
+ *
+ * Default implementation: `@veryfront/ext-openai`
+ *
+ * @module extensions/interfaces/ai-model-provider
+ */
+/** A single part of a multi-modal message (text or image). */
+export interface ContentPart {
+    /** Part type. */
+    type: "text" | "image";
+    /** Text content (when `type` is `"text"`). */
+    text?: string;
+    /** Image URL or base64 data (when `type` is `"image"`). */
+    imageUrl?: string;
+}
+/** A chat message in a conversation. */
+export interface ChatMessage {
+    /** Message role. */
+    role: "system" | "user" | "assistant" | "tool";
+    /** Simple text content. */
+    content?: string;
+    /** Multi-modal content parts (used instead of `content`). */
+    parts?: ContentPart[];
+    /** Tool call ID this message responds to (for `tool` role). */
+    toolCallId?: string;
+}
+/** Definition of a tool the model may invoke. */
+export interface ToolDefinition {
+    /** Tool name. */
+    name: string;
+    /** Human-readable description of what the tool does. */
+    description: string;
+    /** JSON Schema describing the tool's parameters. */
+    parameters: Record<string, unknown>;
+}
+/** Options passed to {@link AIModelProvider.complete} and {@link AIModelProvider.stream}. */
+export interface CompletionOptions {
+    /** Model identifier (e.g. `"gpt-4o"`, `"claude-sonnet-4-20250514"`). */
+    model: string;
+    /** Conversation messages. */
+    messages: ChatMessage[];
+    /** Sampling temperature. */
+    temperature?: number;
+    /** Maximum tokens to generate. */
+    maxTokens?: number;
+    /** Available tools for function calling. */
+    tools?: ToolDefinition[];
+    /** Additional provider-specific options. */
+    [key: string]: unknown;
+}
+/** Result returned from {@link AIModelProvider.complete}. */
+export interface CompletionResult {
+    /** Generated text content. */
+    content: string;
+    /** Tool calls requested by the model, if any. */
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    /** Token usage statistics. */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/** A chunk emitted during streaming completion. */
+export interface StreamChunk {
+    /** Incremental text delta. */
+    content?: string;
+    /** Incremental tool call delta. */
+    toolCallDelta?: {
+        id?: string;
+        name?: string;
+        arguments?: string;
+    };
+    /** Whether this is the final chunk. */
+    done: boolean;
+}
+/**
+ * AIModelProvider contract interface.
+ *
+ * Implementations provide chat completion and streaming capabilities
+ * against large language models.
+ */
+export interface AIModelProvider {
+    /** Generate a complete response for the given conversation. */
+    complete(options: CompletionOptions): Promise<CompletionResult>;
+    /** Stream a response token-by-token. */
+    stream(options: CompletionOptions): AsyncIterable<StreamChunk>;
+}
+//# sourceMappingURL=ai-model-provider.d.ts.map

package/esm/src/extensions/interfaces/ai-model-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-provider.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/ai-model-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,8BAA8B;IAC9B,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,aAAa,CAAC,EAAE;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,wCAAwC;IACxC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;CAChE"}

package/esm/src/extensions/interfaces/ai-model-provider.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for AI/LLM model providers.
+ *
+ * Default implementation: `@veryfront/ext-openai`
+ *
+ * @module extensions/interfaces/ai-model-provider
+ */
+export {};

package/esm/src/extensions/interfaces/auth-provider.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Contract interface for authentication token providers.
+ *
+ * Default implementation: `@veryfront/ext-jwt`
+ *
+ * @module extensions/interfaces/auth-provider
+ */
+/** Payload data stored within a signed token. */
+export interface TokenPayload {
+    /** Subject identifier (typically a user ID). */
+    sub: string;
+    /** Expiration time as a Unix timestamp (seconds). */
+    exp?: number;
+    /** Issued-at time as a Unix timestamp (seconds). */
+    iat?: number;
+    /** Additional claims. */
+    [key: string]: unknown;
+}
+/** Options for signing a token. */
+export interface SignOptions {
+    /** Token lifetime (e.g. `"1h"`, `"7d"`, or seconds as a number). */
+    expiresIn?: string | number;
+    /** Signing algorithm (e.g. `"HS256"`, `"RS256"`). */
+    algorithm?: string;
+    /** Additional implementation-specific options. */
+    [key: string]: unknown;
+}
+/** Options for verifying a token. */
+export interface VerifyOptions {
+    /** Expected algorithms to accept. */
+    algorithms?: string[];
+    /** Additional implementation-specific options. */
+    [key: string]: unknown;
+}
+/**
+ * AuthProvider contract interface.
+ *
+ * Implementations sign, verify, and decode authentication tokens
+ * (e.g. JWTs) for request authentication.
+ */
+export interface AuthProvider {
+    /** Sign a payload into a token string. */
+    sign(payload: TokenPayload, options?: SignOptions): Promise<string>;
+    /** Verify a token and return its decoded payload. Throws on invalid tokens. */
+    verify(token: string, options?: VerifyOptions): Promise<TokenPayload>;
+    /** Decode a token without verifying its signature. */
+    decode(token: string): TokenPayload | undefined;
+}
+//# sourceMappingURL=auth-provider.d.ts.map

package/esm/src/extensions/interfaces/auth-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-provider.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/auth-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kDAAkD;IAClD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,+EAA+E;IAC/E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtE,sDAAsD;IACtD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;CACjD"}

package/esm/src/extensions/interfaces/auth-provider.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for authentication token providers.
+ *
+ * Default implementation: `@veryfront/ext-jwt`
+ *
+ * @module extensions/interfaces/auth-provider
+ */
+export {};

package/esm/src/extensions/interfaces/bundler.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Contract interface for module bundlers.
+ *
+ * Default implementation: `@veryfront/ext-esbuild`
+ *
+ * @module extensions/interfaces/bundler
+ */
+/** Options passed to {@link Bundler.bundle}. */
+export interface BundleOptions {
+    /** Entry point file paths. */
+    entryPoints: string[];
+    /** Output directory. */
+    outdir: string;
+    /** Bundle format (`esm`, `cjs`, `iife`). */
+    format?: "esm" | "cjs" | "iife";
+    /** Target environment(s). */
+    target?: string | string[];
+    /** Enable minification. */
+    minify?: boolean;
+    /** Enable source maps. */
+    sourcemap?: boolean | "inline" | "external";
+    /** Enable code splitting. */
+    splitting?: boolean;
+    /** Additional plugins. */
+    plugins?: BundlerPlugin[];
+    /** Extra implementation-specific options. */
+    [key: string]: unknown;
+}
+/** A single output file produced by a bundle operation. */
+export interface BundleOutput {
+    /** Absolute path to the output file. */
+    path: string;
+    /** Raw byte content. */
+    contents: Uint8Array;
+}
+/** Result returned from {@link Bundler.bundle}. */
+export interface BundleResult {
+    /** Output files produced by the bundle. */
+    outputs: BundleOutput[];
+    /** Warnings emitted during bundling. */
+    warnings: string[];
+    /** Errors encountered during bundling. */
+    errors: string[];
+}
+/** Options passed to {@link Bundler.transform}. */
+export interface TransformOptions {
+    /** Source code to transform. */
+    code: string;
+    /** Loader hint (`ts`, `tsx`, `jsx`, `css`, etc.). */
+    loader?: string;
+    /** Output format. */
+    format?: "esm" | "cjs" | "iife";
+    /** Target environment(s). */
+    target?: string | string[];
+    /** Enable minification. */
+    minify?: boolean;
+    /** Enable source maps. */
+    sourcemap?: boolean | "inline" | "external";
+    /** Extra implementation-specific options. */
+    [key: string]: unknown;
+}
+/** Result returned from {@link Bundler.transform}. */
+export interface TransformResult {
+    /** Transformed source code. */
+    code: string;
+    /** Source map, if requested. */
+    map?: string;
+    /** Warnings emitted during transformation. */
+    warnings: string[];
+}
+/** Build context exposed to bundler plugins. */
+export interface BundlerPluginBuild {
+    /** Register a resolver callback for the given filter. */
+    onResolve(options: {
+        filter: RegExp;
+        namespace?: string;
+    }, callback: (args: {
+        path: string;
+        namespace: string;
+    }) => {
+        path?: string;
+        namespace?: string;
+        external?: boolean;
+    } | undefined): void;
+    /** Register a loader callback for the given filter. */
+    onLoad(options: {
+        filter: RegExp;
+        namespace?: string;
+    }, callback: (args: {
+        path: string;
+        namespace: string;
+    }) => {
+        contents?: string;
+        loader?: string;
+    } | undefined): void;
+}
+/** A bundler plugin that hooks into the build pipeline. */
+export interface BundlerPlugin {
+    /** Unique plugin name. */
+    name: string;
+    /** Called once when the plugin is registered. */
+    setup(build: BundlerPluginBuild): void;
+}
+/**
+ * Bundler contract interface.
+ *
+ * Implementations compile and bundle application source code into
+ * optimized output suitable for deployment or development.
+ */
+export interface Bundler {
+    /** Bundle one or more entry points into output files. */
+    bundle(options: BundleOptions): Promise<BundleResult>;
+    /** Transform a single source string without writing to disk. */
+    transform(options: TransformOptions): Promise<TransformResult>;
+    /** Release bundler resources (child processes, watchers, etc.). */
+    stop?(): Promise<void>;
+}
+//# sourceMappingURL=bundler.d.ts.map

package/esm/src/extensions/interfaces/bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/bundler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAChC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5C,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAChC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5C,6CAA6C;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,SAAS,CACP,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAC/C,QAAQ,EAAE,CACR,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KACtC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,GACzE,IAAI,CAAC;IACR,uDAAuD;IACvD,MAAM,CACJ,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAC/C,QAAQ,EAAE,CACR,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KACtC;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GACtD,IAAI,CAAC;CACT;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,yDAAyD;IACzD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,gEAAgE;IAChE,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/D,mEAAmE;IACnE,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/esm/src/extensions/interfaces/bundler.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for module bundlers.
+ *
+ * Default implementation: `@veryfront/ext-esbuild`
+ *
+ * @module extensions/interfaces/bundler
+ */
+export {};

package/esm/src/extensions/interfaces/cache-store.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Contract interface for key-value cache stores.
+ *
+ * Default implementation: `@veryfront/ext-redis`
+ *
+ * @module extensions/interfaces/cache-store
+ */
+/**
+ * CacheStore contract interface.
+ *
+ * Implementations provide key-value caching with optional TTL support.
+ */
+export interface CacheStore {
+    /** Retrieve a cached value by key. Returns `undefined` on miss. */
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    /** Store a value under the given key with an optional TTL in seconds. */
+    set<T = unknown>(key: string, value: T, ttl?: number): Promise<void>;
+    /** Delete a cached entry. */
+    delete(key: string): Promise<void>;
+    /** Check whether a key exists in the cache. */
+    has(key: string): Promise<boolean>;
+    /** Remove all entries from the cache. */
+    clear(): Promise<void>;
+    /** Close connections and release resources. */
+    disconnect?(): Promise<void>;
+}
+//# sourceMappingURL=cache-store.d.ts.map

package/esm/src/extensions/interfaces/cache-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-store.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/cache-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACtD,yEAAyE;IACzE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,6BAA6B;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,+CAA+C;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,yCAAyC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,+CAA+C;IAC/C,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B"}

package/esm/src/extensions/interfaces/cache-store.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for key-value cache stores.
+ *
+ * Default implementation: `@veryfront/ext-redis`
+ *
+ * @module extensions/interfaces/cache-store
+ */
+export {};

package/esm/src/extensions/interfaces/code-parser.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Contract interface for code parsing and AST manipulation.
+ *
+ * Default implementation: `@veryfront/ext-babel`
+ *
+ * @module extensions/interfaces/code-parser
+ */
+/** A single node in an abstract syntax tree. */
+export interface ASTNode {
+    /** Node type identifier (e.g. `"Identifier"`, `"CallExpression"`). */
+    type: string;
+    /** Start character offset in the source. */
+    start?: number;
+    /** End character offset in the source. */
+    end?: number;
+    /** Child nodes and properties. */
+    [key: string]: unknown;
+}
+/** Wrapper providing traversal context for a visited node. */
+export interface NodePath<T extends ASTNode = ASTNode> {
+    /** The AST node at this path. */
+    node: T;
+    /** The parent path, if any. */
+    parent: NodePath | undefined;
+    /** Replace this node with one or more new nodes. */
+    replaceWith(node: ASTNode): void;
+    /** Remove this node from the tree. */
+    remove(): void;
+}
+/** Visitor callbacks keyed by node type. */
+export interface TraverseVisitor {
+    [nodeType: string]: ((path: NodePath) => void) | {
+        enter?(path: NodePath): void;
+        exit?(path: NodePath): void;
+    };
+}
+/** Options passed to {@link CodeParser.parse}. */
+export interface ParseOptions {
+    /** Source code to parse. */
+    code: string;
+    /** File path hint for parser configuration (e.g. `.tsx`). */
+    filePath?: string;
+    /** Additional parser-specific options. */
+    [key: string]: unknown;
+}
+/** Options passed to {@link CodeParser.generate}. */
+export interface GenerateOptions {
+    /** Include source maps in the output. */
+    sourceMaps?: boolean;
+    /** Minify the generated code. */
+    minified?: boolean;
+    /** Additional generator-specific options. */
+    [key: string]: unknown;
+}
+/** Result returned from {@link CodeParser.generate}. */
+export interface GenerateResult {
+    /** Generated source code. */
+    code: string;
+    /** Source map, if requested. */
+    map?: string;
+}
+/**
+ * CodeParser contract interface.
+ *
+ * Implementations parse source code into ASTs, traverse/transform
+ * nodes, and generate code back from modified trees.
+ */
+export interface CodeParser {
+    /** Parse source code into an abstract syntax tree. */
+    parse(options: ParseOptions): Promise<ASTNode>;
+    /** Walk the AST calling visitor callbacks for matching node types. */
+    traverse(ast: ASTNode, visitor: TraverseVisitor): void;
+    /** Generate source code from an AST. */
+    generate(ast: ASTNode, options?: GenerateOptions): Promise<GenerateResult>;
+}
+//# sourceMappingURL=code-parser.d.ts.map

package/esm/src/extensions/interfaces/code-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/code-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gDAAgD;AAChD,MAAM,WAAW,OAAO;IACtB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IACnD,iCAAiC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,+BAA+B;IAC/B,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,oDAAoD;IACpD,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,sCAAsC;IACtC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,CAAC,QAAQ,EAAE,MAAM,GACb,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC,GAC1B;QACA,KAAK,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;KAC7B,CAAC;CACL;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACvD,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5E"}

package/esm/src/extensions/interfaces/code-parser.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for code parsing and AST manipulation.
+ *
+ * Default implementation: `@veryfront/ext-babel`
+ *
+ * @module extensions/interfaces/code-parser
+ */
+export {};

package/esm/src/extensions/interfaces/content-transformer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Contract interface for content transformation pipelines.
+ *
+ * Default implementation: `@veryfront/ext-mdx`
+ *
+ * @module extensions/interfaces/content-transformer
+ */
+/** Options passed to {@link ContentTransformer.transform}. */
+export interface ContentTransformOptions {
+    /** Raw source content (e.g. MDX, Markdown). */
+    source: string;
+    /** File path hint for the source content. */
+    filePath?: string;
+    /** Additional remark/rehype plugins or processor-specific settings. */
+    [key: string]: unknown;
+}
+/** Result returned from {@link ContentTransformer.transform}. */
+export interface ContentTransformResult {
+    /** Transformed output code. */
+    code: string;
+    /** Front-matter or metadata extracted from the source. */
+    frontmatter?: Record<string, unknown>;
+    /** Extracted table-of-contents headings. */
+    headings?: Array<{
+        depth: number;
+        text: string;
+        slug: string;
+    }>;
+}
+/**
+ * ContentTransformer contract interface.
+ *
+ * Implementations transform authoring formats (MDX, Markdown, etc.)
+ * into renderable code or HTML.
+ */
+export interface ContentTransformer {
+    /** Transform source content into its processed form. */
+    transform(options: ContentTransformOptions): Promise<ContentTransformResult>;
+}
+//# sourceMappingURL=content-transformer.d.ts.map

package/esm/src/extensions/interfaces/content-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-transformer.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/content-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC9E"}

package/esm/src/extensions/interfaces/content-transformer.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for content transformation pipelines.
+ *
+ * Default implementation: `@veryfront/ext-mdx`
+ *
+ * @module extensions/interfaces/content-transformer
+ */
+export {};

package/esm/src/extensions/interfaces/css-processor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Contract interface for CSS processing engines.
+ *
+ * Default implementation: `@veryfront/ext-tailwind`
+ *
+ * @module extensions/interfaces/css-processor
+ */
+/** Options passed to {@link CSSProcessor.process}. */
+export interface CSSProcessOptions {
+    /** Raw CSS or utility-class input. */
+    content: string;
+    /** Paths to source files used for scanning class usage. */
+    sources?: string[];
+    /** Enable minification of the output. */
+    minify?: boolean;
+    /** Extra implementation-specific options. */
+    [key: string]: unknown;
+}
+/** Result returned from {@link CSSProcessor.process}. */
+export interface CSSProcessResult {
+    /** Processed CSS output. */
+    css: string;
+    /** Source map, if generated. */
+    map?: string;
+}
+/**
+ * CSSProcessor contract interface.
+ *
+ * Implementations compile utility classes or raw CSS into optimized
+ * stylesheets ready for the browser.
+ */
+export interface CSSProcessor {
+    /** Process CSS input and return the compiled result. */
+    process(options: CSSProcessOptions): Promise<CSSProcessResult>;
+    /** Merge class names using the processor's conflict-resolution strategy. */
+    mergeClasses?(...classes: string[]): string;
+}
+//# sourceMappingURL=css-processor.d.ts.map

package/esm/src/extensions/interfaces/css-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-processor.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/css-processor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/D,4EAA4E;IAC5E,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;CAC7C"}

package/esm/src/extensions/interfaces/css-processor.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for CSS processing engines.
+ *
+ * Default implementation: `@veryfront/ext-tailwind`
+ *
+ * @module extensions/interfaces/css-processor
+ */
+export {};

package/esm/src/extensions/interfaces/database-client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Contract interface for database clients.
+ *
+ * Default implementation: `@veryfront/ext-postgres`
+ *
+ * @module extensions/interfaces/database-client
+ */
+/** Result returned from {@link DatabaseClient.query}. */
+export interface QueryResult<T = Record<string, unknown>> {
+    /** Array of rows returned by the query. */
+    rows: T[];
+    /** Number of rows affected by the statement. */
+    rowCount: number;
+}
+/**
+ * DatabaseClient contract interface.
+ *
+ * Implementations provide parameterized query execution against a
+ * relational or document database.
+ */
+export interface DatabaseClient {
+    /** Run a read query and return the matching rows. */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /** Execute a write statement and return the affected row count. */
+    execute(sql: string, params?: unknown[]): Promise<QueryResult>;
+    /** Open or initialize the database connection. */
+    connect(): Promise<void>;
+    /** Close the database connection and release resources. */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=database-client.d.ts.map

package/esm/src/extensions/interfaces/database-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-client.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/database-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,2CAA2C;IAC3C,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,mEAAmE;IACnE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,kDAAkD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,2DAA2D;IAC3D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/esm/src/extensions/interfaces/database-client.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for database clients.
+ *
+ * Default implementation: `@veryfront/ext-postgres`
+ *
+ * @module extensions/interfaces/database-client
+ */
+export {};

package/esm/src/extensions/interfaces/embedding-provider.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Contract interface for text embedding providers.
+ *
+ * Default implementation: `@veryfront/ext-embeddings`
+ *
+ * @module extensions/interfaces/embedding-provider
+ */
+/** Options passed to {@link EmbeddingProvider.embed}. */
+export interface EmbeddingOptions {
+    /** Model identifier (e.g. `"text-embedding-3-small"`). */
+    model: string;
+    /** Input texts to embed. */
+    input: string[];
+    /** Additional provider-specific options. */
+    [key: string]: unknown;
+}
+/** Result returned from {@link EmbeddingProvider.embed}. */
+export interface EmbeddingResult {
+    /** One embedding vector per input string. */
+    embeddings: number[][];
+    /** Token usage statistics. */
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * EmbeddingProvider contract interface.
+ *
+ * Implementations convert text inputs into dense vector embeddings
+ * for similarity search and retrieval-augmented generation.
+ */
+export interface EmbeddingProvider {
+    /** Generate embedding vectors for the given input texts. */
+    embed(options: EmbeddingOptions): Promise<EmbeddingResult>;
+}
+//# sourceMappingURL=embedding-provider.d.ts.map

package/esm/src/extensions/interfaces/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IACvB,8BAA8B;IAC9B,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D"}

package/esm/src/extensions/interfaces/embedding-provider.js

@@ -0,0 +1,8 @@
+/**
+ * Contract interface for text embedding providers.
+ *
+ * Default implementation: `@veryfront/ext-embeddings`
+ *
+ * @module extensions/interfaces/embedding-provider
+ */
+export {};