@elaraai/e3-api-server 0.0.2-beta.4 → 0.0.2-beta.41

package/dist/src/handlers/workspaces.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { StorageBackend } from '@elaraai/e3-core';
+/**
+ * List all workspaces in the repository.
+ */
+export declare function listWorkspaces(storage: StorageBackend, repoPath: string): Promise<Response>;
+/**
+ * Create a new workspace.
+ */
+export declare function createWorkspace(storage: StorageBackend, repoPath: string, name: string): Promise<Response>;
+/**
+ * Get workspace state.
+ */
+export declare function getWorkspace(storage: StorageBackend, repoPath: string, name: string): Promise<Response>;
+/**
+ * Get comprehensive workspace status.
+ */
+export declare function getWorkspaceStatus(storage: StorageBackend, repoPath: string, name: string): Promise<Response>;
+/**
+ * Delete a workspace.
+ */
+export declare function deleteWorkspace(storage: StorageBackend, repoPath: string, name: string): Promise<Response>;
+/**
+ * Deploy a package to a workspace.
+ */
+export declare function deployWorkspace(storage: StorageBackend, repoPath: string, workspace: string, packageRef: string): Promise<Response>;
+/**
+ * Export a workspace as a zip archive.
+ */
+export declare function exportWorkspace(storage: StorageBackend, repoPath: string, workspace: string): Promise<Response>;
+//# sourceMappingURL=workspaces.d.ts.map

package/dist/src/handlers/workspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../../src/handlers/workspaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CA2BnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC,CAUnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC,CAkDnB;AA8CD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC,CAOnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,CAAC,CAanB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAenB"}

package/dist/src/handlers/workspaces.js

