veryfront 0.1.215 → 0.1.216

package/esm/src/extensions/discovery.js

@@ -0,0 +1,179 @@
+/**
+ * Multi-source extension discovery.
+ *
+ * Discovers extensions from four sources with priority:
+ *   config > package > project > local-file
+ *
+ * @module extensions/discovery
+ */
+import * as dntShim from "../../_dnt.shims.js";
+import { join } from "../../deps/jsr.io/@std/path/1.1.4/mod.js";
+function isCapability(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const cap = value;
+    return typeof cap.type === "string" && cap.type.length > 0;
+}
+/**
+ * Parse veryfront extension metadata from a package.json-like object.
+ *
+ * Returns `PackageMetadata` when the package declares
+ * `veryfront.extension: true`, otherwise `undefined`. Malformed capability
+ * entries are filtered out; the caller receives only valid shapes.
+ */
+export function parsePackageMetadata(pkg) {
+    const vf = pkg.veryfront;
+    if (vf === null || vf === undefined || typeof vf !== "object" ||
+        Array.isArray(vf)) {
+        return undefined;
+    }
+    const meta = vf;
+    if (meta.extension !== true) {
+        return undefined;
+    }
+    const capabilities = Array.isArray(meta.capabilities)
+        ? meta.capabilities.filter(isCapability)
+        : [];
+    return { isExtension: true, capabilities };
+}
+/**
+ * Merge extensions from all four sources in priority order.
+ *
+ * Priority (highest first): config > package > project > local-file.
+ * Duplicates are resolved by keeping the highest-priority entry.
+ * Disable directives (`{ name, enabled: false }`) remove matching
+ * extensions regardless of source.
+ */
+export function mergeExtensions(config, packages, project, local, disableDirectives) {
+    const disabledNames = new Set((disableDirectives ?? []).map((d) => d.name));
+    const seen = new Map();
+    // Process sources in priority order -- first write wins.
+    const ordered = [
+        ...config,
+        ...packages,
+        ...project,
+        ...local,
+    ];
+    for (const resolved of ordered) {
+        const name = resolved.extension.name;
+        if (disabledNames.has(name))
+            continue;
+        if (!seen.has(name)) {
+            seen.set(name, resolved);
+        }
+    }
+    return [...seen.values()];
+}
+// ---------------------------------------------------------------------------
+// Filesystem discovery helpers
+// ---------------------------------------------------------------------------
+async function readDir(path) {
+    try {
+        const entries = [];
+        for await (const entry of dntShim.Deno.readDir(path)) {
+            entries.push(entry);
+        }
+        return entries;
+    }
+    catch (err) {
+        if (err instanceof dntShim.Deno.errors.NotFound)
+            return [];
+        throw err;
+    }
+}
+async function fileExists(path) {
+    try {
+        await dntShim.Deno.stat(path);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof dntShim.Deno.errors.NotFound)
+            return false;
+        throw err;
+    }
+}
+/**
+ * Scan `node_modules` (including `@scoped` packages) for packages
+ * that declare veryfront extension metadata in their `package.json`.
+ */
+export async function discoverPackageExtensions(baseDir) {
+    const nmDir = join(baseDir, "node_modules");
+    const results = [];
+    const entries = await readDir(nmDir);
+    for (const entry of entries) {
+        // Accept symlinks so pnpm-style node_modules layouts are discovered.
+        if (!entry.isDirectory && !entry.isSymlink)
+            continue;
+        if (entry.name.startsWith("@")) {
+            // Scoped packages -- iterate one level deeper.
+            const scopeDir = join(nmDir, entry.name);
+            const scopeEntries = await readDir(scopeDir);
+            for (const scopeEntry of scopeEntries) {
+                if (!scopeEntry.isDirectory && !scopeEntry.isSymlink)
+                    continue;
+                const pkgName = `${entry.name}/${scopeEntry.name}`;
+                const meta = await tryReadPackageMeta(join(scopeDir, scopeEntry.name));
+                if (meta)
+                    results.push({ packageName: pkgName, metadata: meta });
+            }
+        }
+        else {
+            const meta = await tryReadPackageMeta(join(nmDir, entry.name));
+            if (meta)
+                results.push({ packageName: entry.name, metadata: meta });
+        }
+    }
+    return results;
+}
+async function tryReadPackageMeta(pkgDir) {
+    let raw;
+    try {
+        raw = await dntShim.Deno.readTextFile(join(pkgDir, "package.json"));
+    }
+    catch (err) {
+        if (err instanceof dntShim.Deno.errors.NotFound)
+            return undefined;
+        throw err;
+    }
+    try {
+        const pkg = JSON.parse(raw);
+        return parsePackageMetadata(pkg);
+    }
+    catch {
+        // Malformed JSON -- treat as non-extension package.
+        return undefined;
+    }
+}
+/**
+ * Discover project extensions living under `extensions/` in the project root.
+ *
+ * Looks for `extensions/<name>/src/index.ts` and `extensions/<name>/index.ts`.
+ */
+export async function discoverProjectExtensions(baseDir) {
+    const extDir = join(baseDir, "extensions");
+    const entries = await readDir(extDir);
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory)
+            continue;
+        const srcIndex = join(extDir, entry.name, "src", "index.ts");
+        const rootIndex = join(extDir, entry.name, "index.ts");
+        if (await fileExists(srcIndex)) {
+            results.push(srcIndex);
+        }
+        else if (await fileExists(rootIndex)) {
+            results.push(rootIndex);
+        }
+    }
+    return results;
+}
+/**
+ * Find `*.extension.ts` files in the project root.
+ */
+export async function discoverLocalExtensions(baseDir) {
+    const entries = await readDir(baseDir);
+    return entries
+        .filter((e) => !e.isDirectory && e.name.endsWith(".extension.ts"))
+        .map((e) => join(baseDir, e.name));
+}

