nvent 1.0.0-alpha.1 → 1.0.0-alpha.11

package/dist/module.d.mts

@@ -1,4 +1,37 @@
-import * as nuxt_schema from 'nuxt/schema';
+import * as _nuxt_schema from '@nuxt/schema';
+
+interface NventExtendedQueueDefinition {
+    /** Queue name used by TriggerAction.Enqueue({ queue }) */
+    name: string;
+    type?: 'standard' | 'fifo';
+    concurrency?: number;
+    /** Alias of maxRetries */
+    retries?: number;
+    maxRetries?: number;
+    /** Alias of backoffMs */
+    backoff?: number;
+    backoffMs?: number;
+    /** Optional visibility timeout / lease timeout if supported by the engine */
+    visibilityTimeoutMs?: number;
+    leaseTimeoutMs?: number;
+    /** Optional dead-letter / fallback queue names if supported by the engine */
+    deadLetterQueue?: string;
+    fallbackQueue?: string;
+    messageGroupField?: string;
+}
+type NventQueueConfig = {
+    type?: 'standard' | 'fifo';
+    concurrency?: number;
+    retries?: number;
+    maxRetries?: number;
+    backoff?: number;
+    backoffMs?: number;
+    visibilityTimeoutMs?: number;
+    leaseTimeoutMs?: number;
+    deadLetterQueue?: string;
+    fallbackQueue?: string;
+    messageGroupField?: string;
+};
 
 /**
  * nvent module options
@@ -38,9 +71,13 @@ interface NventIiiOptions {
                 type: 'kv';
                 storeMethod?: 'file_based' | 'in_memory';
                 filePath?: string;
+                saveIntervalMs?: number;
             } | {
                 type: 'redis';
                 redisUrl?: string;
+            } | {
+                type: 'bridge';
+                bridgeUrl: string;
             };
         };
         /**
@@ -52,18 +89,42 @@ interface NventIiiOptions {
                 type: 'builtin';
                 storeMethod?: 'file_based' | 'in_memory';
                 filePath?: string;
+                saveIntervalMs?: number;
+                maxAttempts?: number;
+                backoffMs?: number;
+                concurrency?: number;
+                pollIntervalMs?: number;
+                /** Processing order. 'concurrent' (parallel) or 'fifo' (sequential). Default: 'concurrent' */
+                mode?: 'concurrent' | 'fifo';
             } | {
                 type: 'redis';
                 redisUrl?: string;
             } | {
                 type: 'rabbitmq';
                 amqpUrl?: string;
+                maxAttempts?: number;
+                prefetchCount?: number;
+                /** 'standard' or 'quorum' (HA replicated). Default: 'standard' */
+                queueMode?: 'standard' | 'quorum';
+            } | {
+                type: 'bridge';
+                bridgeUrl: string;
             };
             queueConfigs?: Record<string, {
                 type?: 'standard' | 'fifo';
                 concurrency?: number;
+                /** Alias of maxRetries */
+                retries?: number;
                 maxRetries?: number;
+                /** Alias of backoffMs */
+                backoff?: number;
                 backoffMs?: number;
+                /** Optional visibility timeout / lease timeout if supported by the engine */
+                visibilityTimeoutMs?: number;
+                leaseTimeoutMs?: number;
+                /** Optional dead-letter / fallback queue names if supported by the engine */
+                deadLetterQueue?: string;
+                fallbackQueue?: string;
                 /** FIFO only: field in the payload used to group messages */
                 messageGroupField?: string;
             }>;