@@ -0,0 +1,225 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { BlobType, NullType, some, none, variant } from '@elaraai/east';
+import { ArrayType } from '@elaraai/east';
+import { WorkspaceStateType, parsePackageRef } from '@elaraai/e3-types';
+import { workspaceList, workspaceCreate, workspaceRemove, workspaceGetState, workspaceDeploy, workspaceExport, workspaceStatus, packageGetLatestVersion, } from '@elaraai/e3-core';
+import { sendSuccess, sendError } from '../beast2.js';
+import { errorToVariant } from '../errors.js';
+import { WorkspaceInfoType, WorkspaceStatusResultType } from '../types.js';
+/**
+ * List all workspaces in the repository.
+ */
+export async function listWorkspaces(storage, repoPath) {
+    try {
+        const workspaces = await workspaceList(storage, repoPath);
+        const result = await Promise.all(workspaces.map(async (name) => {
+            const state = await workspaceGetState(storage, repoPath, name);
+            if (state) {
+                return {
+                    name,
+                    deployed: true,
+                    packageName: some(state.packageName),
+                    packageVersion: some(state.packageVersion),
+                };
+            }
+            else {
+                return {
+                    name,
+                    deployed: false,
+                    packageName: none,
+                    packageVersion: none,
+                };
+            }
+        }));
+        return sendSuccess(ArrayType(WorkspaceInfoType), result);
+    }
+    catch (err) {
+        return sendError(ArrayType(WorkspaceInfoType), errorToVariant(err));
+    }
+}
+/**
+ * Create a new workspace.
+ */
+export async function createWorkspace(storage, repoPath, name) {
+    try {
+        await workspaceCreate(storage, repoPath, name);
+        return sendSuccess(WorkspaceInfoType, {
+            name,
+            deployed: false,
+            packageName: none,
+            packageVersion: none,
+        });
+    }
+    catch (err) {
+        return sendError(WorkspaceInfoType, errorToVariant(err));
+    }
+}
+/**
+ * Get workspace state.
+ */
+export async function getWorkspace(storage, repoPath, name) {
+    try {
+        const state = await workspaceGetState(storage, repoPath, name);
+        if (!state) {
+            return sendError(WorkspaceStateType, errorToVariant(new Error(`Workspace '${name}' is not deployed`)));
+        }
+        return sendSuccess(WorkspaceStateType, state);
+    }
+    catch (err) {
+        return sendError(WorkspaceStateType, errorToVariant(err));
+    }
+}
+/**
+ * Get comprehensive workspace status.
+ */
+export async function getWorkspaceStatus(storage, repoPath, name) {
+    try {
+        const status = await workspaceStatus(storage, repoPath, name);
+        // Convert numbers to bigints for BEAST2 serialization
+        const result = {
+            workspace: status.workspace,
+            lock: status.lock ? some({
+                pid: BigInt(status.lock.pid ?? 0),
+                acquiredAt: status.lock.acquiredAt,
+                bootId: status.lock.bootId ? some(status.lock.bootId) : none,
+                command: status.lock.command ? some(status.lock.command) : none,
+            }) : none,
+            datasets: status.datasets.map(d => ({
+                path: d.path,
+                status: convertDatasetStatus(d.status),
+                hash: d.hash ? some(d.hash) : none,
+                isTaskOutput: d.isTaskOutput,
+                producedBy: d.producedBy ? some(d.producedBy) : none,
+            })),
+            tasks: status.tasks.map(t => ({
+                name: t.name,
+                hash: t.hash,
+                status: convertTaskStatus(t.status),
+                inputs: t.inputs,
+                output: t.output,
+                dependsOn: t.dependsOn,
+            })),
+            summary: {
+                datasets: {
+                    total: BigInt(status.summary.datasets.total),
+                    unset: BigInt(status.summary.datasets.unset),
+                    stale: BigInt(status.summary.datasets.stale),
+                    upToDate: BigInt(status.summary.datasets.upToDate),
+                },
+                tasks: {
+                    total: BigInt(status.summary.tasks.total),
+                    upToDate: BigInt(status.summary.tasks.upToDate),
+                    ready: BigInt(status.summary.tasks.ready),
+                    waiting: BigInt(status.summary.tasks.waiting),
+                    inProgress: BigInt(status.summary.tasks.inProgress),
+                    failed: BigInt(status.summary.tasks.failed),
+                    error: BigInt(status.summary.tasks.error),
+                    staleRunning: BigInt(status.summary.tasks.staleRunning),
+                },
+            },
+        };
+        return sendSuccess(WorkspaceStatusResultType, result);
+    }
+    catch (err) {
+        return sendError(WorkspaceStatusResultType, errorToVariant(err));
+    }
+}
+// Helper to convert dataset status to variant format
+function convertDatasetStatus(status) {
+    switch (status.type) {
+        case 'unset': return variant('unset', null);
+        case 'stale': return variant('stale', null);
+        case 'up-to-date': return variant('up-to-date', null);
+        default: return variant('unset', null);
+    }
+}
+// Helper to convert task status to variant format
+function convertTaskStatus(status) {
+    switch (status.type) {
+        case 'up-to-date':
+            return variant('up-to-date', { cached: status.cached });
+        case 'ready':
+            return variant('ready', null);
+        case 'waiting':
+            return variant('waiting', { reason: status.reason });
+        case 'in-progress':
+            return variant('in-progress', {
+                pid: status.pid != null ? some(BigInt(status.pid)) : none,
+                startedAt: status.startedAt ? some(status.startedAt) : none,
+            });
+        case 'failed':
+            return variant('failed', {
+                exitCode: BigInt(status.exitCode),
+                completedAt: status.completedAt ? some(status.completedAt) : none,
+            });
+        case 'error':
+            return variant('error', {
+                message: status.message,
+                completedAt: status.completedAt ? some(status.completedAt) : none,
+            });
+        case 'stale-running':
+            return variant('stale-running', {
+                pid: status.pid != null ? some(BigInt(status.pid)) : none,
+                startedAt: status.startedAt ? some(status.startedAt) : none,
+            });
+        default:
+            return variant('ready', null);
+    }
+}
+/**
+ * Delete a workspace.
+ */
+export async function deleteWorkspace(storage, repoPath, name) {
+    try {
+        await workspaceRemove(storage, repoPath, name);
+        return sendSuccess(NullType, null);
+    }
+    catch (err) {
+        return sendError(NullType, errorToVariant(err));
+    }
+}
+/**
+ * Deploy a package to a workspace.
+ */
+export async function deployWorkspace(storage, repoPath, workspace, packageRef) {
+    try {
+        const { name: pkgName, version: maybeVersion } = parsePackageRef(packageRef);
+        const pkgVersion = maybeVersion ?? await packageGetLatestVersion(storage, repoPath, pkgName);
+        if (!pkgVersion) {
+            return sendError(NullType, errorToVariant(new Error(`Package not found: ${pkgName}`)));
+        }
+        await workspaceDeploy(storage, repoPath, workspace, pkgName, pkgVersion);
+        return sendSuccess(NullType, null);
+    }
+    catch (err) {
+        return sendError(NullType, errorToVariant(err));
+    }
+}
+/**
+ * Export a workspace as a zip archive.
+ */
+export async function exportWorkspace(storage, repoPath, workspace) {
+    try {
+        // Export to temp file
+        const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'e3-ws-export-'));
+        const tempPath = path.join(tempDir, 'workspace.zip');
+        try {
+            await workspaceExport(storage, repoPath, workspace, tempPath);
+            const archive = await fs.readFile(tempPath);
+            return sendSuccess(BlobType, new Uint8Array(archive));
+        }
+        finally {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+    }
+    catch (err) {
+        return sendError(BlobType, errorToVariant(err));
+    }
+}
+//# sourceMappingURL=workspaces.js.map

