@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/document-lines.js

@@ -1,6 +1,3 @@
-/** The document's logical lines: a single terminating newline closes the last
- *  line rather than opening an empty one. Never empty — an empty document is
- *  one empty line. */
-export function documentLines(text) {
-    return (text.endsWith('\n') ? text.slice(0, -1) : text).split('\n');
-}
+var s=Object.defineProperty;var i=(n,e)=>s(n,"name",{value:e,configurable:!0});function o(n){return(n.endsWith(`
+`)?n.slice(0,-1):n).split(`
+`)}i(o,"documentLines");export{o as documentLines};

package/dist/core/env-name.js

@@ -1,9 +1 @@
-/** Validate an environment variable identifier without reading its value. */
-export function validateEnvVarName(name) {
-    const errors = [];
-    if (typeof name !== 'string')
-        errors.push('env var name must be a string');
-    else if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name))
-        errors.push('env var name must start with letter/underscore, followed by alphanumeric/underscore');
-    return { isValid: errors.length === 0, errors };
-}
+var a=Object.defineProperty;var t=(r,e)=>a(r,"name",{value:e,configurable:!0});function s(r){const e=[];return typeof r!="string"?e.push("env var name must be a string"):/^[A-Za-z_][A-Za-z0-9_]*$/.test(r)||e.push("env var name must start with letter/underscore, followed by alphanumeric/underscore"),{isValid:e.length===0,errors:e}}t(s,"validateEnvVarName");export{s as validateEnvVarName};

package/dist/core/errors.js

@@ -1,52 +1 @@
-import { ExitCode } from '../types.js';
-export class CrtrError extends Error {
-    code;
-    exitCode;
-    details;
-    constructor(code, message, exitCode = ExitCode.GENERAL, details) {
-        super(message);
-        this.name = 'CrtrError';
-        this.code = code;
-        this.exitCode = exitCode;
-        this.details = details;
-    }
-}
-export function notFound(message, details) {
-    return new CrtrError('not_found', message, ExitCode.NOT_FOUND, details);
-}
-export function usage(message, details) {
-    return new CrtrError('usage', message, ExitCode.USAGE, details);
-}
-export function ambiguous(message, details) {
-    return new CrtrError('ambiguous', message, ExitCode.AMBIGUOUS, details);
-}
-export function network(message, details) {
-    return new CrtrError('network', message, ExitCode.NETWORK, details);
-}
-export function general(message, details) {
-    return new CrtrError('error', message, ExitCode.GENERAL, details);
-}
-/** A node's broker ENGINE failed to launch or bind its view socket — an
- *  operational failure surfaced from deep in the spawn/revive path (e.g. the
- *  front-door root create). It is NOT a bad request and NOT an internal crtr
- *  bug: it carries a curated cause the caller needs, so it must never collapse
- *  into a bare `internal` 500 with the message stripped.
- *
- *  The `details` deliberately carry the FULL `{error, message, next}` payload so
- *  a server-thrown instance round-trips through crtrd verbatim: `toErrorBody`
- *  surfaces it as a <500 body with structured details, and the client's
- *  `apiErrorToCliError` (tier 2) reconstructs the exact code, message, and
- *  actionable `next` instead of degrading to a generic `invalid_request`. */
-export function brokerLaunchFailed(message, next) {
-    const code = 'broker_launch_failed';
-    return new CrtrError(code, message, ExitCode.GENERAL, { error: code, message, next });
-}
-export function nodeCreateRefused(message, next) {
-    const code = 'node_create_refused';
-    return new CrtrError(code, message, ExitCode.GENERAL, { error: code, message, next });
-}
-/** Thrown by stub handlers for leaves not yet wired in P3+.
- *  code='not_implemented', exitCode=GENERAL, next names the node. */
-export function notImplemented(node) {
-    return new CrtrError('not_implemented', `${node} is not yet implemented.`, ExitCode.GENERAL, { next: 'This leaf is not yet wired.' });
-}
+var c=Object.defineProperty;var t=(e,r)=>c(e,"name",{value:r,configurable:!0});import{ExitCode as n}from"../types.js";class o extends Error{static{t(this,"CrtrError")}code;exitCode;details;constructor(r,u,i=n.GENERAL,d){super(u),this.name="CrtrError",this.code=r,this.exitCode=i,this.details=d}}function a(e,r){return new o("not_found",e,n.NOT_FOUND,r)}t(a,"notFound");function f(e,r){return new o("usage",e,n.USAGE,r)}t(f,"usage");function p(e,r){return new o("ambiguous",e,n.AMBIGUOUS,r)}t(p,"ambiguous");function x(e,r){return new o("network",e,n.NETWORK,r)}t(x,"network");function l(e,r){return new o("error",e,n.GENERAL,r)}t(l,"general");function w(e,r){const u="broker_launch_failed";return new o(u,e,n.GENERAL,{error:u,message:e,next:r})}t(w,"brokerLaunchFailed");function m(e,r){const u="node_create_refused";return new o(u,e,n.GENERAL,{error:u,message:e,next:r})}t(m,"nodeCreateRefused");function N(e){return new o("not_implemented",`${e} is not yet implemented.`,n.GENERAL,{next:"This leaf is not yet wired."})}t(N,"notImplemented");export{o as CrtrError,p as ambiguous,w as brokerLaunchFailed,l as general,x as network,m as nodeCreateRefused,a as notFound,N as notImplemented,f as usage};