package/esm/src/extensions/errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Extension system error definitions.
+ *
+ * @module extensions/errors
+ */
+export declare const MISSING_EXTENSION_ERROR: import("../errors/types.js").RegisteredError;
+export declare const EXTENSION_VALIDATION_ERROR: import("../errors/types.js").RegisteredError;
+export declare const CIRCULAR_DEPENDENCY_ERROR: import("../errors/types.js").RegisteredError;
+export declare const EXTENSION_CONFLICT_ERROR: import("../errors/types.js").RegisteredError;
+//# sourceMappingURL=errors.d.ts.map

package/esm/src/extensions/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,uBAAuB,8CAMlC,CAAC;AAEH,eAAO,MAAM,0BAA0B,8CAMrC,CAAC;AAEH,eAAO,MAAM,yBAAyB,8CAMpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,8CAMnC,CAAC"}

package/esm/src/extensions/errors.js

@@ -0,0 +1,34 @@
+/**
+ * Extension system error definitions.
+ *
+ * @module extensions/errors
+ */
+import { defineError } from "../errors/index.js";
+export const MISSING_EXTENSION_ERROR = defineError({
+    slug: "missing-extension",
+    category: "RUNTIME",
+    status: 500,
+    title: "Required extension not found",
+    suggestion: "Install the missing extension package and add it to your configuration",
+});
+export const EXTENSION_VALIDATION_ERROR = defineError({
+    slug: "extension-validation",
+    category: "CONFIG",
+    status: 422,
+    title: "Extension validation failed",
+    suggestion: "Check that the extension exports a valid name, version, and capabilities array",
+});
+export const CIRCULAR_DEPENDENCY_ERROR = defineError({
+    slug: "extension-circular-dependency",
+    category: "CONFIG",
+    status: 422,
+    title: "Circular dependency detected between extensions",
+    suggestion: "Review the 'extends' fields in your extensions to break the cycle",
+});
+export const EXTENSION_CONFLICT_ERROR = defineError({
+    slug: "extension-conflict",
+    category: "CONFIG",
+    status: 409,
+    title: "Conflicting extensions detected",
+    suggestion: "Remove or disable one of the conflicting extensions in your configuration",
+});

package/esm/src/extensions/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Public extension API surface.
+ *
+ * Types used when authoring extensions (the scaffold template generated by
+ * `veryfront extension init` imports from this module), plus the runtime
+ * helpers consumers need to load, validate, and orchestrate extensions.
+ *
+ * @module extensions
+ */
+import "../../_dnt.polyfills.js";
+export type { Capability, Extension, ExtensionConfigEntry, ExtensionContext, ExtensionFactory, ExtensionLogger, ExtensionSource, ResolvedExtension, } from "./types.js";
+export { resolve, tryResolve } from "./contracts.js";
+export type { PackageMetadata } from "./discovery.js";
+export { discoverLocalExtensions, discoverPackageExtensions, discoverProjectExtensions, mergeExtensions, parsePackageMetadata, } from "./discovery.js";
+export { ExtensionLoader } from "./loader.js";
+export type { ConflictInfo } from "./validation.js";
+export { detectConflicts, validateExtension } from "./validation.js";
+export { auditCapabilities, formatCapabilities, mapToDenoPermissions } from "./capabilities.js";
+export { getRecommendation } from "./recommendations.js";
+export { CIRCULAR_DEPENDENCY_ERROR, EXTENSION_CONFLICT_ERROR, EXTENSION_VALIDATION_ERROR, MISSING_EXTENSION_ERROR, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,yBAAyB,CAAC;AAEjC,YAAY,EACV,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGrD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/esm/src/extensions/index.js

@@ -0,0 +1,25 @@
+/**
+ * Public extension API surface.
+ *
+ * Types used when authoring extensions (the scaffold template generated by
+ * `veryfront extension init` imports from this module), plus the runtime
+ * helpers consumers need to load, validate, and orchestrate extensions.
+ *
+ * @module extensions
+ */
+// Core types
+import "../../_dnt.polyfills.js";
+// Contract registry — resolve/tryResolve are the consumer-facing API.
+// register()/reset() are internal primitives (used by ExtensionLoader and
+// tests) and are intentionally not exported here.
+export { resolve, tryResolve } from "./contracts.js";
+export { discoverLocalExtensions, discoverPackageExtensions, discoverProjectExtensions, mergeExtensions, parsePackageMetadata, } from "./discovery.js";
+// Loader
+export { ExtensionLoader } from "./loader.js";
+export { detectConflicts, validateExtension } from "./validation.js";
+// Capabilities
+export { auditCapabilities, formatCapabilities, mapToDenoPermissions } from "./capabilities.js";
+// Recommendations
+export { getRecommendation } from "./recommendations.js";
+// Errors
+export { CIRCULAR_DEPENDENCY_ERROR, EXTENSION_CONFLICT_ERROR, EXTENSION_VALIDATION_ERROR, MISSING_EXTENSION_ERROR, } from "./errors.js";

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":"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"}

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 {};