package/dist/src/handlers/workspaces.js.map

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

package/dist/src/index.d.ts

@@ -10,4 +10,7 @@
  */
 export { createServer, type ServerConfig, type Server } from './server.js';
 export { ApiTypes } from './types.js';
+export * from './handlers/index.js';
+export { createAuthMiddleware, type AuthConfig } from './middleware/auth.js';
+export { sendSuccess, sendError, sendSuccessWithStatus, decodeBeast2, decodeBody } from './beast2.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,oBAAoB,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,qBAAqB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/index.js

@@ -10,4 +10,10 @@
  */
 export { createServer } from './server.js';
 export { ApiTypes } from './types.js';
+// Export handlers for Lambda reuse
+export * from './handlers/index.js';
+// Export auth middleware
+export { createAuthMiddleware } from './middleware/auth.js';
+// Export BEAST2 helpers for custom integrations
+export { sendSuccess, sendError, sendSuccessWithStatus, decodeBeast2, decodeBody } from './beast2.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAkC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAkC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,mCAAmC;AACnC,cAAc,qBAAqB,CAAC;AAEpC,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAmB,MAAM,sBAAsB,CAAC;AAE7E,gDAAgD;AAChD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,qBAAqB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/middleware/auth.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { MiddlewareHandler } from 'hono';
+import type { KeyPair } from '../auth/keys.js';
+/**
+ * JWT authentication configuration.
+ *
+ * Supports three modes:
+ * 1. publicKeyPath - Load key from PEM file
+ * 2. jwksUrl - Fetch keys from JWKS endpoint (for Cognito/external providers)
+ * 3. _internalKeys - Use provided KeyPair directly (for built-in OIDC provider)
+ */
+export interface AuthConfig {
+    /** Path to public key file (PEM format) for RS256 signature verification */
+    publicKeyPath?: string;
+    /** URL to JWKS endpoint for fetching public keys */
+    jwksUrl?: string;
+    /** Expected issuer claim (iss) */
+    issuer: string;
+    /** Expected audience claim (aud) */
+    audience: string;
+    /** Internal: direct KeyPair for built-in OIDC provider (avoids self-fetch) */
+    _internalKeys?: KeyPair;
+}
+/**
+ * Identity information extracted from JWT and set on context.
+ */
+export interface Identity {
+    /** Subject - typically user ID */
+    sub: string;
+    /** User email (if present in token) */
+    email?: string;
+    /** User roles (if present in token) */
+    roles: string[];
+}
+/**
+ * Create JWT authentication middleware.
+ *
+ * The middleware:
+ * 1. Extracts Bearer token from Authorization header
+ * 2. Verifies RS256 signature using the configured public key
+ * 3. Validates exp, nbf, iss, and aud claims
+ * 4. Sets identity on Hono context (accessible via c.get('identity'))
+ *
+ * @param config - Authentication configuration
+ * @returns Hono middleware handler
+ */
+export declare function createAuthMiddleware(config: AuthConfig): Promise<MiddlewareHandler>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/middleware/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAwBD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAgCD;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+FzF"}