package/dist/core/events/emit.js

@@ -1,17 +1 @@
-import { appendRotatingRecord } from '../log.js';
-import { buildEnvelope } from './envelope.js';
-import { serializeEventRecord } from './serialize.js';
-import { eventSource } from './source.js';
-/** The only canonical write path. The bound source owns the destination component/path/stream; node_id identifies the event target, with a broker source enforcing its bound node. */
-export function emitEvent(input) {
-    const source = eventSource();
-    if (source === undefined)
-        return false;
-    if (source.component === 'broker' && source.node_id !== undefined && input.node_id !== undefined && input.node_id !== source.node_id) {
-        throw new TypeError(`broker event target node_id must match bound node_id; received ${input.node_id}`);
-    }
-    if (input.level === 'debug' && process.env['CRTR_LOG'] !== 'debug')
-        return false;
-    const envelope = buildEnvelope({ ...input, component: source.component, ...(source.node_id === undefined ? {} : { node_id: source.node_id }), ...(source.stream_id === undefined ? {} : { stream_id: source.stream_id }) });
-    return appendRotatingRecord(source.path, serializeEventRecord(envelope));
-}
+var r=Object.defineProperty;var o=(d,e)=>r(d,"name",{value:e,configurable:!0});import{appendRotatingRecord as i}from"../log.js";import{buildEnvelope as t}from"./envelope.js";import{serializeEventRecord as m}from"./serialize.js";import{eventSource as f}from"./source.js";function p(d){const e=f();if(e===void 0)return!1;if(e.component==="broker"&&e.node_id!==void 0&&d.node_id!==void 0&&d.node_id!==e.node_id)throw new TypeError(`broker event target node_id must match bound node_id; received ${d.node_id}`);if(d.level==="debug"&&process.env.CRTR_LOG!=="debug")return!1;const n=t({...d,component:e.component,...e.node_id===void 0?{}:{node_id:e.node_id},...e.stream_id===void 0?{}:{stream_id:e.stream_id}});return i(e.path,m(n))}o(p,"emitEvent");export{p as emitEvent};

package/dist/core/events/envelope.js

