@north-light/api 0.3.479 → 0.3.481

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.479",
+  "version": "0.3.481",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",

package/dist/api/__tests__/contract.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/api/__tests__/contract.test.js

@@ -1,44 +0,0 @@
-import assert from 'node:assert/strict';
-import { test } from 'node:test';
-import { CONTRACT_LEVEL, contractRefusal, contractSatisfies, parseContractLevel, parseServedContracts } from '../contract.js';
-test('CONTRACT_LEVEL is MAJOR.MINOR with MAJOR equal to the API_VERSION number', async () => {
-    const { API_VERSION } = await import('../routes.js');
-    assert.deepEqual(parseContractLevel(CONTRACT_LEVEL)?.major, Number(API_VERSION.replace(/^v/, '')));
-});
-test('parseContractLevel accepts only MAJOR.MINOR', () => {
-    assert.deepEqual(parseContractLevel('1.3'), { major: 1, minor: 3 });
-    assert.deepEqual(parseContractLevel(' 12.0 '), { major: 12, minor: 0 });
-    for (const bad of ['1', '1.2.3', 'v1.2', '1.x', '', '-1.0', '1.-2'])
-        assert.equal(parseContractLevel(bad), null, bad);
-});
-test('the rule: same major, served minor at or above the required one, compared numerically', () => {
-    assert.equal(contractSatisfies('1.3', '1.3'), true);
-    assert.equal(contractSatisfies('1.3', '1.10'), true);
-    assert.equal(contractSatisfies('1.10', '1.3'), false);
-    assert.equal(contractSatisfies('1.0', '1.0'), true);
-    assert.equal(contractSatisfies('1.3', '2.9'), false);
-    assert.equal(contractSatisfies('2.0', '1.9'), false);
-    assert.equal(contractSatisfies('1.3', '2.0, 1.4'), true);
-    assert.equal(contractSatisfies('1.3', '2.0, 1.2'), false);
-    assert.equal(contractSatisfies('1.3', null), false);
-    assert.equal(contractSatisfies('1.3', ''), false);
-    assert.equal(contractSatisfies('1.3', 'garbage'), false);
-    assert.equal(contractSatisfies('garbage', '1.3'), false);
-});
-test('a malformed served entry is dropped without hiding the rest', () => {
-    assert.deepEqual(parseServedContracts('x, 1.2 ,3'), [{ major: 1, minor: 2 }]);
-    assert.deepEqual(parseServedContracts(null), []);
-});
-test('contractRefusal: absent passes, malformed is 400, unsatisfied is 426 with both levels', () => {
-    assert.equal(contractRefusal(undefined, '1.0'), null);
-    assert.equal(contractRefusal('1.0', '1.0'), null);
-    const bad = contractRefusal('latest', '1.0');
-    assert.equal(bad?.status, 400);
-    assert.equal(bad?.status === 400 ? bad.param : '', 'Crouter-Required-Contract');
-    const refused = contractRefusal('1.4', '1.3', { legacyMinimum: '0.3.500', runtimeVersion: '0.3.600' });
-    assert.equal(refused?.status, 426);
-    assert.equal(refused?.code, 'runtime_version_unsupported');
-    assert.deepEqual(refused?.status === 426 ? refused.details : null, { sdk_version: '0.3.500', runtime_version: '0.3.600', required_contract: '1.4', runtime_contract: '1.3' });
-    const unnamed = contractRefusal('1.0', null);
-    assert.equal(unnamed?.status === 426 ? unnamed.details.runtime_contract : 'x', null);
-});

package/dist/api/__tests__/error-codes.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/api/__tests__/error-codes.test.js

