@elaraai/e3-api-server 0.0.2-beta.8 → 1.0.0

package/LICENSE.md

@@ -34,6 +34,10 @@ On the Change Date (four years after each release), the Licensed Work will be ma
 
 THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. THE LICENSOR DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 
+### Package-Specific Licenses
+
+Individual packages within this repository may have different licensing terms. See the LICENSE.md file in each package directory for details.
+
 ## Commercial Licensing
 
 To obtain a commercial license for Production Use, contact:

package/README.md

@@ -12,88 +12,183 @@ npm install @elaraai/e3-api-server
 
 REST API server exposing e3-core operations over HTTP. Uses BEAST2 binary serialization for efficient request/response encoding.
 
+Supports two modes:
+- **Single-repo mode**: Serve one repository, accessed via `/repos/default`
+- **Multi-repo mode**: Serve multiple repositories from a directory, accessed via `/repos/:name`
+
 ## CLI Usage
 
 ```bash
-# Start server on default port 3000
-e3-api-server /path/to/.e3
+# Single repository mode
+e3-api-server --repo /path/to/repo
+e3-api-server --repo /path/to/repo --port 8080 --cors
+
+# Multi-repository mode (serves repos from subdirectories)
+e3-api-server --repos /path/to/repos-dir
+
+# With OIDC authentication
+e3-api-server --repo /path/to/repo --oidc
 
 # Custom port and host
-e3-api-server /path/to/.e3 --port 8080 --host 0.0.0.0
+e3-api-server --repo /path/to/repo --port 8080 --host 0.0.0.0
 ```
 
+### CLI Options
+
+| Option | Description |
+|--------|-------------|
+| `--repo <path>` | Single repository mode - serve one repo at `/repos/default` |
+| `--repos <dir>` | Multi-repo mode - serve repos from subdirectories |
+| `-p, --port <port>` | HTTP port (default: 3000) |
+| `-H, --host <host>` | Bind address (default: localhost) |
+| `--cors` | Enable CORS for cross-origin requests |
+| `--oidc` | Enable built-in OIDC authentication provider |
+| `--token-expiry <duration>` | Access token expiry, e.g., "5s", "15m", "1h" (default: 1h) |
+| `--refresh-token-expiry <duration>` | Refresh token expiry, e.g., "7d", "90d" (default: 90d) |
+
 ## Programmatic Usage
 