@@ -1,84 +1 @@
-import { errorClassCodes, eventErrorFromUnknown } from './errors.js';
-import { generateOperationId, operationIdContext, validateOperationId } from './operation-id.js';
-const eventName = /^[a-z][a-z0-9]*(?:[._][a-z0-9]+)*$/;
-const levels = new Set(['error', 'warn', 'info', 'debug']);
-const components = new Set(['daemon', 'broker', 'control-plane', 'front', 'sentinel']);
-const outcomes = new Set(['succeeded', 'failed', 'skipped']);
-const dispositions = new Set(['auto', 'manual', 'fatal']);
-const classes = new Set(errorClassCodes);
-function bytes(value) { return Buffer.byteLength(value, 'utf8'); }
-function requireString(value, name, cap = 128) {
-    if (typeof value !== 'string' || value === '' || bytes(value) > cap)
-        throw new TypeError(`${name} must be a non-empty string of at most ${cap} UTF-8 bytes`);
-    return value;
-}
-function normalizedTimestamp(value) {
-    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}T/.test(value))
-        throw new TypeError('ts must be an ISO 8601 timestamp');
-    const date = new Date(value);
-    if (Number.isNaN(date.getTime()))
-        throw new TypeError('ts must be an ISO 8601 timestamp');
-    return date.toISOString();
-}
-function checkedErrorClass(value) {
-    if (!classes.has(value.class))
-        throw new TypeError('error_class.class is invalid');
-    const result = { class: value.class };
-    if (value.status !== undefined) {
-        if (!Number.isInteger(value.status))
-            throw new TypeError('error_class.status must be an integer');
-        result.status = value.status;
-    }
-    if (value.provider !== undefined)
-        result.provider = requireString(value.provider, 'error_class.provider');
-    if (value.retry_disposition !== undefined) {
-        if (!dispositions.has(value.retry_disposition))
-            throw new TypeError('error_class.retry_disposition is invalid');
-        result.retry_disposition = value.retry_disposition;
-    }
-    return result;
-}
-export function buildEnvelope(input) {
-    if (!levels.has(input.level))
-        throw new TypeError('level is invalid');
-    if (!components.has(input.component))
-        throw new TypeError('component is invalid');
-    const event = requireString(input.event, 'event');
-    if (!eventName.test(event))
-        throw new TypeError('event must be a lowercase dotted identifier');
-    const operationId = input.operation_id === undefined ? operationIdContext.current() ?? generateOperationId() : validateOperationId(input.operation_id);
-    const result = {
-        v: 1,
-        ts: input.ts === undefined ? new Date().toISOString() : normalizedTimestamp(input.ts),
-        level: input.level,
-        event,
-        component: input.component,
-        operation_id: operationId,
-    };
-    if (input.node_id !== undefined)
-        result.node_id = requireString(input.node_id, 'node_id');
-    if (input.stream_id !== undefined)
-        result.stream_id = requireString(input.stream_id, 'stream_id');
-    if (input.duration_ms !== undefined) {
-        if (!Number.isFinite(input.duration_ms) || input.duration_ms < 0)
-            throw new TypeError('duration_ms must be finite and non-negative');
-        result.duration_ms = input.duration_ms;
-    }
-    if (input.outcome !== undefined) {
-        if (!outcomes.has(input.outcome))
-            throw new TypeError('outcome is invalid');
-        result.outcome = input.outcome;
-    }
-    if (input.attempt !== undefined) {
-        if (!Number.isInteger(input.attempt) || input.attempt <= 0)
-            throw new TypeError('attempt must be a positive integer');
-        result.attempt = input.attempt;
-    }
-    if (input.error_class !== undefined)
-        result.error_class = checkedErrorClass(input.error_class);
-    if (input.error !== undefined)
-        result.error = eventErrorFromUnknown(input.error);
-    if (input.fields !== undefined)
-        result.fields = input.fields;
-    return result;
-}
+var i=Object.defineProperty;var o=(e,r)=>i(e,"name",{value:r,configurable:!0});import{errorClassCodes as d,eventErrorFromUnknown as a}from"./errors.js";import{generateOperationId as f,operationIdContext as m,validateOperationId as c}from"./operation-id.js";const w=/^[a-z][a-z0-9]*(?:[._][a-z0-9]+)*$/,l=new Set(["error","warn","info","debug"]),_=new Set(["daemon","broker","control-plane","front","sentinel"]),p=new Set(["succeeded","failed","skipped"]),y=new Set(["auto","manual","fatal"]),h=new Set(d);function u(e){return Buffer.byteLength(e,"utf8")}o(u,"bytes");function s(e,r,n=128){if(typeof e!="string"||e===""||u(e)>n)throw new TypeError(`${r} must be a non-empty string of at most ${n} UTF-8 bytes`);return e}o(s,"requireString");function b(e){if(typeof e!="string"||!/^\d{4}-\d{2}-\d{2}T/.test(e))throw new TypeError("ts must be an ISO 8601 timestamp");const r=new Date(e);if(Number.isNaN(r.getTime()))throw new TypeError("ts must be an ISO 8601 timestamp");return r.toISOString()}o(b,"normalizedTimestamp");function T(e){if(!h.has(e.class))throw new TypeError("error_class.class is invalid");const r={class:e.class};if(e.status!==void 0){if(!Number.isInteger(e.status))throw new TypeError("error_class.status must be an integer");r.status=e.status}if(e.provider!==void 0&&(r.provider=s(e.provider,"error_class.provider")),e.retry_disposition!==void 0){if(!y.has(e.retry_disposition))throw new TypeError("error_class.retry_disposition is invalid");r.retry_disposition=e.retry_disposition}return r}o(T,"checkedErrorClass");function v(e){if(!l.has(e.level))throw new TypeError("level is invalid");if(!_.has(e.component))throw new TypeError("component is invalid");const r=s(e.event,"event");if(!w.test(r))throw new TypeError("event must be a lowercase dotted identifier");const n=e.operation_id===void 0?m.current()??f():c(e.operation_id),t={v:1,ts:e.ts===void 0?new Date().toISOString():b(e.ts),level:e.level,event:r,component:e.component,operation_id:n};if(e.node_id!==void 0&&(t.node_id=s(e.node_id,"node_id")),e.stream_id!==void 0&&(t.stream_id=s(e.stream_id,"stream_id")),e.duration_ms!==void 0){if(!Number.isFinite(e.duration_ms)||e.duration_ms<0)throw new TypeError("duration_ms must be finite and non-negative");t.duration_ms=e.duration_ms}if(e.outcome!==void 0){if(!p.has(e.outcome))throw new TypeError("outcome is invalid");t.outcome=e.outcome}if(e.attempt!==void 0){if(!Number.isInteger(e.attempt)||e.attempt<=0)throw new TypeError("attempt must be a positive integer");t.attempt=e.attempt}return e.error_class!==void 0&&(t.error_class=T(e.error_class)),e.error!==void 0&&(t.error=a(e.error)),e.fields!==void 0&&(t.fields=e.fields),t}o(v,"buildEnvelope");export{v as buildEnvelope};

