@atlasauth/emulator-core 0.2.0 → 0.3.1

package/dist/handlers/emu4-actions-catalog.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtInFor = exports.BUILT_IN_ACTIONS = void 0;
+const emu4_actions_def_1 = require("./emu4-actions-def");
+const emu4_actions_catalog_extra_1 = require("./emu4-actions-catalog-extra");
+/**
+ * First-party action packs. Each endpoint was read from the provider's own API reference:
+ *  GitHub  https://docs.github.com/en/rest/issues/issues
+ *  Slack   https://docs.slack.dev/reference/methods/chat.postMessage , .../conversations.list
+ *  Notion  https://developers.notion.com/reference/post-page
+ *  HubSpot https://developers.hubspot.com/docs/api/crm/contacts
+ *  Slack   https://docs.slack.dev/reference/methods/conversations.history , .../users.list
+ *  Google  https://developers.google.com/workspace/calendar/api/v3/reference/events/insert , .../events/list ,
+ *          https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/send , .../users.messages/list , .../users.messages/get
+ *  Linear  GraphQL at https://api.linear.app/graphql (https://linear.app/developers/graphql), schema:
+ *          https://github.com/linear/linear/blob/master/packages/sdk/src/schema.graphql (Query.issues, Query.teams, Mutation.issueCreate)
+ * More providers come from custom definitions (PUT /v1/connection_actions/{provider}/{name}).
+ */
+const str = (description, extra = {}) => ({ type: 'string', description, ...extra });
+const obj = (properties, required = []) => ({ type: 'object', properties, required });
+const GH = 'https://api.github.com';
+const GH_H = { accept: 'application/vnd.github+json' };
+const SLACK = 'https://slack.com/api';
+const SLACK_OK = { ok_field: 'ok', error_field: 'error' };
+const HUB = 'https://api.hubapi.com';
+const RAW = [
+    ['github', 'list_issues', {
+            description: 'List the issues of a repository.',
+            input: obj({ owner: str('Repository owner.'), repo: str('Repository name.'), state: str('open, closed or all.', { enum: ['open', 'closed', 'all'] }), per_page: { type: 'integer', minimum: 1, maximum: 100 }, page: { type: 'integer', minimum: 1 } }, ['owner', 'repo']),
+            request: { method: 'GET', base_url: GH, path: '/repos/{owner}/{repo}/issues', query: { state: '{state}', per_page: '{per_page}', page: '{page}' }, headers: GH_H },
+            scopes: [], mutating: false,
+        }],
+    ['github', 'get_issue', {
+            description: 'Read one issue.',
+            input: obj({ owner: str('Repository owner.'), repo: str('Repository name.'), issue_number: { type: 'integer', minimum: 1 } }, ['owner', 'repo', 'issue_number']),
+            request: { method: 'GET', base_url: GH, path: '/repos/{owner}/{repo}/issues/{issue_number}', headers: GH_H },
+            mutating: false,
+        }],
+    ['github', 'create_issue', {
+            description: 'Open an issue in a repository.',
+            input: obj({ owner: str('Repository owner.'), repo: str('Repository name.'), title: str('Issue title.', { minLength: 1 }), body: str('Issue body.'), labels: { type: 'array', items: { type: 'string' } }, assignees: { type: 'array', items: { type: 'string' } } }, ['owner', 'repo', 'title']),
+            request: { method: 'POST', base_url: GH, path: '/repos/{owner}/{repo}/issues', body: { title: '{title}', body: '{body}', labels: '{labels}', assignees: '{assignees}' }, headers: GH_H },
+            mutating: true,
+        }],
+    ['slack_api', 'post_message', {
+            description: 'Post a message to a channel or conversation.',
+            input: obj({ channel: str('Channel id or name.'), text: str('Message text.', { minLength: 1 }), thread_ts: str('Reply in this thread.') }, ['channel', 'text']),
+            request: { method: 'POST', base_url: SLACK, path: '/chat.postMessage', body: { channel: '{channel}', text: '{text}', thread_ts: '{thread_ts}' }, headers: { 'content-type': 'application/json; charset=utf-8' } },
+            response: SLACK_OK, mutating: true,
+        }],
+    ['slack_api', 'list_channels', {
+            description: 'List channels the token can see.',
+            input: obj({ types: str('Comma-separated: public_channel, private_channel, mpim, im.'), limit: { type: 'integer', minimum: 1, maximum: 999 }, cursor: str('The next_cursor of a previous call.'), exclude_archived: { type: 'boolean' } }),
+            request: { method: 'GET', base_url: SLACK, path: '/conversations.list', query: { types: '{types}', limit: '{limit}', cursor: '{cursor}', exclude_archived: '{exclude_archived}' } },
+            response: SLACK_OK, mutating: false,
+        }],
+    ['slack_api', 'list_messages', {
+            description: 'Read the message history of a conversation, newest first.',
+            input: obj({ channel: str('Conversation id.'), limit: { type: 'integer', minimum: 1, maximum: 999 }, cursor: str('The next_cursor of a previous call.'), oldest: str('Only messages after this Unix timestamp.'), latest: str('Only messages before this Unix timestamp.') }, ['channel']),
+            request: { method: 'GET', base_url: SLACK, path: '/conversations.history', query: { channel: '{channel}', limit: '{limit}', cursor: '{cursor}', oldest: '{oldest}', latest: '{latest}' } },
+            response: SLACK_OK, paginate: { type: 'cursor', cursor_path: 'response_metadata.next_cursor', cursor_param: 'cursor', items_path: 'messages' }, mutating: false,
+        }],
+    ['slack_api', 'list_users', {
+            description: 'List the workspace\'s users.',
+            input: obj({ limit: { type: 'integer', minimum: 1, maximum: 999 }, cursor: str('The next_cursor of a previous call.') }),
+            request: { method: 'GET', base_url: SLACK, path: '/users.list', query: { limit: '{limit}', cursor: '{cursor}' } },
+            response: SLACK_OK, paginate: { type: 'cursor', cursor_path: 'response_metadata.next_cursor', cursor_param: 'cursor', items_path: 'members' }, mutating: false,
+        }],
+    ['google', 'list_gmail_messages', {
+            description: 'List message ids of the signed-in user\'s mailbox (use get_gmail_message for content).',
+            input: obj({ q: str('Gmail search query.'), maxResults: { type: 'integer', minimum: 1, maximum: 500 }, pageToken: str('nextPageToken of a previous call.'), includeSpamTrash: { type: 'boolean' } }),
+            request: { method: 'GET', base_url: 'https://gmail.googleapis.com', path: '/gmail/v1/users/me/messages', query: { q: '{q}', maxResults: '{maxResults}', pageToken: '{pageToken}', includeSpamTrash: '{includeSpamTrash}' } },
+            paginate: { type: 'cursor', cursor_path: 'nextPageToken', cursor_param: 'pageToken', items_path: 'messages' }, mutating: false,
+        }],
+    ['google', 'get_gmail_message', {
+            description: 'Read one Gmail message.',
+            input: obj({ id: str('Message id.'), format: str('minimal, full, raw or metadata.', { enum: ['minimal', 'full', 'raw', 'metadata'] }) }, ['id']),
+            request: { method: 'GET', base_url: 'https://gmail.googleapis.com', path: '/gmail/v1/users/me/messages/{id}', query: { format: '{format}' } },
+            mutating: false,
+        }],
+    ['google', 'list_calendar_events', {
+            description: 'List events of a calendar.',
+            input: obj({ calendar_id: str('Calendar id; "primary" for the signed-in user.'), timeMin: str('RFC3339 lower bound for an event\'s end.'), timeMax: str('RFC3339 exclusive upper bound for an event\'s start.'), maxResults: { type: 'integer', minimum: 1, maximum: 2500 }, pageToken: str('nextPageToken of a previous call.'), singleEvents: { type: 'boolean' }, orderBy: str('startTime (needs singleEvents) or updated.', { enum: ['startTime', 'updated'] }), q: str('Free-text search.') }, ['calendar_id']),
+            request: { method: 'GET', base_url: 'https://www.googleapis.com', path: '/calendar/v3/calendars/{calendar_id}/events', query: { timeMin: '{timeMin}', timeMax: '{timeMax}', maxResults: '{maxResults}', pageToken: '{pageToken}', singleEvents: '{singleEvents}', orderBy: '{orderBy}', q: '{q}' } },
+            paginate: { type: 'cursor', cursor_path: 'nextPageToken', cursor_param: 'pageToken', items_path: 'items' }, mutating: false,
+        }],
+    ['linear', 'list_issues', {
+            description: 'List issues (newest first by default). Pass `after` from pageInfo.endCursor for the next page.',
+            input: obj({ first: { type: 'integer', minimum: 1, maximum: 250 }, after: str('pageInfo.endCursor of a previous call.') }),
+            request: { method: 'POST', base_url: 'https://api.linear.app', path: '/graphql', body: { query: 'query($first: Int, $after: String) { issues(first: $first, after: $after) { nodes { id identifier title url state { name } } pageInfo { hasNextPage endCursor } } }', variables: { first: '{first}', after: '{after}' } } },
+            response: { path: 'data.issues' }, mutating: false,
+        }],
+    ['linear', 'list_teams', {
+            description: 'List teams.',
+            input: obj({ first: { type: 'integer', minimum: 1, maximum: 250 }, after: str('pageInfo.endCursor of a previous call.') }),
+            request: { method: 'POST', base_url: 'https://api.linear.app', path: '/graphql', body: { query: 'query($first: Int, $after: String) { teams(first: $first, after: $after) { nodes { id key name } pageInfo { hasNextPage endCursor } } }', variables: { first: '{first}', after: '{after}' } } },
+            response: { path: 'data.teams' }, mutating: false,
+        }],
+    ['linear', 'create_issue', {
+            description: 'Create an issue in a team. Linear reports failures in an `errors` array with HTTP 200, so check the result.',
+            input: obj({ teamId: str('Team id (see list_teams).'), title: str('Issue title.', { minLength: 1 }), description: str('Markdown description.') }, ['teamId', 'title']),
+            request: { method: 'POST', base_url: 'https://api.linear.app', path: '/graphql', body: { query: 'mutation($teamId: String!, $title: String, $description: String) { issueCreate(input: { teamId: $teamId, title: $title, description: $description }) { success issue { id identifier title url } } }', variables: { teamId: '{teamId}', title: '{title}', description: '{description}' } } },
+            response: { path: 'data.issueCreate' }, mutating: true,
+        }],
+    ['notion', 'create_page', {
+            description: 'Create a page under a page or a data source.',
+            input: obj({ parent: { type: 'object', description: 'One of { page_id } or { data_source_id }.' }, properties: { type: 'object', description: 'Property values keyed by name.' }, children: { type: 'array', maxItems: 100, items: { type: 'object' } } }, ['parent', 'properties']),
+            request: { method: 'POST', base_url: 'https://api.notion.com', path: '/v1/pages', body: { parent: '{parent}', properties: '{properties}', children: '{children}' }, headers: { 'notion-version': '2026-03-11' } },
+            mutating: true,
+        }],
+    ['hubspot', 'create_contact', {
+            description: 'Create a CRM contact.',
+            input: obj({ email: str('Email address.'), firstname: str('First name.'), lastname: str('Last name.') }, ['email']),
+            request: { method: 'POST', base_url: HUB, path: '/crm/v3/objects/contacts', body: { properties: { email: '{email}', firstname: '{firstname}', lastname: '{lastname}' } } },
+            mutating: true,
+        }],
+    ['hubspot', 'list_contacts', {
+            description: 'List CRM contacts (cursor `after` from the previous page).',
+            input: obj({ limit: { type: 'integer', minimum: 1, maximum: 100 }, after: str('Cursor from paging.next.after.'), properties: str('Comma-separated property names to return.') }),
+            request: { method: 'GET', base_url: HUB, path: '/crm/v3/objects/contacts', query: { limit: '{limit}', after: '{after}', properties: '{properties}' } },
+            paginate: { type: 'cursor', cursor_path: 'paging.next.after', cursor_param: 'after', items_path: 'results' }, mutating: false,
+        }],
+    ['google', 'create_calendar_event', {
+            description: 'Create a calendar event.',
+            input: obj({ calendar_id: str('Calendar id; "primary" for the signed-in user.'), summary: str('Event title.'), start: { type: 'object', description: '{ dateTime, timeZone } or { date }.' }, end: { type: 'object', description: '{ dateTime, timeZone } or { date }.' }, description: str('Event description.') }, ['calendar_id', 'start', 'end']),
+            request: { method: 'POST', base_url: 'https://www.googleapis.com', path: '/calendar/v3/calendars/{calendar_id}/events', body: { summary: '{summary}', description: '{description}', start: '{start}', end: '{end}' } },
+            scopes: [], mutating: true,
+        }],
+    ['google', 'send_gmail_message', {
+            description: 'Send an email from the signed-in user. `raw` is the RFC 2822 message, base64url-encoded.',
+            input: obj({ raw: str('Base64url RFC 2822 message.', { minLength: 1 }) }, ['raw']),
+            request: { method: 'POST', base_url: 'https://gmail.googleapis.com', path: '/gmail/v1/users/me/messages/send', body: { raw: '{raw}' } },
+            mutating: true,
+        }],
+];
+exports.BUILT_IN_ACTIONS = [
+    // The original packs gain their declared outputs from catalog-extra; the newer packs carry their own.
+    ...RAW.map(([p, n, d]) => (0, emu4_actions_def_1.parseActionDef)(p, n, { ...d, ...(emu4_actions_catalog_extra_1.BUILT_IN_OUTPUTS[`${p}/${n}`] ? { output: emu4_actions_catalog_extra_1.BUILT_IN_OUTPUTS[`${p}/${n}`] } : {}) })),
+    ...emu4_actions_catalog_extra_1.EXTRA_ACTIONS.map(([p, n, d]) => (0, emu4_actions_def_1.parseActionDef)(p, n, d)),
+];
+const builtInFor = (provider) => exports.BUILT_IN_ACTIONS.filter((a) => a.provider === provider);
+exports.builtInFor = builtInFor;
+//# sourceMappingURL=emu4-actions-catalog.js.map