+### Single Repository (Embedded Server)
+
+For embedding in applications like VS Code extensions:
+
 ```typescript
 import { createServer } from '@elaraai/e3-api-server';
 
-const server = createServer({
-  repo: '/path/to/.e3',
+// createServer is async
+const server = await createServer({
+  singleRepoPath: '/path/to/repo',
   port: 3000,
   host: 'localhost',
+  cors: true,  // Enable for webview/cross-origin access
 });
 
 await server.start();
-console.log(`Server listening on port ${server.port}`);
+console.log(`Server listening on http://localhost:${server.port}`);
+console.log('Access repository via: /repos/default');
 
 // Graceful shutdown
 await server.stop();
 ```
 
+### Multi-Repository Mode
+
+For serving multiple repositories:
+
+```typescript
+import { createServer } from '@elaraai/e3-api-server';
+
+const server = await createServer({
+  reposDir: '/path/to/repos',  // Each subdirectory is a repo
+  port: 3000,
+  host: 'localhost',
+});
+
+await server.start();
+// Repos accessible at /repos/repo1, /repos/repo2, etc.
+```
+
+### With Authentication
+
+```typescript
+import { createServer } from '@elaraai/e3-api-server';
+
+const server = await createServer({
+  singleRepoPath: '/path/to/repo',
+  port: 3000,
+  oidc: {
+    baseUrl: 'http://localhost:3000',
+    tokenExpiry: '1h',
+    refreshTokenExpiry: '90d',
+  },
+});
+
+await server.start();
+// OIDC endpoints available at /.well-known/*, /oauth2/*, /device
+```
+
+### ServerConfig Options
+
+```typescript
+interface ServerConfig {
+  // Repository mode (specify exactly one)
+  singleRepoPath?: string;  // Single repo at /repos/default
+  reposDir?: string;        // Multi-repo from subdirectories
+
+  // Server options
+  port?: number;            // Default: 3000
+  host?: string;            // Default: 'localhost'
+  cors?: boolean;           // Enable CORS (default: false)
+
+  // Authentication (optional)
+  auth?: AuthConfig;        // External JWT validation
+  oidc?: OidcConfig;        // Built-in OIDC provider
+}
+```
+
 ## API Endpoints
 
+All endpoints are prefixed with `/api/repos/:repo` where `:repo` is:
+- `default` in single-repo mode
+- The repository name in multi-repo mode
+
 ### Repository
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/status` | Repository status (path, object/package/workspace counts) |
-| POST | `/api/gc` | Garbage collection |
+| GET | `/api/repos` | List available repositories (multi-repo mode) |
+| PUT | `/api/repos/:repo` | Create repository (multi-repo mode) |
+| DELETE | `/api/repos/:repo` | Delete repository (multi-repo mode, async) |
+| GET | `/api/repos/:repo/status` | Repository status (counts) |
+| POST | `/api/repos/:repo/gc` | Start garbage collection (async) |
+| GET | `/api/repos/:repo/gc/:id` | Get GC status |
 
 ### Packages
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/packages` | List all packages |
-| GET | `/api/packages/:name/:version` | Get package details |
-| POST | `/api/packages` | Import package (zip body) |
-| GET | `/api/packages/:name/:version/export` | Export package as zip |
-| DELETE | `/api/packages/:name/:version` | Remove package |
+| GET | `/api/repos/:repo/packages` | List all packages |
+| GET | `/api/repos/:repo/packages/:name/:version` | Get package details |
+| POST | `/api/repos/:repo/packages` | Import package (zip body) |
+| GET | `/api/repos/:repo/packages/:name/:version/export` | Export package as zip |
+| DELETE | `/api/repos/:repo/packages/:name/:version` | Remove package |
 
 ### Workspaces
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/workspaces` | List all workspaces |
-| POST | `/api/workspaces` | Create workspace |
-| GET | `/api/workspaces/:ws` | Get workspace info |
-| GET | `/api/workspaces/:ws/status` | Get workspace status (datasets, tasks, summary) |
-| POST | `/api/workspaces/:ws/deploy` | Deploy package to workspace |
-| DELETE | `/api/workspaces/:ws` | Remove workspace |
+| GET | `/api/repos/:repo/workspaces` | List all workspaces |
+| POST | `/api/repos/:repo/workspaces` | Create workspace |
+| GET | `/api/repos/:repo/workspaces/:ws` | Get workspace info |
+| GET | `/api/repos/:repo/workspaces/:ws/status` | Get workspace status (datasets, tasks, summary) |
+| POST | `/api/repos/:repo/workspaces/:ws/deploy` | Deploy package to workspace |
+| DELETE | `/api/repos/:repo/workspaces/:ws` | Remove workspace |
+| GET | `/api/repos/:repo/workspaces/:ws/export` | Export workspace as package zip |
 
 ### Datasets
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/workspaces/:ws/list` | List root dataset fields |
-| GET | `/api/workspaces/:ws/list/*path` | List nested dataset fields |
-| GET | `/api/workspaces/:ws/get/*path` | Get dataset value (BEAST2) |
-| PUT | `/api/workspaces/:ws/set/*path` | Set dataset value (BEAST2) |
+| GET | `/api/repos/:repo/workspaces/:ws/datasets` | List root datasets |
+| GET | `/api/repos/:repo/workspaces/:ws/datasets/*path` | Get dataset value (BEAST2) |
+| PUT | `/api/repos/:repo/workspaces/:ws/datasets/*path` | Set dataset value (BEAST2) |
 
 ### Tasks
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/workspaces/:ws/tasks` | List tasks |
-| GET | `/api/workspaces/:ws/tasks/:task` | Get task details |
+| GET | `/api/repos/:repo/workspaces/:ws/tasks` | List tasks |
+| GET | `/api/repos/:repo/workspaces/:ws/tasks/:task` | Get task details |
 
 ### Execution
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| POST | `/api/workspaces/:ws/start` | Start dataflow (non-blocking) |
-| POST | `/api/workspaces/:ws/execute` | Execute dataflow (blocking, returns result) |
-| GET | `/api/workspaces/:ws/graph` | Get dependency graph |
-| GET | `/api/workspaces/:ws/logs/:task` | Read task logs |
+| POST | `/api/repos/:repo/workspaces/:ws/dataflow/start` | Start dataflow (async, returns immediately) |
+| POST | `/api/repos/:repo/workspaces/:ws/dataflow/execute` | Execute dataflow (blocking, returns result) |
+| GET | `/api/repos/:repo/workspaces/:ws/dataflow/graph` | Get dependency graph |
+| GET | `/api/repos/:repo/workspaces/:ws/dataflow/logs/:task` | Read task logs |
+| GET | `/api/repos/:repo/workspaces/:ws/dataflow/state` | Get current execution state |
 
 ## Request/Response Format
 
@@ -113,38 +208,90 @@ Error variants include:
 - `task_not_found` - Task doesn't exist
 - `internal` - Internal server error
 
+## Using with e3-api-client
+
+```typescript
+import { workspaceList, workspaceStatus, datasetGet } from '@elaraai/e3-api-client';
+
+const baseUrl = 'http://localhost:3000';
+const repo = 'default';  // In single-repo mode
+const options = { token: '' };  // Empty token if no auth configured
+
+// List workspaces
+const workspaces = await workspaceList(baseUrl, repo, options);
+
+// Get workspace status
+const status = await workspaceStatus(baseUrl, repo, 'my-workspace', options);
+
+// Get dataset value
+const path = [{ value: 'inputs' }, { value: 'data' }];
+const data = await datasetGet(baseUrl, repo, 'my-workspace', path, options);
+```
+
+## Claude Code plugin
+
+The East ecosystem also ships a [Claude Code](https://claude.com/claude-code) plugin — East language skills, example search, and preemptive diagnostics for East code — installed separately from the `elaraai` marketplace:
+
+```text
+# Inside Claude Code
+/plugin marketplace add elaraai/east-workspace
+/plugin install east@elaraai
+```
+
+```bash
+# From a terminal
+claude plugin marketplace add elaraai/east-workspace
+claude plugin install east@elaraai
+```
+
 ## License
 
 BSL 1.1. See [LICENSE.md](./LICENSE.md).
 
 ### Ecosystem
 
-- **[East Node](https://github.com/elaraai/east-node)**: Node.js platform functions for I/O, databases, and system operations. Connect East programs to filesystems, SQL/NoSQL databases, cloud storage, and network services.
-  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Filesystem, console, HTTP fetch, crypto, random distributions, timestamps
-  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, S3, FTP, SFTP
+- **[East](https://github.com/elaraai/east-workspace/tree/main/libs/east)**: Statically typed, expression-based language with serializable IR. Run portable logic across TypeScript, Python, C, and other runtimes.
+  - [@elaraai/east](https://www.npmjs.com/package/@elaraai/east): Core language SDK with type system, expressions, and reference JS compiler
+
+- **[East Node](https://github.com/elaraai/east-workspace/tree/main/libs/east-node)**: Node.js platform functions for I/O, databases, and system operations.
+  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
   - [@elaraai/east-node-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): CLI for running East IR programs in Node.js
 
-- **[East Python](https://github.com/elaraai/east-py)**: Python runtime and platform functions for data science and machine learning. Execute East programs with access to optimization solvers, gradient boosting, neural networks, and model explainability.
-  - [@elaraai/east-py-datascience](https://www.npmjs.com/package/@elaraai/east-py-datascience): TypeScript types for optimization, gradient boosting, neural networks, explainability
+- **[East C](https://github.com/elaraai/east-workspace/tree/main/libs/east-c)**: C11 native runtime for executing East IR. Tarballed for `linux-x64` and `linux-arm64`, attached to each GitHub Release.
+  - `east-c`: Core runtime — type system, IR interpreter, 200+ builtins, serialization (Beast2, JSON, CSV, East text)
+  - `east-c-std`: Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - `east-c-cli`: CLI for running East IR programs natively
+
+- **[East Python](https://github.com/elaraai/east-workspace/tree/main/libs/east-py)**: Python runtime, standard platform, I/O, and data-science platform functions. Published to PyPI.
+  - [east-py](https://pypi.org/project/east-py/): Core Python runtime — type system, IR compiler, 212+ builtins, Cython-accelerated hot paths
+  - [east-py-std](https://pypi.org/project/east-py-std/): Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - [east-py-io](https://pypi.org/project/east-py-io/): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
+  - [east-py-cli](https://pypi.org/project/east-py-cli/): CLI for running East IR programs in Python
+  - [east-py-datascience](https://pypi.org/project/east-py-datascience/) (PyPI) + [@elaraai/east-py-datascience](https://www.npmjs.com/package/@elaraai/east-py-datascience) (npm): Optimization (MADS, Optuna, ALNS, GoogleOR), ML (XGBoost, LightGBM, NGBoost, PyTorch, Lightning, GP), Bayesian inference (PyMC), explainability (SHAP), conformal prediction (MAPIE)
 
-- **[East UI](https://github.com/elaraai/east-ui)**: East types and expressions for building dashboards and interactive layouts. Define UIs as data structures that render consistently across React, web, and other environments.
+- **[East UI](https://github.com/elaraai/east-workspace/tree/main/libs/east-ui)**: Typed UI component definitions and React renderer, plus VS Code preview.
   - [@elaraai/east-ui](https://www.npmjs.com/package/@elaraai/east-ui): 50+ typed UI components for layouts, forms, charts, tables, dialogs
-  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI styling
+  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI v3 styling
+  - [@elaraai/e3-ui](https://www.npmjs.com/package/@elaraai/e3-ui): e3 + UI bridge — Data bindings, `e3.ui()` task, manifest
+  - [@elaraai/e3-ui-components](https://www.npmjs.com/package/@elaraai/e3-ui-components): React Query hooks and preview components for the e3 API
+  - [east-ui-preview](https://marketplace.visualstudio.com/items?itemName=ElaraAI.east-ui-preview): VS Code extension for live East UI component preview
 
-- **[e3 - East Execution Engine](https://github.com/elaraai/e3)**: Durable execution engine for running East pipelines at scale. Features Git-like content-addressable storage, automatic memoization, task queuing, and real-time monitoring.
+- **[e3 — East Execution Engine](https://github.com/elaraai/east-workspace/tree/main/libs/e3)**: Durable execution engine for running East pipelines at scale. Git-like content-addressable storage, automatic memoization, reactive dataflow, real-time monitoring.
   - [@elaraai/e3](https://www.npmjs.com/package/@elaraai/e3): SDK for authoring e3 packages with typed tasks and pipelines
-  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Git-like object store, task queue, result caching
+  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Object store, dataflow orchestrator, execution state
   - [@elaraai/e3-types](https://www.npmjs.com/package/@elaraai/e3-types): Shared type definitions for e3 packages
-  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 init`, `e3 run`, `e3 logs` commands for managing and monitoring tasks
-  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 servers
+  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 repo`, `e3 package`, `e3 workspace`, `e3 start`, `e3 watch`, `e3 logs` commands
+  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 repositories
   - [@elaraai/e3-api-server](https://www.npmjs.com/package/@elaraai/e3-api-server): REST API server for e3 repositories
+  - [@elaraai/e3-api-tests](https://www.npmjs.com/package/@elaraai/e3-api-tests): Shared API compliance test suites
 
 ## Links
 
-- [East Language](https://github.com/elaraai/east)
-- [East Python Runtime](https://github.com/elaraai/east-py)
+- [East Language](https://github.com/elaraai/east-workspace/tree/main/libs/east)
+- [East Python Runtime](https://github.com/elaraai/east-workspace/tree/main/libs/east-py)
 - [Elara AI](https://elaraai.com/)
-- [Issues](https://github.com/elaraai/e3/issues)
+- [Issues](https://github.com/elaraai/east-workspace/issues)
 - support@elara.ai
 
 ## About Elara
@@ -153,4 +300,8 @@ East is developed by [Elara AI Pty Ltd](https://elaraai.com/), an AI-powered pla
 
 ---
 
+*Developed by [Elara AI Pty Ltd](https://elaraai.com/).*
+
+---
+
 *Developed by [Elara AI Pty Ltd](https://elaraai.com/)*

package/dist/src/async-operation-state.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { GcResult, GcStatusResult } from './types.js';
+/**
+ * Create a new GC operation and return its execution ID.
+ */
+export declare function createGcOperation(): string;
+/**
+ * Mark a GC operation as succeeded with stats.
+ */
+export declare function completeGcOperation(executionId: string, stats: GcResult): void;
+/**
+ * Mark a GC operation as failed with error message.
+ */
+export declare function failGcOperation(executionId: string, error: string): void;
+/**
+ * Get the status of a GC operation.
+ * Returns null if operation doesn't exist.
+ */
+export declare function getGcOperationStatus(executionId: string): GcStatusResult | null;
+/**
+ * Check if a GC operation exists.
+ */
+export declare function hasGcOperation(executionId: string): boolean;
+/**
+ * Clear a GC operation.
+ * Useful for cleanup in tests.
+ */
+export declare function clearGcOperation(executionId: string): void;
+/**
+ * Clear all async operation states.
+ * Useful for cleanup in tests.
+ */
+export declare function clearAllAsyncOperations(): void;
+//# sourceMappingURL=async-operation-state.d.ts.map