package/dist/core/events/errors.js

@@ -1,69 +1 @@
-import { errorClassCodes } from './types.js';
-const retryDispositions = new Set(['auto', 'manual', 'fatal']);
-function record(value) {
-    return typeof value === 'object' && value !== null ? value : undefined;
-}
-function text(value) {
-    return typeof value === 'string' ? value : '';
-}
-function statusFrom(error) {
-    const value = record(error)?.['status'];
-    return typeof value === 'number' && Number.isInteger(value) ? value : undefined;
-}
-function codeFrom(error) {
-    const value = record(error);
-    return text(value?.['code']) || text(value?.['errno']);
-}
-function messageFrom(error) {
-    if (typeof error === 'string')
-        return error;
-    if (error instanceof Error)
-        return error.message;
-    const value = record(error);
-    return text(value?.['message']) || text(value?.['statusText']) || text(value?.['reason']);
-}
-function classify(status, code, message) {
-    if (status === 429 || /rate.?limit|too many requests|quota/i.test(message))
-        return 'rate_limit';
-    if (status === 401 || status === 403 || /invalid_grant|refresh token|unauthori[sz]ed|invalid.?api.?key|authentication failed/i.test(message))
-        return 'auth';
-    if (/context overflow/i.test(message))
-        return 'context_overflow';
-    if (/model.{0,40}(not found|does not exist|not available)|not_found_error/i.test(message))
-        return 'model_not_found';
-    if (/wedged/i.test(message))
-        return 'wedged';
-    if (/^(ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENOENT|ENOTFOUND|EAI_AGAIN|EPIPE|EHOSTUNREACH|ENETUNREACH)$/i.test(code) || /connection|econnreset|etimedout|enotfound|network|fetch failed|socket hang|timed? out|websocket.*(?:closed|error)/i.test(message))
-        return 'connection';
-    if ((status !== undefined && status >= 500) || /overloaded|capacity|server.{0,3}busy|temporarily unavailable|internal server error/i.test(message))
-        return 'overloaded';
-    if ((status !== undefined && status >= 400) || /protocol|invalid (?:frame|payload)|policy violation/i.test(message))
-        return 'protocol';
-    return 'unknown';
-}
-export function errorClassFromError(error, hints = {}) {
-    const status = hints.status ?? statusFrom(error);
-    const result = { class: classify(status, codeFrom(error), messageFrom(error)) };
-    if (status !== undefined)
-        result.status = status;
-    if (typeof hints.provider === 'string' && hints.provider !== '')
-        result.provider = hints.provider;
-    if (hints.retry_disposition !== undefined && retryDispositions.has(hints.retry_disposition))
-        result.retry_disposition = hints.retry_disposition;
-    return result;
-}
-export function eventErrorFromUnknown(error) {
-    if (error instanceof Error) {
-        const result = { type: error.name || 'Error', message: error.message };
-        if (typeof error.stack === 'string')
-            result.stack = error.stack;
-        if (error.cause !== undefined)
-            result.cause = error.cause instanceof Error ? error.cause.message : String(error.cause);
-        return result;
-    }
-    if (typeof error === 'string')
-        return { type: 'Error', message: error };
-    const value = record(error);
-    return { type: text(value?.['name']) || 'Error', message: text(value?.['message']) || String(error) };
-}
-export { errorClassCodes };
+var u=Object.defineProperty;var o=(e,t)=>u(e,"name",{value:t,configurable:!0});import{errorClassCodes as a}from"./types.js";const f=new Set(["auto","manual","fatal"]);function s(e){return typeof e=="object"&&e!==null?e:void 0}o(s,"record");function i(e){return typeof e=="string"?e:""}o(i,"text");function d(e){const t=s(e)?.status;return typeof t=="number"&&Number.isInteger(t)?t:void 0}o(d,"statusFrom");function c(e){const t=s(e);return i(t?.code)||i(t?.errno)}o(c,"codeFrom");function l(e){if(typeof e=="string")return e;if(e instanceof Error)return e.message;const t=s(e);return i(t?.message)||i(t?.statusText)||i(t?.reason)}o(l,"messageFrom");function p(e,t,n){return e===429||/rate.?limit|too many requests|quota/i.test(n)?"rate_limit":e===401||e===403||/invalid_grant|refresh token|unauthori[sz]ed|invalid.?api.?key|authentication failed/i.test(n)?"auth":/context overflow/i.test(n)?"context_overflow":/model.{0,40}(not found|does not exist|not available)|not_found_error/i.test(n)?"model_not_found":/wedged/i.test(n)?"wedged":/^(ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENOENT|ENOTFOUND|EAI_AGAIN|EPIPE|EHOSTUNREACH|ENETUNREACH)$/i.test(t)||/connection|econnreset|etimedout|enotfound|network|fetch failed|socket hang|timed? out|websocket.*(?:closed|error)/i.test(n)?"connection":e!==void 0&&e>=500||/overloaded|capacity|server.{0,3}busy|temporarily unavailable|internal server error/i.test(n)?"overloaded":e!==void 0&&e>=400||/protocol|invalid (?:frame|payload)|policy violation/i.test(n)?"protocol":"unknown"}o(p,"classify");function y(e,t={}){const n=t.status??d(e),r={class:p(n,c(e),l(e))};return n!==void 0&&(r.status=n),typeof t.provider=="string"&&t.provider!==""&&(r.provider=t.provider),t.retry_disposition!==void 0&&f.has(t.retry_disposition)&&(r.retry_disposition=t.retry_disposition),r}o(y,"errorClassFromError");function v(e){if(e instanceof Error){const n={type:e.name||"Error",message:e.message};return typeof e.stack=="string"&&(n.stack=e.stack),e.cause!==void 0&&(n.cause=e.cause instanceof Error?e.cause.message:String(e.cause)),n}if(typeof e=="string")return{type:"Error",message:e};const t=s(e);return{type:i(t?.name)||"Error",message:i(t?.message)||String(e)}}o(v,"eventErrorFromUnknown");export{a as errorClassCodes,y as errorClassFromError,v as eventErrorFromUnknown};