package/dist/handlers/emu4-actions-catalog.js.map

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

package/dist/handlers/emu4-actions-def.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Declarative actions over a connection: a typed input, a request template and a response mapping. No code runs;
+ * the request goes out through the connection relay (host allow-list, credential, refresh-once, audit).
+ */
+export interface ActionDef {
+    provider: string;
+    name: string;
+    description: string;
+    /** JSON Schema (object) of the input. Checked before anything is sent. */
+    input: Record<string, unknown>;
+    /**
+     * JSON Schema of what the action returns (after `response.path`). Published so callers get types, and checked against
+     * every successful answer: a mismatch is a provider change (the radar records it) and never fails the call.
+     */
+    output?: Record<string, unknown>;
+    request: {
+        method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        /** https base, e.g. https://api.github.com. Must be a host of the connection's allowed_hosts. */
+        base_url: string;
+        /** `/repos/{owner}/{repo}/issues`: `{arg}` is replaced by the percent-encoded input value. */
+        path: string;
+        /** Query parameters; a value that is exactly `{arg}` is dropped when the input omits it. */
+        query?: Record<string, string>;
+        /** JSON body template: a string that is exactly `{arg}` becomes the input value (omitted when absent). */
+        body?: unknown;
+        headers?: Record<string, string>;
+    };
+    response?: {
+        /** Dot path to the part of the JSON answer to return. */
+        path?: string;
+        /** Providers that answer 200 with `{ok:false}` (Slack): the field to check and the one holding the error. */
+        ok_field?: string;
+        error_field?: string;
+    };
+    /** Provider scopes the connection must hold; checked before the call when the connection's granted scopes are known. */
+    scopes?: string[];
+    /** Cursor pagination hint passed to the relay's paginate when the caller asks for `all_pages`. */
+    paginate?: Record<string, unknown>;
+    /** True for actions that change data: surfaced as the MCP destructive hint. */
+    mutating: boolean;
+}
+export declare function parseActionDef(provider: string, name: string, raw: unknown): ActionDef;
+export declare function validateInput(schema: Record<string, unknown>, value: unknown, path?: string): string | null;
+export declare function buildActionRequest(def: ActionDef, input: Record<string, unknown>): {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: unknown;
+};
+export declare const pick: (v: unknown, path: string | undefined) => unknown;