package/dist/src/async-operation-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-operation-state.d.ts","sourceRoot":"","sources":["../../src/async-operation-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuB3D;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAa9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAoC/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAE1D;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/src/async-operation-state.js

@@ -0,0 +1,118 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * In-memory state storage for async operations (GC, repo deletion).
+ *
+ * Tracks operation status for each execution, allowing clients to poll
+ * for progress updates during long-running operations.
+ *
+ * This serves as a development/test mock for the Step Function-based
+ * execution tracking in e3-aws.
+ */
+import { randomUUID } from 'crypto';
+import { variant, some, none } from '@elaraai/east';
+// Key: executionId (UUID)
+const gcOperations = new Map();
+/**
+ * Create a new GC operation and return its execution ID.
+ */
+export function createGcOperation() {
+    const executionId = randomUUID();
+    gcOperations.set(executionId, {
+        status: 'running',
+        startedAt: new Date(),
+    });
+    return executionId;
+}
+/**
+ * Mark a GC operation as succeeded with stats.
+ */
+export function completeGcOperation(executionId, stats) {
+    const op = gcOperations.get(executionId);
+    if (op) {
+        op.status = 'succeeded';
+        op.completedAt = new Date();
+        op.stats = {
+            deletedObjects: stats.deletedObjects,
+            deletedPartials: stats.deletedPartials,
+            retainedObjects: stats.retainedObjects,
+            skippedYoung: stats.skippedYoung,
+            bytesFreed: stats.bytesFreed,
+        };
+    }
+}
+/**
+ * Mark a GC operation as failed with error message.
+ */
+export function failGcOperation(executionId, error) {
+    const op = gcOperations.get(executionId);
+    if (op) {
+        op.status = 'failed';
+        op.completedAt = new Date();
+        op.error = error;
+    }
+}
+/**
+ * Get the status of a GC operation.
+ * Returns null if operation doesn't exist.
+ */
+export function getGcOperationStatus(executionId) {
+    const op = gcOperations.get(executionId);
+    if (!op) {
+        return null;
+    }
+    // Convert status to East variant
+    let status;
+    switch (op.status) {
+        case 'running':
+            status = variant('running', null);
+            break;
+        case 'succeeded':
+            status = variant('succeeded', null);
+            break;
+        case 'failed':
+            status = variant('failed', null);
+            break;
+    }
+    // Convert stats to East option
+    const stats = op.stats
+        ? some({
+            deletedObjects: op.stats.deletedObjects,
+            deletedPartials: op.stats.deletedPartials,
+            retainedObjects: op.stats.retainedObjects,
+            skippedYoung: op.stats.skippedYoung,
+            bytesFreed: op.stats.bytesFreed,
+        })
+        : none;
+    return {
+        status,
+        stats,
+        error: op.error ? some(op.error) : none,
+    };
+}
+/**
+ * Check if a GC operation exists.
+ */
+export function hasGcOperation(executionId) {
+    return gcOperations.has(executionId);
+}
+/**
+ * Clear a GC operation.
+ * Useful for cleanup in tests.
+ */
+export function clearGcOperation(executionId) {
+    gcOperations.delete(executionId);
+}
+// =============================================================================
+// Test Utilities
+// =============================================================================
+/**
+ * Clear all async operation states.
+ * Useful for cleanup in tests.
+ */
+export function clearAllAsyncOperations() {
+    gcOperations.clear();
+}
+//# sourceMappingURL=async-operation-state.js.map

package/dist/src/async-operation-state.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { Hono } from 'hono';
+import type { KeyPair } from './keys.js';
+/**
+ * Device flow configuration.
+ */
+export interface DeviceFlowConfig {
+    /** Server base URL (e.g., http://localhost:3000) */
+    baseUrl: string;
+    /** RSA keypair for signing tokens */
+    keys: KeyPair;
+    /** Access token expiry in seconds (default: 3600 = 1 hour) */
+    accessTokenExpiry: number;
+    /** Refresh token expiry in seconds (default: 7776000 = 90 days) */
+    refreshTokenExpiry: number;
+    /** Auto-approve device codes (for CI testing) */
+    autoApprove: boolean;
+}
+/**
+ * Create device flow routes.
+ */
+export declare function createDeviceRoutes(config: DeviceFlowConfig): Hono;
+//# sourceMappingURL=device.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../src/auth/device.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,WAAW,CAAC;AAYrD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;CACtB;AAqCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA0MjE"}