@@ -72,6 +133,11 @@ interface NventIiiOptions {
         cron?: {
             adapter?: {
                 type: 'kv';
+                lockTtlMs?: number;
+                lockIndex?: string;
+                storeMethod?: 'file_based' | 'in_memory';
+                filePath?: string;
+                saveIntervalMs?: number;
             } | {
                 type: 'redis';
                 redisUrl?: string;
@@ -85,9 +151,13 @@ interface NventIiiOptions {
                 type: 'kv';
                 storeMethod?: 'file_based' | 'in_memory';
                 filePath?: string;
+                saveIntervalMs?: number;
             } | {
                 type: 'redis';
                 redisUrl?: string;
+            } | {
+                type: 'bridge';
+                bridgeUrl: string;
             };
         };
         /** REST API module extra settings */
@@ -95,6 +165,13 @@ interface NventIiiOptions {
             host?: string;
             defaultTimeout?: number;
             concurrencyRequestLimit?: number;
+            /** CORS configuration for browser clients */
+            cors?: {
+                /** Origins allowed to make requests. Use '*' for any, or list specific domains. */
+                allowedOrigins?: string[];
+                /** HTTP methods permitted for cross-origin requests. */
+                allowedMethods?: string[];
+            };
         };
         /** OtelModule (observability) configuration */
         observability?: {
@@ -124,6 +201,36 @@ interface NventIiiOptions {
             logsFlushIntervalMs?: number;
             logsSamplingRatio?: number;
             logsConsoleOutput?: boolean;
+            /** Advanced sampling rules — override samplingRatio for matched operations. */
+            sampling?: {
+                default?: number;
+                parentBased?: boolean;
+                rules?: Array<{
+                    operation?: string;
+                    service?: string;
+                    rate: number;
+                }>;
+                rateLimit?: {
+                    maxTracesPerSecond?: number;
+                };
+            };
+            /** Alert rules — trigger a webhook or function when a metric crosses a threshold. */
+            alerts?: Array<{
+                name: string;
+                metric: string;
+                threshold: number;
+                operator: '>' | '>=' | '<' | '<=' | '==' | '!=';
+                windowSeconds: number;
+                enabled?: boolean;
+                cooldownSeconds?: number;
+                action: {
+                    type: 'webhook';
+                    url: string;
+                } | {
+                    type: 'function';
+                    path: string;
+                };
+            }>;
             level?: 'trace' | 'debug' | 'info' | 'warn' | 'error';
             format?: 'default' | 'json';
         };
@@ -147,10 +254,104 @@ interface NventIiiOptions {
             /** Enable the Flow visualization page */
             flow?: boolean;
         };
+        /** PubSub worker — topic-based event fanout across functions. */
+        pubsub?: {
+            adapter?: {
+                type: 'local';
+            } | {
+                type: 'redis';
+                redisUrl?: string;
+            };
+        };
+        /**
+         * HTTP Functions worker — enables outbound HTTP calls from the engine.
+         * Required for functions registered with HttpInvocationConfig.
+         */
+        httpFunctions?: {
+            security?: {
+                /** URL patterns allowed for outbound requests. Use '*' to allow all. */
+                urlAllowlist?: string[];
+                /** Block requests to private/internal IP ranges (SSRF prevention). Default: true */
+                blockPrivateIps?: boolean;
+                /** Require HTTPS for all outbound requests. Default: true */
+                requireHttps?: boolean;
+            };
+        };
+        /**
+         * Additional iii-worker-manager instance with RBAC.
+         * nvent uses this automatically when browser SDK is enabled.
+         * Can also be configured manually for custom auth scenarios.
+         */
+        workerManager?: {
+            rbac?: {
+                /** Port for the RBAC worker manager. Default: 49135 */
+                port?: number;
+                /** Function ID called on every WebSocket upgrade for auth. */
+                authFunctionId?: string;
+                /** Functions the connecting worker is allowed to invoke (patterns supported). */
+                exposeFunctions?: string[];
+                /** Function invoked before each handler — enrich or audit requests. */
+                middlewareFunctionId?: string;
+                /** Allow workers to register their own function handlers. Default: true */
+                allowFunctionRegistration?: boolean;
+                /** Allow workers to register new trigger types. Default: false */
+                allowTriggerTypeRegistration?: boolean;
+                /** Prefix prepended to every function the worker registers. */
+                functionRegistrationPrefix?: string;
+                /** TTL for signed browser auth tokens generated by the Nuxt proxy. Default: 120 */
+                tokenTtlSeconds?: number;
+                /** Allow browser connections without a custom resolver returning user context. Default: true */
+                allowAnonymous?: boolean;
+                /** Optional path (relative to project root) to a custom browser auth resolver module. */
+                authResolverPath?: string;
+            };
+        };
+        /**
+         * Bridge client workers — connects this engine to remote iii instances.
+         * Each entry creates an `iii-bridge` worker in the config.
+         */
+        bridge?: Array<{
+            url: string;
+            serviceId: string;
+            serviceName?: string;
+            expose?: Array<{
+                localFunction: string;
+                remoteFunction?: string;
+            }>;
+            forward?: Array<{
+                localFunction: string;
+                remoteFunction: string;
+                timeoutMs?: number;
+            }>;
+        }>;
+        /**
+         * Exec workers — spawns external processes alongside the engine.
+         * Each entry creates an `iii-exec` worker in the config.
+         */
+        exec?: Array<{
+            watch?: string[];
+            exec: string[];
+        }>;
+        /** Anonymous usage telemetry. Set enabled: false to opt out. */
+        telemetry?: {
+            enabled?: boolean;
+            apiKey?: string;
+            sdkApiKey?: string;
+            heartbeatIntervalSecs?: number;
+        };
     };
     functions?: {
         /** Directory under server/ where functions are, relative to serverDir (default: 'functions') */
         dir?: string;
+        /**
+         * Function ID prefix for this layer's functions.
+         * Set in a layer's `nuxt.config.ts` to namespace its functions.
+         * Priority: this value → `$meta.name` → package.json name → directory name.
+         * Set to `''` (empty string) to explicitly opt out of any prefix.
+         * Has no effect in the root project (always un-prefixed).
+         * Example: 'myorg::auth'
+         */
+        prefix?: string;
         python?: {
             /**
              * Path to the Python executable used **in development only** (e.g. a virtualenv).
@@ -180,6 +381,66 @@ interface NventIiiOptions {
     };
 }
 
-declare const _default: nuxt_schema.NuxtModule<NventIiiOptions, NventIiiOptions, false>;
+interface LayerInfo {
+    rootDir: string;
+    serverDir: string;
+    /**
+     * Prefix prepended to every function ID discovered in this layer.
+     * Empty string (or undefined) means no prefix — root project convention.
+     * e.g. 'auth' → 'login.ts' becomes 'auth::login'
+     */
+    prefix?: string;
+}
+
+interface NventExtendedFunction {
+    /** iii function ID (e.g. `fhir::terminology::lookup`) */
+    id: string;
+    /** Absolute file path, or root-relative path, to a TS/JS function module */
+    absPath: string;
+    /** Optional human-readable description */
+    description?: string;
+}
+interface NventExtendedPythonFunction {
+    /** iii function ID (e.g. `fhir::terminology::expand`) */
+    id: string;
+    /** Absolute file path, or root-relative path, to a .py file */
+    absPath: string;
+    /** When true, start this function in a dedicated worker process */
+    standalone?: boolean;
+}
+interface NventExtendFunctionsHookPayload {
+    /** Push extra TS/JS function files to register */
+    functions: NventExtendedFunction[];
+    /** Push extra Python function files to register */
+    pythonFunctions: NventExtendedPythonFunction[];
+    /** Nuxt project root */
+    rootDir: string;
+    /** Layer scan context (same as nvent internal scan) */
+    layerInfos: LayerInfo[];
+    /** Configured functions dir relative to each layer's server dir */
+    functionsDir: string;
+}
+interface NventExtendQueuesHookPayload {
+    /** Push extra named queues to register in iii engine config. */
+    queues: NventExtendedQueueDefinition[];
+    /** Nuxt project root */
+    rootDir: string;
+}
+declare module '@nuxt/schema' {
+    interface NuxtHooks {
+        /**
+         * Extend nvent function discovery with additional TS/JS or Python function files.
+         * Useful for Nuxt modules that ship their own iii handlers.
+         */
+        'nvent:functions:extend': (payload: NventExtendFunctionsHookPayload) => void | Promise<void>;
+        /**
+         * Extend iii named queue definitions so module-owned workflows can enqueue safely.
+         * Duplicate policy: first queue definition wins; later duplicates are ignored with a warning.
+         */
+        'nvent:queues:extend': (payload: NventExtendQueuesHookPayload) => void | Promise<void>;
+    }
+}
+declare const _default: _nuxt_schema.NuxtModule<NventIiiOptions, NventIiiOptions, false>;
 
 export { _default as default };
+export type { NventExtendFunctionsHookPayload, NventExtendQueuesHookPayload, NventExtendedFunction, NventExtendedPythonFunction, NventExtendedQueueDefinition, NventQueueConfig };

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "nvent",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.11",
   "configKey": "nvent",
   "builder": {
     "@nuxt/module-builder": "1.0.2",