@lifesi/genesis 0.1.0 → 0.1.1

package/dist/client.js

@@ -1,5 +1,6 @@
 import { operationTable, services } from './generated/operations.js';
 import { GenesisError } from './errors.js';
+import { validateHivesInvocation, hivesFunctionResponseHeaders, hivesFunctionMetadata } from './hives-functions.js';
 export const DEFAULT_BASE_URL = 'https://console.life.one/api';
 const env = globalThis.process?.env ?? {};
 export class GenesisClient {
@@ -59,14 +60,36 @@ export class GenesisClient {
     /** Call any Genesis operation by id, fully typed from the merged spec. */
     async request(operationId, input, init = {}) {
         const res = await this.raw(operationId, (input ?? {}), init);
+        if (operationTable[operationId].rawResponse)
+            return res;
         if (res.status === 204)
             return undefined;
         const ct = res.headers.get('content-type') ?? '';
-        return (ct.includes('json') ? await res.json() : await res.text());
+        let value;
+        try {
+            value = ct.includes('json') ? await res.json() : await res.text();
+        }
+        catch (error) {
+            if (String(operationId).startsWith('hives_') && /_functions?$/.test(operationId))
+                throw new Error('Hives returned invalid function metadata.');
+            throw error;
+        }
+        if (operationId === 'hives_list_functions') {
+            if (!value || !Array.isArray(value.data) || !value.pagination)
+                throw new Error('Hives returned invalid function list metadata.');
+            const pagination = Object.fromEntries(['page', 'per_page', 'total', 'total_pages', 'has_next', 'has_prev'].map((key) => [key, value.pagination[key]]));
+            return { data: value.data.map((row) => hivesFunctionMetadata(row, input?.project_id)), pagination };
+        }
+        if (['hives_get_function', 'hives_create_function', 'hives_update_function'].includes(operationId)) {
+            return hivesFunctionMetadata(value, input?.project_id);
+        }
+        return value;
     }
-    /** Like request() but returns the raw Response (for streaming). Throws GenesisError on non-2xx. */
+    /** Raw Response. Completed Hives guest responses retain their actual status, including non-2xx. */
     async raw(operationId, input = {}, init = {}) {
         const op = operationTable[operationId];
+        if (op.rawResponse && op.service === 'hives')
+            validateHivesInvocation(input.body);
         const url = this.url(operationId, input);
         const headers = {
             accept: 'application/json',
@@ -83,10 +106,72 @@ export class GenesisClient {
         }
         let body;
         if (op.hasBody && input.body !== undefined) {
-            headers['content-type'] = 'application/json';
-            body = JSON.stringify(input.body);
+            // Fetch owns multipart boundary generation. Never serialize a File/Blob as JSON.
+            for (const key of Object.keys(headers))
+                if (key.toLowerCase() === 'content-type')
+                    delete headers[key];
+            if (op.requestContentType === 'multipart/form-data') {
+                if (!(input.body instanceof FormData))
+                    throw new GenesisError({ status: 0, type: 'invalid_request', operationId,
+                        message: 'This operation requires a FormData body containing a real binary file.' });
+                body = input.body;
+            }
+            else {
+                if (input.body instanceof FormData || input.body instanceof Blob || input.body instanceof ArrayBuffer || ArrayBuffer.isView(input.body)) {
+                    throw new GenesisError({ status: 0, type: 'invalid_request', operationId, message: 'This operation requires a JSON body.' });
+                }
+                headers['content-type'] = 'application/json';
+                body = JSON.stringify(input.body);
+            }
+        }
+        const secretOperation = op.service === 'hives' && /_secrets?$/.test(operationId);
+        const functionOperation = op.service === 'hives' && (op.rawResponse || /_function(?:s|_async)?$/.test(operationId));
+        let res;
+        try {
+            res = await this.fetchImpl(url, { method: op.method, headers, body, signal: init.signal,
+                ...(op.service === 'hives' ? { cache: 'no-store', redirect: op.rawResponse ? 'manual' : 'error' } : {}) });
+        }
+        catch (error) {
+            if (functionOperation)
+                throw new GenesisError({ status: 0, type: 'transport_error', operationId,
+                    message: 'Hives function transport failed. No redirects are followed; check the service address and retry.' });
+            if (!secretOperation)
+                throw error;
+            throw new GenesisError({ status: 0, type: 'transport_error', operationId,
+                message: 'Hives secret transport failed. Redirects are refused; check the service address and retry.' });
+        }
+        if (op.rawResponse && /^exec_[a-f0-9]{32}$/.test(res.headers.get('x-execution-id') ?? '')) {
+            return new Response(res.body, { status: res.status, statusText: res.statusText, headers: hivesFunctionResponseHeaders(res.headers) });
+        }
+        if (op.rawResponse && res.ok)
+            throw new GenesisError({ status: res.status, type: 'invalid_response', operationId,
+                message: 'Hives did not confirm a completed guest execution. Refresh the resource and retry.' });
+        if (functionOperation && !res.ok) {
+            const message = res.status === 401 ? 'Genesis credential rejected. Sign in again.'
+                : res.status === 403 ? 'Missing the authorized Hives scope for this function action.'
+                    : res.status === 404 ? 'Function/deployment, project or artifact not found in the authenticated organization and project.'
+                        : res.status === 409 ? 'Function mutation conflicted. Refresh its metadata before retrying.'
+                            : res.status === 400 || res.status === 422 ? 'Invalid function request. Check artifact, resource bounds and guest request syntax.'
+                                : res.status === 413 ? 'Function request exceeds a body or serialized guest envelope limit.'
+                                    : res.status >= 300 && res.status < 400 ? 'Unexpected function service redirect. No redirect was followed.'
+                                        : `Hives function operation failed (${res.status}). Refresh and retry.`;
+            throw new GenesisError({ status: res.status, type: `http_${res.status}`, operationId, message,
+                requestId: res.headers.get('x-request-id') ?? undefined });
+        }
+        if (!res.ok && secretOperation) {
+            const message = res.status === 401 ? 'Genesis credential rejected. Sign in again.'
+                : res.status === 403 ? 'Missing the authorized Hives scope for this action (hives:read or hives:write).'
+                    : res.status === 404 ? 'Secret or project not found in your authenticated organization.'
+                        : res.status === 409 ? 'A secret with this name already exists. Update it instead.'
+                            : res.status === 400 || res.status === 422 ? 'Invalid secret request. Check names and UTF-8 value size.'
+                                : res.status === 413 ? 'Secret request too large. Use a smaller batch.'
+                                    : res.status === 429 ? 'Too many requests. Wait briefly before retrying.'
+                                        : res.status === 503 ? 'Hives customer encryption is unavailable or stored secrets require protected migration.'
+                                            : `Hives secret operation failed (${res.status}). Refresh metadata and retry.`;
+            // Validation/provider bodies may reflect submitted plaintext. Never retain or log them.
+            throw new GenesisError({ status: res.status, type: `http_${res.status}`, message, operationId,
+                requestId: res.headers.get('x-request-id') ?? undefined });
         }
-        const res = await this.fetchImpl(url, { method: op.method, headers, body, signal: init.signal });
         if (!res.ok)
             throw await GenesisError.fromResponse(res, operationId);
         return res;

package/dist/dials.d.ts

@@ -8,16 +8,91 @@ export type DialsOutboundCall = components['schemas']['Dials.OutboundCall'];
 export type DialsEmergencyAddress = components['schemas']['Dials.RegisterEmergencyAddress'];
 /** Scope is selection only; the Dials backend verifies its org against signed identity. */
 export declare function dialsModule(client: GenesisClient): {
+    overview: {
+        summary: (scope: DialsScope) => Promise<{
+            ok: boolean;
+            scope: components["schemas"]["Dials.Scope"];
+            calls: {
+                total: number;
+                queued: number;
+                active: number;
+                completed: number;
+                failed: number;
+            };
+            dispatch: {
+                total: number;
+                pending: number;
+                claimed: number;
+                dispatched: number;
+                failed: number;
+            };
+            people: {
+                deployed: number;
+            };
+            agents: {
+                deployed: number;
+            };
+            routes: {
+                deployed: number;
+            };
+            numbers: {
+                deployed: number;
+            };
+            voice: {
+                deployed: number;
+            };
+            messages: {
+                total: number;
+                queued: number;
+                delivered: number;
+                failed: number;
+            };
+            usage: {
+                total: number;
+                quantity: number;
+                lastMetric: string | null;
+                lastResourceId: string | null;
+            };
+        }>;
+        operatingSurface: (scope: DialsScope) => Promise<{
+            ok: boolean;
+            scope: components["schemas"]["Dials.Scope"];
+            summary: components["schemas"]["Dials.ConsoleSummary"];
+            surfaces: components["schemas"]["Dials.OperatingSurfaceCard"][];
+        } & {
+            [key: string]: unknown;
+        }>;
+    };
     numbers: {
+        reconciliations: (scope: DialsScope) => Promise<{
+            ok: boolean;
+            reconciliations: components["schemas"]["Dials.InventoryReconciliation"][];
+        }>;
+        drift: (scope: DialsScope) => Promise<{
+            ok: boolean;
+            drift: components["schemas"]["Dials.InventoryDrift"][];
+        }>;
+        updateCallerName: (body: OperationInput<"dials_updateNumberCallerName">["body"]) => Promise<{
+            ok: boolean;
+            number: components["schemas"]["Dials.Number"];
+            auditId: string;
+            next: string;
+        }>;
+        reconcile: (body: OperationInput<"dials_reconcileNumberInventory">["body"]) => Promise<{
+            ok: boolean;
+            reconciliations: components["schemas"]["Dials.InventoryReconciliation"][];
+            drift: components["schemas"]["Dials.InventoryDrift"][];
+            orphanCount: number;
+            auditId: string;
+            next: string;
+        }>;
         list: (scope: DialsScope) => Promise<{
             ok: boolean;
             numbers: components["schemas"]["Dials.Number"][];
         }>;
-        search: (scope: DialsScope, query?: {
-            areaCode?: string;
-            limit?: number;
-        }) => Promise<{
-            [key: string]: unknown;
+        search: (scope: DialsScope, query?: Omit<OperationInput<"dials_searchNumbers">, keyof DialsScope>) => Promise<{
+            ok: boolean;
+            numbers: components["schemas"]["Dials.AvailableNumber"][];
         }>;
         provision: (body: OperationInput<"dials_provisionNumber">["body"]) => Promise<{
             [key: string]: unknown;
@@ -49,3 +124,6 @@ export declare function dialsModule(client: GenesisClient): {
         }>;
     };
 };
+export type DialsEmergencyAddressFeedback = components['schemas']['Dials.EmergencyAddressFeedback'];
+/** Read bounded, typed advisory feedback from the existing Genesis error. Never auto-apply it. */
+export declare function dialsEmergencyAddressFeedback(error: unknown): DialsEmergencyAddressFeedback | undefined;

package/dist/dials.js

@@ -1,9 +1,18 @@
+import { GenesisError } from './errors.js';
 /** Scope is selection only; the Dials backend verifies its org against signed identity. */
 export function dialsModule(client) {
     return {
+        overview: {
+            summary: (scope) => client.request('dials_getConsoleSummary', scope),
+            operatingSurface: (scope) => client.request('dials_getOperatingSurface', scope),
+        },
         numbers: {
+            reconciliations: (scope) => client.request('dials_listNumberReconciliations', scope),
+            drift: (scope) => client.request('dials_listNumberDrift', scope),
+            updateCallerName: (body) => client.request('dials_updateNumberCallerName', { body }),
+            reconcile: (body) => client.request('dials_reconcileNumberInventory', { body }),
             list: (scope) => client.request('dials_listNumbers', scope),
-            search: (scope, query = {}) => client.request('dials_searchNumbers', { ...scope, ...query }),
+            search: (scope, query = {}) => client.request('dials_searchNumbers', { ...query, ...scope }),
             provision: (body) => client.request('dials_provisionNumber', { body }),
             assign: (body) => client.request('dials_assignNumber', { body }),
             release: (body) => client.request('dials_releaseNumber', { body }),
@@ -16,3 +25,35 @@ export function dialsModule(client) {
         },
     };
 }
+const fields = { streetNumber: 'Review the street number.', streetName: 'Review the street name.', addressLine2: 'Review the suite or unit type and number.', city: 'Review the city.', region: 'Review the state.', postalCode: 'Review the postal code.', country: 'Review the country.', address: 'The carrier could not validate this address. Review the address and any suggestions.' };
+const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const addressText = (value, max) => typeof value === 'string' && value.length > 0 && value.length <= max && /^[\p{L}\p{N} .,'#/-]+$/u.test(value) && !/(bearer|basic |sk_|api_key|authorization|secret|token=)/i.test(value);
+/** Read bounded, typed advisory feedback from the existing Genesis error. Never auto-apply it. */
+export function dialsEmergencyAddressFeedback(error) {
+    if (!(error instanceof GenesisError) || error.status !== 422 || error.operationId !== 'dials_registerEmergencyAddress')
+        return;
+    const body = error.body;
+    if (!object(body) || body.error !== 'carrier_rejected' || body.automaticCorrection !== false || !Array.isArray(body.fieldErrors) || !body.fieldErrors.length || body.fieldErrors.length > 8 || !Array.isArray(body.candidates) || body.candidates.length > 5)
+        return;
+    const fieldErrors = [];
+    for (const value of body.fieldErrors) {
+        if (!object(value) || typeof value.field !== 'string' || !Object.hasOwn(fields, value.field) || !['required', 'invalid', 'not_found', 'ambiguous', 'not_validated'].includes(String(value.code)))
+            return;
+        const field = value.field;
+        fieldErrors.push({ field, code: value.code, message: fields[field] });
+    }
+    const candidates = [];
+    for (const value of body.candidates) {
+        if (!object(value) || !addressText(value.streetNumber, 32) || !addressText(value.streetName, 128) || !addressText(value.city, 80) || typeof value.region !== 'string' || !/^[A-Za-z]{2}$/.test(value.region) || typeof value.postalCode !== 'string' || !/^\d{5}(?:-\d{4})?$/.test(value.postalCode))
+            return;
+        const extra = {};
+        if (value.addressType !== undefined || value.addressNumber !== undefined) {
+            if (!['Apartment', 'Basement', 'Building', 'Department', 'Floor', 'Office', 'Penthouse', 'Suite', 'Trailer', 'Unit'].includes(String(value.addressType)) || !addressText(value.addressNumber, 32))
+                return;
+            extra.addressType = value.addressType;
+            extra.addressNumber = value.addressNumber;
+        }
+        candidates.push({ streetNumber: value.streetNumber, streetName: value.streetName, city: value.city, region: value.region, postalCode: value.postalCode, ...extra });
+    }
+    return { automaticCorrection: false, fieldErrors, candidates };
+}