package/dist/src/middleware/auth.js

@@ -0,0 +1,158 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import * as fs from 'node:fs/promises';
+import * as crypto from 'node:crypto';
+// Cache JWKS for 5 minutes
+const JWKS_CACHE_TTL = 5 * 60 * 1000;
+/**
+ * Create JWT authentication middleware.
+ *
+ * The middleware:
+ * 1. Extracts Bearer token from Authorization header
+ * 2. Verifies RS256 signature using the configured public key
+ * 3. Validates exp, nbf, iss, and aud claims
+ * 4. Sets identity on Hono context (accessible via c.get('identity'))
+ *
+ * @param config - Authentication configuration
+ * @returns Hono middleware handler
+ */
+export async function createAuthMiddleware(config) {
+    // Determine key source
+    let getPublicKey;
+    if (config._internalKeys) {
+        // Use provided KeyPair directly (built-in OIDC provider)
+        const keys = config._internalKeys;
+        getPublicKey = () => Promise.resolve(keys.publicKey);
+    }
+    else if (config.publicKeyPath) {
+        // Load public key from file at startup
+        const publicKeyPem = await fs.readFile(config.publicKeyPath, 'utf8');
+        const publicKey = crypto.createPublicKey(publicKeyPem);
+        getPublicKey = () => Promise.resolve(publicKey);
+    }
+    else if (config.jwksUrl) {
+        // Fetch keys from JWKS endpoint
+        let cache = null;
+        getPublicKey = async (kid) => {
+            // Check cache
+            if (cache && Date.now() - cache.fetchedAt < JWKS_CACHE_TTL) {
+                if (kid && cache.keys.has(kid)) {
+                    return cache.keys.get(kid);
+                }
+                // If no kid specified, return first key
+                if (!kid && cache.keys.size > 0) {
+                    return cache.keys.values().next().value;
+                }
+            }
+            // Fetch JWKS
+            const response = await fetch(config.jwksUrl);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch JWKS: ${response.status}`);
+            }
+            const jwks = await response.json();
+            // Parse keys
+            const keys = new Map();
+            for (const key of jwks.keys) {
+                if (key.kty === 'RSA' && key.alg === 'RS256') {
+                    const publicKey = crypto.createPublicKey({
+                        key: {
+                            kty: key.kty,
+                            n: key.n,
+                            e: key.e,
+                        },
+                        format: 'jwk',
+                    });
+                    keys.set(key.kid, publicKey);
+                }
+            }
+            cache = { keys, fetchedAt: Date.now() };
+            if (kid && keys.has(kid)) {
+                return keys.get(kid);
+            }
+            if (!kid && keys.size > 0) {
+                return keys.values().next().value;
+            }
+            throw new Error(`Key not found: ${kid ?? 'no keys available'}`);
+        };
+    }
+    else {
+        throw new Error('AuthConfig must specify publicKeyPath, jwksUrl, or _internalKeys');
+    }
+    return async (c, next) => {
+        const authHeader = c.req.header('authorization');
+        if (!authHeader?.startsWith('Bearer ')) {
+            return new Response('Unauthorized: Missing Bearer token', { status: 401 });
+        }
+        const token = authHeader.slice(7);
+        try {
+            // Extract kid from token header
+            const headerB64 = token.split('.')[0];
+            const header = JSON.parse(Buffer.from(headerB64, 'base64url').toString());
+            const publicKey = await getPublicKey(header.kid);
+            const payload = verifyJwt(token, publicKey, config.issuer, config.audience);
+            // Set identity on context for handlers
+            const identity = {
+                sub: payload.sub ?? 'unknown',
+                email: payload.email,
+                roles: payload.roles ?? [],
+            };
+            c.set('identity', identity);
+            await next();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Invalid token';
+            return new Response(`Unauthorized: ${message}`, { status: 401 });
+        }
+    };
+}
+/**
+ * Verify JWT token and return payload.
+ *
+ * @param token - Raw JWT string
+ * @param publicKey - RSA public key for signature verification
+ * @param expectedIssuer - Expected iss claim
+ * @param expectedAudience - Expected aud claim
+ * @returns Decoded JWT payload
+ * @throws Error if verification fails
+ */
+function verifyJwt(token, publicKey, expectedIssuer, expectedAudience) {
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        throw new Error('Malformed JWT: expected 3 parts');
+    }
+    const [headerB64, payloadB64, signatureB64] = parts;
+    // Decode header and verify algorithm
+    const header = JSON.parse(Buffer.from(headerB64, 'base64url').toString());
+    if (header.alg !== 'RS256') {
+        throw new Error(`Unsupported algorithm: ${header.alg}`);
+    }
+    // Verify signature
+    const verify = crypto.createVerify('RSA-SHA256');
+    verify.update(`${headerB64}.${payloadB64}`);
+    const signature = Buffer.from(signatureB64, 'base64url');
+    if (!verify.verify(publicKey, signature)) {
+        throw new Error('Invalid signature');
+    }
+    // Decode payload
+    const payload = JSON.parse(Buffer.from(payloadB64, 'base64url').toString());
+    // Verify time-based claims
+    const now = Math.floor(Date.now() / 1000);
+    if (payload.exp !== undefined && payload.exp < now) {
+        throw new Error('Token expired');
+    }
+    if (payload.nbf !== undefined && payload.nbf > now) {
+        throw new Error('Token not yet valid');
+    }
+    // Verify issuer
+    if (payload.iss !== expectedIssuer) {
+        throw new Error(`Invalid issuer: expected ${expectedIssuer}, got ${payload.iss}`);
+    }
+    // Verify audience
+    if (payload.aud !== expectedAudience) {
+        throw new Error(`Invalid audience: expected ${expectedAudience}, got ${payload.aud}`);
+    }
+    return payload;
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/middleware/auth.js.map

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

package/dist/src/orchestrator-manager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { LocalOrchestrator, type ExecutionHandle, type ExecutionStateStore } from '@elaraai/e3-core';
+/**
+ * Get the orchestrator for a repository.
+ */
+export declare function getOrchestrator(repoPath: string): LocalOrchestrator;
+/**
+ * Get the state store for a repository.
+ */
+export declare function getStateStore(repoPath: string): ExecutionStateStore;
+/**
+ * Set the active execution for a workspace.
+ * Replaces any previous execution.
+ */
+export declare function setActiveExecution(repoPath: string, workspace: string, handle: ExecutionHandle): void;
+/**
+ * Get the active execution for a workspace.
+ */
+export declare function getActiveExecution(repoPath: string, workspace: string): ExecutionHandle | null;
+/**
+ * Clear the active execution for a workspace.
+ */
+export declare function clearActiveExecution(repoPath: string, workspace: string): void;
+/**
+ * Check if there's an active (running) execution for a workspace.
+ */
+export declare function hasActiveExecution(repoPath: string, workspace: string): boolean;
+/**
+ * Get the start time for an execution (for duration calculation).
+ */
+export declare function getExecutionStartTime(repoPath: string, workspace: string, executionId: string): number | null;
+/**
+ * Get the latest execution for a workspace (may not be active/running).
+ * Useful for polling completed executions.
+ */
+export declare function getLatestExecution(repoPath: string, workspace: string): Promise<ExecutionHandle | null>;
+/**
+ * Clear all in-memory state (for testing).
+ * Note: This does not clear persisted file-based state.
+ */
+export declare function clearAll(): void;
+//# sourceMappingURL=orchestrator-manager.d.ts.map

package/dist/src/orchestrator-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-manager.d.ts","sourceRoot":"","sources":["../../src/orchestrator-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EACL,iBAAiB,EAEjB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAgE1B;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAEnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAEnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAOrG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAG9F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAQ9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7G;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAe7G;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAK/B"}