@@ -1,79 +0,0 @@
-import assert from 'node:assert/strict';
-import { test } from 'node:test';
-import { readdirSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import ts from 'typescript';
-import { errorCodes } from '../error-codes.js';
-test('SDK and API expose one fixed code table with contract 2 tuples', () => {
-    assert.deepEqual(errorCodes.server_error, { type: 'server_error', status: 500, retryable: true });
-    assert.deepEqual(errorCodes.runtime_starting, { type: 'server_error', status: 503, retryable: true });
-    assert.deepEqual(errorCodes.payer_not_app, { type: 'permission_error', status: 403, retryable: false });
-    assert.deepEqual(errorCodes.cap_exhausted, { type: 'rate_limit_error', status: 402, retryable: false });
-    assert.deepEqual(errorCodes.concurrency_limit, { type: 'rate_limit_error', status: 429, retryable: true });
-    for (const code of ['grant_revoked', 'grant_removed', 'grant_suspended', 'refresh_token_expired', 'refresh_token_reused']) {
-        assert.deepEqual(errorCodes[code], { type: 'authentication_error', status: 401, retryable: false }, code);
-    }
-    assert.deepEqual(errorCodes.provider_setup_pending, { type: 'permission_error', status: 403, retryable: false });
-    assert.equal('provider_error' in errorCodes, false); // provider's 4xx status varies
-    assert.equal('usage' in errorCodes, false); // legacy socket-only code
-    assert.equal('stream_gap' in errorCodes, false); // stream protocol, not a fixed HTTP row
-});
-test('every statically named RunError and ProviderError agrees with the fixed table', () => {
-    const src = fileURLToPath(new URL('../..', import.meta.url));
-    const files = (dir) => readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
-        const path = join(dir, entry.name);
-        return entry.isDirectory() ? files(path) : entry.name.endsWith('.ts') && !path.includes('/__tests__/') ? [path] : [];
-    });
-    const literals = (expr) => {
-        if (ts.isStringLiteral(expr) || ts.isNumericLiteral(expr))
-            return [ts.isNumericLiteral(expr) ? Number(expr.text) : expr.text];
-        if (ts.isConditionalExpression(expr))
-            return [...literals(expr.whenTrue), ...literals(expr.whenFalse)];
-        return [];
-    };
-    let checked = 0;
-    for (const path of files(src)) {
-        const source = ts.createSourceFile(path, readFileSync(path, 'utf8'), ts.ScriptTarget.Latest, true);
-        const visit = (node) => {
-            if (ts.isNewExpression(node) && ts.isIdentifier(node.expression) && ['RunError', 'ProviderError'].includes(node.expression.text)) {
-                const args = node.arguments ?? [];
-                const run = node.expression.text === 'RunError';
-                const codes = args[run ? 1 : 0] ? literals(args[run ? 1 : 0]) : [];
-                const statuses = run && args[0] ? literals(args[0]) : [];
-                const options = !run && args[2] && ts.isObjectLiteralExpression(args[2]) ? args[2] : undefined;
-                const override = options?.properties.find((prop) => ts.isPropertyAssignment(prop) && prop.name.getText(source) === 'status');
-                const providerStatuses = override && ts.isPropertyAssignment(override) ? literals(override.initializer) : [];
-                for (const code of codes) {
-                    if (typeof code !== 'string' || ['provider_error', 'usage', 'stream_gap', 'stream_dropped', 'stream_error'].includes(code))
-                        continue;
-                    const row = errorCodes[code];
-                    assert.ok(row, `${path}:${source.getLineAndCharacterOfPosition(node.pos).line + 1}: ${code} missing from errorCodes`);
-                    for (const status of run ? statuses : providerStatuses)
-                        assert.equal(status, row.status, `${path}: ${code} status`);
-                    if (run && args[6] && args[6].kind !== ts.SyntaxKind.UndefinedKeyword && args[6].kind !== ts.SyntaxKind.NullKeyword) {
-                        const retry = args[6].kind === ts.SyntaxKind.TrueKeyword ? true : args[6].kind === ts.SyntaxKind.FalseKeyword ? false : undefined;
-                        if (retry !== undefined)
-                            assert.equal(retry, row.retryable, `${path}: ${code} retryable`);
-                    }
-                    else if (run && statuses.length) {
-                        for (const status of statuses)
-                            assert.equal(status === 503, row.retryable, `${path}: ${code} default retryable`);
-                    }
-                    checked++;
-                }
-            }
-            ts.forEachChild(node, visit);
-        };
-        visit(source);
-    }
-    assert.ok(checked > 100, `checked only ${checked} throw sites`);
-});
-test('app origin belongs to the full HTTP envelope without a body status', () => {
-    const row = errorCodes.invalid_request;
-    const body = { error: { code: 'invalid_request', message: 'Missing prompt',
-            type: row.type, origin: 'app', retryable: row.retryable, request_id: 'request-1', param: 'prompt' } };
-    assert.equal(body.error.origin, 'app');
-    assert.equal('status' in body.error, false);
-    assert.equal(row.status, 400);
-});