package/dist/core/events/index.js

@@ -1,4 +1 @@
-export { validateOperationId, operationIdContext } from './operation-id.js';
-export { buildEnvelope } from './envelope.js';
-export { errorClassCodes, errorClassFromError } from './errors.js';
-export { serializeEventRecord } from './serialize.js';
+import{validateOperationId as e,operationIdContext as t}from"./operation-id.js";import{buildEnvelope as p}from"./envelope.js";import{errorClassCodes as i,errorClassFromError as l}from"./errors.js";import{serializeEventRecord as m}from"./serialize.js";export{p as buildEnvelope,i as errorClassCodes,l as errorClassFromError,t as operationIdContext,m as serializeEventRecord,e as validateOperationId};

package/dist/core/events/operation-id.js

@@ -1,24 +1 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { randomBytes } from 'node:crypto';
-const OPERATION_ID = /^(?!0{32}$)[0-9a-f]{32}$/;
-const storage = new AsyncLocalStorage();
-export function validateOperationId(value) {
-    if (typeof value !== 'string' || !OPERATION_ID.test(value))
-        throw new TypeError('operation_id must be 32 lowercase non-zero hexadecimal characters');
-    return value;
-}
-export function generateOperationId() {
-    let value;
-    do
-        value = randomBytes(16).toString('hex');
-    while (value === '00000000000000000000000000000000');
-    return validateOperationId(value);
-}
-export const operationIdContext = {
-    current: () => storage.getStore(),
-    run: (operationId, callback) => storage.run(validateOperationId(operationId), callback),
-    fresh: (callback) => {
-        const operationId = generateOperationId();
-        return storage.run(operationId, () => callback(operationId));
-    },
-};
+var a=Object.defineProperty;var e=(r,t)=>a(r,"name",{value:t,configurable:!0});import{AsyncLocalStorage as i}from"node:async_hooks";import{randomBytes as c}from"node:crypto";const s=/^(?!0{32}$)[0-9a-f]{32}$/,o=new i;function n(r){if(typeof r!="string"||!s.test(r))throw new TypeError("operation_id must be 32 lowercase non-zero hexadecimal characters");return r}e(n,"validateOperationId");function p(){let r;do r=c(16).toString("hex");while(r==="00000000000000000000000000000000");return n(r)}e(p,"generateOperationId");const m={current:e(()=>o.getStore(),"current"),run:e((r,t)=>o.run(n(r),t),"run"),fresh:e(r=>{const t=p();return o.run(t,()=>r(t))},"fresh")};export{p as generateOperationId,m as operationIdContext,n as validateOperationId};