package/dist/handlers/emu4-actions-def.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pick = void 0;
+exports.parseActionDef = parseActionDef;
+exports.validateInput = validateInput;
+exports.buildActionRequest = buildActionRequest;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const errors_1 = require("../errors");
+const ApiError = { validation: (message, param) => new errors_1.EmulatorError('VALIDATION_FAILED', message, param) };
+const NAME = /^[a-z][a-z0-9_]{0,63}$/;
+const PROVIDER = /^[a-z0-9][a-z0-9_.-]{0,63}$/;
+const TEMPLATE_ARG = /\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+const MAX_BODY_DEPTH = 8;
+const obj = (v, where) => {
+    if (typeof v !== 'object' || v === null || Array.isArray(v))
+        throw ApiError.validation(`${where} must be an object.`, 'definition');
+    return v;
+};
+function parseActionDef(provider, name, raw) {
+    if (!PROVIDER.test(provider))
+        throw ApiError.validation('provider must be a short lowercase key.', 'provider');
+    if (!NAME.test(name))
+        throw ApiError.validation('name must be lowercase letters, digits and underscores.', 'name');
+    const o = obj(raw, 'The definition');
+    if (typeof o.description !== 'string' || !o.description.trim() || o.description.length > 500)
+        throw ApiError.validation('description is required (up to 500 characters).', 'definition');
+    const input = o.input === undefined ? { type: 'object', properties: {} } : obj(o.input, 'input');
+    if (input.type !== 'object')
+        throw ApiError.validation('input must be a JSON Schema of type object.', 'definition');
+    if (JSON.stringify(input).length > 20_000)
+        throw ApiError.validation('input schema is too large.', 'definition');
+    let output;
+    if (o.output !== undefined) {
+        output = obj(o.output, 'output');
+        if (JSON.stringify(output).length > 20_000)
+            throw ApiError.validation('output schema is too large.', 'definition');
+        if (output.type !== undefined && !(typeof output.type === 'string' || (Array.isArray(output.type) && output.type.every((t) => typeof t === 'string'))))
+            throw ApiError.validation('output.type must be a JSON Schema type.', 'definition');
+    }
+    const r = obj(o.request, 'request');
+    const method = String(r.method ?? '').toUpperCase();
+    if (!['GET', 'POST', 'PUT', 'PATCH', 'DELETE'].includes(method))
+        throw ApiError.validation('request.method must be GET, POST, PUT, PATCH or DELETE.', 'definition');
+    let base;
+    try {
+        base = new URL(String(r.base_url));
+    }
+    catch {
+        throw ApiError.validation('request.base_url must be an https URL.', 'definition');
+    }
+    if (base.protocol !== 'https:' || base.username || base.password || base.search || base.hash)
+        throw ApiError.validation('request.base_url must be a plain https URL.', 'definition');
+    if (typeof r.path !== 'string' || !r.path.startsWith('/') || r.path.includes('..') || r.path.length > 500 || /[?#\s]/.test(r.path))
+        throw ApiError.validation('request.path must start with / and hold no query, fragment or "..".', 'definition');
+    const props = (input.properties ?? {});
+    const used = new Set();
+    for (const m of r.path.matchAll(TEMPLATE_ARG))
+        used.add(m[1]);
+    const query = r.query === undefined ? undefined : obj(r.query, 'request.query');
+    for (const [k, v] of Object.entries(query ?? {})) {
+        if (typeof v !== 'string' || !/^[A-Za-z0-9_.\-[\]]{1,64}$/.test(k))
+            throw ApiError.validation('request.query maps names to string templates.', 'definition');
+        for (const m of v.matchAll(TEMPLATE_ARG))
+            used.add(m[1]);
+    }
+    const walk = (v, depth) => {
+        if (depth > MAX_BODY_DEPTH)
+            throw ApiError.validation('request.body is nested too deeply.', 'definition');
+        if (typeof v === 'string')
+            for (const m of v.matchAll(TEMPLATE_ARG))
+                used.add(m[1]);
+        else if (Array.isArray(v))
+            v.forEach((x) => walk(x, depth + 1));
+        else if (typeof v === 'object' && v !== null)
+            Object.values(v).forEach((x) => walk(x, depth + 1));
+    };
+    walk(r.body, 0);
+    const headers = r.headers === undefined ? undefined : obj(r.headers, 'request.headers');
+    for (const [k, v] of Object.entries(headers ?? {})) {
+        if (typeof v !== 'string' || !/^[A-Za-z0-9-]{1,64}$/.test(k) || /^(authorization|cookie|host|proxy-authorization|content-length|x-api-key)$/i.test(k) || /[\r\n]/.test(v))
+            throw ApiError.validation('request.headers has a header Atlas sets itself or an invalid value.', 'definition');
+    }
+    for (const a of used)
+        if (!(a in props))
+            throw ApiError.validation(`The request uses {${a}}, which is not a property of input.`, 'definition');
+    for (const m of r.path.matchAll(TEMPLATE_ARG)) {
+        const req = (input.required ?? []);
+        if (!req.includes(m[1]))
+            throw ApiError.validation(`Path argument ${m[1]} must be in input.required.`, 'definition');
+    }
+    let response;
+    if (o.response !== undefined) {
+        const x = obj(o.response, 'response');
+        for (const k of ['path', 'ok_field', 'error_field'])
+            if (x[k] !== undefined && (typeof x[k] !== 'string' || !/^[A-Za-z0-9_$-]+(\.[A-Za-z0-9_$-]+){0,5}$/.test(x[k])))
+                throw ApiError.validation(`response.${k} must be a dot path.`, 'definition');
+        response = x;
+    }
+    const scopes = o.scopes === undefined ? undefined : o.scopes;
+    if (scopes !== undefined && (!Array.isArray(scopes) || scopes.length > 30 || scopes.some((s) => typeof s !== 'string' || s.length > 300)))
+        throw ApiError.validation('scopes must be a list of provider scopes.', 'definition');
+    return {
+        provider, name, description: o.description.trim(), input, ...(output ? { output } : {}),
+        request: { method: method, base_url: base.origin + (base.pathname === '/' ? '' : base.pathname.replace(/\/$/, '')), path: r.path, query, body: r.body, headers },
+        response, scopes: scopes,
+        paginate: o.paginate === undefined ? undefined : obj(o.paginate, 'paginate'),
+        mutating: typeof o.mutating === 'boolean' ? o.mutating : method !== 'GET',
+    };
+}
+// ---- input validation (the subset of JSON Schema inputs use) --------------------------
+function validateInput(schema, value, path = 'input') {
+    let type = schema.type;
+    // A nullable type (`['string', 'null']`): null passes, anything else is checked against the one real type.
+    if (Array.isArray(type)) {
+        if (value === null && type.includes('null'))
+            return null;
+        const real = type.filter((t) => t !== 'null');
+        type = real.length === 1 ? real[0] : undefined;
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.some((e) => JSON.stringify(e) === JSON.stringify(value)))
+        return `${path} must be one of ${JSON.stringify(schema.enum)}.`;
+    switch (type) {
+        case 'object': {
+            if (typeof value !== 'object' || value === null || Array.isArray(value))
+                return `${path} must be an object.`;
+            const v = value;
+            const props = (schema.properties ?? {});
+            for (const r of (schema.required ?? []))
+                if (v[r] === undefined || v[r] === null)
+                    return `${path}.${r} is required.`;
+            for (const [k, x] of Object.entries(v)) {
+                if (x === undefined)
+                    continue;
+                if (!props[k]) {
+                    if (schema.additionalProperties === false)
+                        return `${path}.${k} is not allowed.`;
+                    continue;
+                }
+                const e = validateInput(props[k], x, `${path}.${k}`);
+                if (e)
+                    return e;
+            }
+            return null;
+        }
+        case 'array': {
+            if (!Array.isArray(value))
+                return `${path} must be an array.`;
+            if (typeof schema.maxItems === 'number' && value.length > schema.maxItems)
+                return `${path} has too many items.`;
+            const item = schema.items;
+            if (item)
+                for (let i = 0; i < value.length; i++) {
+                    const e = validateInput(item, value[i], `${path}[${i}]`);
+                    if (e)
+                        return e;
+                }
+            return null;
+        }
+        case 'string':
+            if (typeof value !== 'string')
+                return `${path} must be a string.`;
+            if (typeof schema.maxLength === 'number' && value.length > schema.maxLength)
+                return `${path} is too long.`;
+            if (typeof schema.minLength === 'number' && value.length < schema.minLength)
+                return `${path} is too short.`;
+            return null;
+        case 'integer':
+        case 'number':
+            if (typeof value !== 'number' || !Number.isFinite(value) || (type === 'integer' && !Number.isInteger(value)))
+                return `${path} must be ${type === 'integer' ? 'an integer' : 'a number'}.`;
+            if (typeof schema.minimum === 'number' && value < schema.minimum)
+                return `${path} is below the minimum.`;
+            if (typeof schema.maximum === 'number' && value > schema.maximum)
+                return `${path} is above the maximum.`;
+            return null;
+        case 'boolean':
+            return typeof value === 'boolean' ? null : `${path} must be true or false.`;
+        default:
+            return null;
+    }
+}
+// ---- request building -------------------------------------------------------------------
+const WHOLE = /^\{([A-Za-z_][A-Za-z0-9_]*)\}$/;
+const interpolate = (s, input, encode) => s.replace(TEMPLATE_ARG, (_, a) => {
+    const v = input[a];
+    const str = v === undefined || v === null ? '' : typeof v === 'object' ? JSON.stringify(v) : String(v);
+    return encode ? encodeURIComponent(str) : str;
+});
+const fill = (t, input) => {
+    if (typeof t === 'string') {
+        const m = WHOLE.exec(t);
+        if (m)
+            return input[m[1]];
+        return interpolate(t, input, false);
+    }
+    if (Array.isArray(t))
+        return t.map((x) => fill(x, input)).filter((x) => x !== undefined);
+    if (typeof t === 'object' && t !== null) {
+        const out = {};
+        for (const [k, v] of Object.entries(t)) {
+            const x = fill(v, input);
+            if (x !== undefined)
+                out[k] = x;
+        }
+        return out;
+    }
+    return t;
+};
+function buildActionRequest(def, input) {
+    const path = def.request.path.replace(TEMPLATE_ARG, (_, a) => {
+        const v = input[a];
+        if (v === undefined || v === null || v === '')
+            throw ApiError.validation(`${a} is required.`, 'input');
+        // A dot segment would climb out of the templated path once the URL is normalised.
+        if (String(v) === '.' || String(v) === '..')
+            throw ApiError.validation(`${a} is not a valid value.`, 'input');
+        return encodeURIComponent(String(v));
+    });
+    const qs = new URLSearchParams();
+    for (const [k, t] of Object.entries(def.request.query ?? {})) {
+        const m = WHOLE.exec(t);
+        if (m) {
+            const v = input[m[1]];
+            if (v === undefined || v === null)
+                continue;
+            if (Array.isArray(v))
+                qs.set(k, v.join(','));
+            else
+                qs.set(k, String(v));
+        }
+        else
+            qs.set(k, interpolate(t, input, false));
+    }
+    const q = qs.toString();
+    const body = def.request.body === undefined ? undefined : fill(def.request.body, input);
+    return { method: def.request.method, url: `${def.request.base_url}${path}${q ? `?${q}` : ''}`, headers: { accept: 'application/json', ...(def.request.headers ?? {}) }, ...(body !== undefined ? { body } : {}) };
+}
+const pick = (v, path) => {
+    if (!path)
+        return v;
+    let cur = v;
+    for (const k of path.split('.')) {
+        if (typeof cur !== 'object' || cur === null)
+            return undefined;
+        cur = cur[k];
+    }
+    return cur;
+};
+exports.pick = pick;
+//# sourceMappingURL=emu4-actions-def.js.map

package/dist/handlers/emu4-actions-def.js.map

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

package/dist/handlers/emu4-actions-sandbox.d.ts

@@ -0,0 +1,36 @@
+import type { Engine } from '../engine';
+import type { Obj } from '../openapi';
+import { Table } from '../store';
+export interface ActionRunResult {
+    accessTokenClaims: Obj;
+    idTokenClaims: Obj;
+    appMetadata: Obj;
+    sessionData: Obj;
+    denied: boolean;
+    denyReason: string | null;
+    lockReason: string | null;
+    pauseReason: string | null;
+    suppressedAccessClaims: string[];
+    suppressedIdClaims: string[];
+    userEdits: Obj;
+    signUpPrefill: Obj;
+    signUpModify: Obj;
+    httpRequests: Obj[];
+    connectorCalls: Obj[];
+    logs: string[];
+    error: string | null;
+}
+/** Timeout of one Action run, in CPU milliseconds (the real service allows 2 s; the emulator keeps a test suite fast). */
+export declare const ACTION_TIMEOUT_MS = 100;
+/** True when the emulator can run Action code (Node 22+); false in a browser, where the declarative reader is used. */
+export declare const sandboxAvailable: () => boolean;
+/** Code written as a handler module (`exports.onExecute...`, `module.exports`) is not the runtime's form: the caller reads it declaratively. */
+export declare const isRuntimeForm: (code: string) => boolean;
+/**
+ * Run one Action's code. Never throws: a syntax error, a thrown exception, a timeout or a promise that never settles comes back
+ * as `error` (the caller fails closed or open by trigger, as the real flow does). Returns null when the code is not in the
+ * runtime's form or vm is not available, so the caller can read it declaratively instead.
+ */
+export declare function runActionCode(event: Obj, code: string): ActionRunResult | null;
+/** One row per Action run (what the emulator saw: outcome, deny reason, logs, the requests `api.http` queued), read at `/__emulator/actions/runs`. */
+export declare const actionRuns: (e: Engine) => Table<import("../store").Row>;