@volter/twin-standard 1.0.156 → 1.0.158

package/dist/src/clients/vercel.js

@@ -0,0 +1,73 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+// Vercel's unchanged REST SDK and Dub's Edge Config client, using the enclosing World's routing.
+import { standardPackageFile } from "../package-file.js";
+const { importSdk } = await import(__rewriteRelativeImportExtension(new URL('import.mjs', standardPackageFile('client-sdks/')).href));
+const { Vercel } = await importSdk('@vercel/sdk');
+const { VercelError } = await importSdk('@vercel/sdk/models/vercelerror.js');
+const { createClient } = await importSdk('@vercel/edge-config');
+const PROJECTS = 'https://unpkg.com/@vercel/sdk@1.28.38/esm/sdk/projects.js';
+const EDGE = 'https://unpkg.com/@vercel/edge-config@0.4.1/dist/index.d.ts';
+export const cases = [
+    {
+        id: 'project-domain-add-and-read',
+        asks: 'the issued project token adds a domain, and an independent SDK read preserves its name, project and verification state',
+        source: `${PROJECTS} "Add a domain to the project by passing its domain name"; ${PROJECTS} "Get project domain by project id/name and domain name."`,
+        async run(c) {
+            const vercel = new Vercel({ bearerToken: c.env.VERCEL_API_KEY });
+            const project = c.env.VERCEL_PROJECT_ID;
+            const name = 'sdk-client.example.test';
+            const added = await vercel.projects.addProjectDomain({ idOrName: project, requestBody: { name } });
+            const got = await vercel.projects.getProjectDomain({ idOrName: project, domain: name });
+            const wanted = { name, apexName: 'example.test', projectId: project, verified: true };
+            return Object.entries(wanted).flatMap(([field, value]) => added[field] === value && got[field] === value ? [] : [`project domain ${field} did not survive SDK create/read`]);
+        },
+    },
+    {
+        id: 'invalid-project-token',
+        asks: 'an invalid token cannot read the project domain and the SDK preserves the HTTP refusal status',
+        source: `${PROJECTS} "Get project domain by project id/name and domain name."; https://unpkg.com/@vercel/sdk@1.28.38/esm/models/vercelerror.js "HTTP status code"`,
+        async run(c) {
+            const vercel = new Vercel({ bearerToken: 'throwaway-invalid-token' });
+            try {
+                await vercel.projects.getProjectDomain({ idOrName: c.env.VERCEL_PROJECT_ID, domain: 'sdk-client.example.test' });
+                return ['an invalid token read the project domain'];
+            }
+            catch (error) {
+                return error instanceof Error && error instanceof VercelError && 'statusCode' in error && error.statusCode === 403
+                    ? [] : [`invalid token refusal differs: ${String(error)}`];
+            }
+        },
+    },
+    {
+        id: 'edge-config-get-and-selected-get-all',
+        asks: 'the issued Edge Config connection string reads a stored value and only the selected keys through the unchanged SDK',
+        source: `${EDGE} "Read a single value."; ${EDGE} "Returns all entries when called with no arguments or only entries matching the given keys otherwise."`,
+        async run(c) {
+            const domains = ['phish-bank.example.test'];
+            const terms = ['gift-card'];
+            const written = await c.fetch(`https://api.vercel.com/v1/edge-config/${c.env.EDGE_CONFIG_ID}/items`, {
+                method: 'PATCH', headers: { authorization: `Bearer ${c.env.VERCEL_API_KEY}`, 'content-type': 'application/json' },
+                body: JSON.stringify({ items: [
+                        { operation: 'upsert', key: 'sdk_domains', value: domains },
+                        { operation: 'upsert', key: 'sdk_terms', value: terms },
+                        { operation: 'upsert', key: 'sdk_unselected', value: true },
+                    ] }),
+            });
+            if (!written.ok || (await written.json()).status !== 'ok')
+                return ['the Edge Config items were not written through the vendor API'];
+            const edge = createClient(c.env.EDGE_CONFIG);
+            const value = await edge.get('sdk_domains');
+            const selected = await edge.getAll(['sdk_domains', 'sdk_terms']);
+            return JSON.stringify(value) === JSON.stringify(domains) && JSON.stringify(selected.sdk_domains) === JSON.stringify(domains)
+                && JSON.stringify(selected.sdk_terms) === JSON.stringify(terms) && Object.keys(selected).length === 2
+                ? [] : ['Edge Config get/getAll did not preserve the stored values and selected keys'];
+        },
+    },
+];

package/dist/src/conformance.js

@@ -611,8 +611,8 @@ async function lifeServed(pack) {
             }, server.managedDatabaseUrl ? { managedDatabaseUrl: server.managedDatabaseUrl } : {}),
             // a socket opened as an application opens it: a WebSocket to the served port, the vendor's host in its Host header
             socket: (url, headers) => new WebSocket(`ws://127.0.0.1:${port}${url}`, { headers }),
-            // a line connection opened as an application's client opens it: TCP to the protocol listener (the primary port)
-            stream: lineConnection(server.port),
+            // TCP to the native wire: a separate listener beside HTTP, or the primary protocol port.
+            stream: lineConnection(server.wirePort ?? server.port),
             // bounded: Bun's server.stop(true) never settles once a WebSocket peer has closed under it (discord's life, Bun
             // 1.3.11: the walk ended and the stop spun at full CPU for 45 minutes), so the check waits 5 s and goes on
             stop: async () => { await within(5000, Promise.resolve(server.stop())); },

package/dist/src/walk/serve-pack.d.ts

@@ -1,6 +1,7 @@
 export type ServedPack = {
     port: number;
     inspectPort?: number;
+    wirePort?: number;
     stop: () => void | Promise<void>;
     managedDatabaseUrl?: () => Promise<string>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.156",
+  "version": "1.0.158",
   "description": "The Protocol 3 standard for Volter twin packs: the criteria a pack is graded by, the grader, the gate a pack repository and the twin catalog run on every change and submission, and the spec derivation the grade checks against. Pin a version: every place a pack is judged judges by that standard.",
   "keywords": [
     "twin",
@@ -20,6 +20,7 @@
     "README.md",
     "LICENSE",
     "client-sdks/package.json",
+    "client-sdks/import.mjs",
     "client-sdks/pnpm-lock.yaml",
     "!**/*.test.ts",
     "client-sdks/pnpm-workspace.yaml",

package/src/cli.ts

@@ -78,7 +78,7 @@ if (command === '--version') {
   });
 } else if (command === 'create') {
   if (args.includes('--init') && !args.includes('--package')) throw new Error('Name your scoped package with --package');
-  await (await import('./create-pack.ts')).createPack(args);
+  await (await import('./create-pack.js')).createPack(args);
 } else if (command === 'prepare-consumer') {
   if (!args[0]) usage();
   const value = (name: string) => { const at = args.indexOf(name); if (at < 0 || !args[at + 1]) usage(); return args[at + 1]!; };
@@ -88,7 +88,7 @@ if (command === '--version') {
   if (!/^sha512-[A-Za-z0-9+/]{86}==$/.test(artifactIntegrity)) throw new Error('Consumer preparation requires candidate SHA-512 integrity');
   const out = resolve(value('--out'));
   if (existsSync(out)) throw new Error('Prepared consumer output already exists');
-  const { prepareConsumerApp } = await import('./consumer.ts');
+  const { prepareConsumerApp } = await import('./consumer.js');
   const candidateAt = args.indexOf('--candidate');
   const artifact = candidateAt >= 0 ? resolve(value('--candidate')) : undefined;
   const fixture = prepareConsumerApp(resolve(args[0]!), appDir, { cli, artifact });
@@ -102,7 +102,7 @@ if (command === '--version') {
   const outputAt = args.indexOf('--out');
   if (outputAt >= 0 && !args[outputAt + 1]) usage();
   const consumer = JSON.parse(readFileSync(resolve(args[at + 1]!), 'utf8'));
-  const { runConsumerWorkflow } = await import('./consumer.ts');
+  const { runConsumerWorkflow } = await import('./consumer.js');
   const report = await runConsumerWorkflow(resolve(args[0]!), consumer);
   const text = `${JSON.stringify(report, null, 2)}\n`;
   if (outputAt >= 0) {
@@ -112,7 +112,7 @@ if (command === '--version') {
   process.exit(report.passed ? 0 : 1);
 } else if (command === 'assess') {
   if (!args[0]) usage();
-  const { assessPack } = await import('./assessment.ts');
+  const { assessPack } = await import('./assessment.js');
   const consumerAt = args.indexOf('--prepared-consumer');
   if (consumerAt >= 0 && !args[consumerAt + 1]) usage();
   const consumer = consumerAt >= 0 ? JSON.parse(readFileSync(resolve(args[consumerAt + 1]!), 'utf8')) : undefined;
@@ -126,7 +126,7 @@ if (command === '--version') {
   process.exit(report.ready ? 0 : 1);
 } else if (command === 'facts') {
   if (!args[0]) usage();
-  const { compilePackFacts, renderPackFacts } = await import('./pack-facts.ts');
+  const { compilePackFacts, renderPackFacts } = await import('./pack-facts.js');
   const { mkdirSync, writeFileSync } = await import('node:fs');
   const { join, dirname } = await import('node:path');
   const dir = resolve(args[0]!);
@@ -145,19 +145,19 @@ if (command === '--version') {
   if (!args[0] || args[0].startsWith('-')) usage();
   const tool = { walk: 'score-pack', examples: 'vendor-examples', coverage: 'life-coverage', 'judge-brief': 'judge-brief' }[command];
   process.argv = [process.argv[0]!, process.argv[1]!, ...args];
-  await import((await import('./tools/packs-root.ts')).toolPath(tool));
+  await import((await import('./tools/packs-root.js')).toolPath(tool));
 } else if (command === 'derive') {
   if (!args[0]) usage();
   // the derivation is a script over process.argv: it reads the unit from its first argument
   process.argv = [process.argv[0]!, process.argv[1]!, ...args];
-  await import('./derive.ts');
+  await import('./derive.js');
 } else if (command === 'check-sources') {
   if (!args[0]) usage();
-  await (await import('./check-sources.ts')).checkSources(args);
+  await (await import('./check-sources.js')).checkSources(args);
 } else if (command === 'read-page') {
   // a documentation page's text, read as the citation check reads it: where an author finds the vendor's examples and words
   if (!args[0]) usage();
-  const { status, readable, raw, error } = await (await import('./check-sources.ts')).readPage(args[0]);
+  const { status, readable, raw, error } = await (await import('./check-sources.js')).readPage(args[0]);
   if (status !== 200) { console.error(`read-page: ${args[0]} answered ${status || 'nothing'}${error ? `: ${error}` : ''}`); process.exit(1); }
   // --raw: the page's own bytes, as fetched (a spec writer reads its tables, which the readable text drops)
   if (args.includes('--raw')) process.stdout.write(raw); else console.log(readable);
@@ -169,8 +169,8 @@ if (command === '--version') {
   // `.tgz` the tarball `npm pack` makes of one, the bytes a publish would send
   const published = target.endsWith('.tgz') || (!existsSync(target) && /^@?[^@]+@[^@]+$/.test(target));
   const results = published
-    ? await (await import('./published.ts')).conformPublished(target, at >= 0 ? { registry: args[at + 1]! } : {})
-    : await (await import('./conformance.ts')).conformance(target, { onCheck: (id) => console.error(`  … ${id} (${new Date().toISOString().slice(11, 19)})`) });
+    ? await (await import('./published.js')).conformPublished(target, at >= 0 ? { registry: args[at + 1]! } : {})
+    : await (await import('./conformance.js')).conformance(target, { onCheck: (id) => console.error(`  … ${id} (${new Date().toISOString().slice(11, 19)})`) });
   for (const r of results) {
     console.log(`${r.failures.length ? '✗' : '✓'} ${r.id.padEnd(15)} ${r.asks}${r.note ? `  (${r.note})` : ''}`);
     for (const f of r.failures) console.log(`    ${f}`);

package/src/clients/tinybird.ts

@@ -1,11 +1,14 @@
 // Tinybird's official API wrapper, unmodified, with the World credential and routed fetch.
 // The pinned package names Forward; its decoupled API wrapper uses the Classic /v0 APIs.
 import type { ClientCase, ClientContext } from './harness.ts';
+import { standardPackageFile } from '../package-file.ts';
+
+const { importSdk } = await import(new URL('import.mjs', standardPackageFile('client-sdks/')).href);
+const { createTinybirdApi, TinybirdApiError }: typeof import('@tinybirdco/sdk/api') = await importSdk('@tinybirdco/sdk/api');
 
 const SDK = 'https://unpkg.com/@tinybirdco/sdk@0.0.84/src/api/api.ts';
 
-async function client(c: ClientContext, fetch: typeof globalThis.fetch = c.fetch) {
-  const { createTinybirdApi } = await import('@tinybirdco/sdk/api');
+function client(c: ClientContext, fetch: typeof globalThis.fetch = c.fetch) {
   return createTinybirdApi({ baseUrl: `https://${c.host}`, token: c.env.TINYBIRD_API_KEY ?? c.env.TINYBIRD_TOKEN ?? '', fetch });
 }
 
@@ -15,8 +18,7 @@ export const cases: ClientCase[] = [
     asks: 'a request token override is used instead of the Workspace token, and its refusal retains the status and JSON error in TinybirdApiError',
     source: `${SDK} "Error thrown by TinybirdApi when a response is not OK"`,
     async run(c) {
-      const { TinybirdApiError } = await import('@tinybirdco/sdk/api');
-      const api = await client(c);
+      const api = client(c);
       try {
         await api.ingest('client_case_events', { label: 'refused' }, { token: 'throwaway-invalid-token' });
         return ['the invalid request token was accepted'];
@@ -37,7 +39,7 @@ export const cases: ClientCase[] = [
     async run(c) {
       let calls = 0;
       const routed = ((input: RequestInfo | URL, init?: RequestInit) => { calls++; return c.fetch(input, init); }) as typeof fetch;
-      const api = await client(c, routed);
+      const api = client(c, routed);
       try {
         await api.ingest('client_case_events', { timestamp: new Date('2024-01-15T10:30:00Z') });
         return ['a Date object was accepted for ingestion'];
@@ -58,7 +60,7 @@ export const cases: ClientCase[] = [
     asks: 'an object query parameter becomes JSON and the Endpoint uses its value rather than the object string representation',
     source: `${SDK} "Plain objects (e.g. p.json() params) become JSON strings; Dates are rejected;"`,
     async run(c) {
-      const api = await client(c);
+      const api = client(c);
       await api.requestJson('/v0/datasources', { method: 'POST', headers: { 'content-type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ name: 'client_json_rows', schema: 'name String' }).toString() });
       await api.ingestBatch('client_json_rows', [{ name: 'selected' }, { name: 'excluded' }], { wait: true });
       await api.requestJson('/v0/pipes', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ name: 'client_json_filter', nodes: [{ name: 'endpoint', type: 'endpoint', sql: "%\nSELECT name FROM client_json_rows WHERE name = {{JSON(filters, '{\"name\":\"selected\"}').get('name')}}" }] }) });

package/src/clients/vercel.ts

@@ -0,0 +1,67 @@
+// Vercel's unchanged REST SDK and Dub's Edge Config client, using the enclosing World's routing.
+import { standardPackageFile } from '../package-file.ts';
+import type { ClientCase } from './harness.ts';
+
+const { importSdk } = await import(new URL('import.mjs', standardPackageFile('client-sdks/')).href);
+const { Vercel } = await importSdk('@vercel/sdk');
+const { VercelError } = await importSdk('@vercel/sdk/models/vercelerror.js');
+const { createClient } = await importSdk('@vercel/edge-config');
+const PROJECTS = 'https://unpkg.com/@vercel/sdk@1.28.38/esm/sdk/projects.js';
+const EDGE = 'https://unpkg.com/@vercel/edge-config@0.4.1/dist/index.d.ts';
+
+export const cases: ClientCase[] = [
+  {
+    id: 'project-domain-add-and-read',
+    asks: 'the issued project token adds a domain, and an independent SDK read preserves its name, project and verification state',
+    source: `${PROJECTS} "Add a domain to the project by passing its domain name"; ${PROJECTS} "Get project domain by project id/name and domain name."`,
+    async run(c) {
+      const vercel = new Vercel({ bearerToken: c.env.VERCEL_API_KEY });
+      const project = c.env.VERCEL_PROJECT_ID;
+      const name = 'sdk-client.example.test';
+      const added = await vercel.projects.addProjectDomain({ idOrName: project, requestBody: { name } });
+      const got = await vercel.projects.getProjectDomain({ idOrName: project, domain: name });
+      const wanted = { name, apexName: 'example.test', projectId: project, verified: true };
+      return Object.entries(wanted).flatMap(([field, value]) =>
+        added[field] === value && got[field] === value ? [] : [`project domain ${field} did not survive SDK create/read`]);
+    },
+  },
+  {
+    id: 'invalid-project-token',
+    asks: 'an invalid token cannot read the project domain and the SDK preserves the HTTP refusal status',
+    source: `${PROJECTS} "Get project domain by project id/name and domain name."; https://unpkg.com/@vercel/sdk@1.28.38/esm/models/vercelerror.js "HTTP status code"`,
+    async run(c) {
+      const vercel = new Vercel({ bearerToken: 'throwaway-invalid-token' });
+      try {
+        await vercel.projects.getProjectDomain({ idOrName: c.env.VERCEL_PROJECT_ID, domain: 'sdk-client.example.test' });
+        return ['an invalid token read the project domain'];
+      } catch (error) {
+        return error instanceof Error && error instanceof VercelError && 'statusCode' in error && error.statusCode === 403
+          ? [] : [`invalid token refusal differs: ${String(error)}`];
+      }
+    },
+  },
+  {
+    id: 'edge-config-get-and-selected-get-all',
+    asks: 'the issued Edge Config connection string reads a stored value and only the selected keys through the unchanged SDK',
+    source: `${EDGE} "Read a single value."; ${EDGE} "Returns all entries when called with no arguments or only entries matching the given keys otherwise."`,
+    async run(c) {
+      const domains = ['phish-bank.example.test'];
+      const terms = ['gift-card'];
+      const written = await c.fetch(`https://api.vercel.com/v1/edge-config/${c.env.EDGE_CONFIG_ID}/items`, {
+        method: 'PATCH', headers: { authorization: `Bearer ${c.env.VERCEL_API_KEY}`, 'content-type': 'application/json' },
+        body: JSON.stringify({ items: [
+          { operation: 'upsert', key: 'sdk_domains', value: domains },
+          { operation: 'upsert', key: 'sdk_terms', value: terms },
+          { operation: 'upsert', key: 'sdk_unselected', value: true },
+        ] }),
+      });
+      if (!written.ok || (await written.json() as { status?: string }).status !== 'ok') return ['the Edge Config items were not written through the vendor API'];
+      const edge = createClient(c.env.EDGE_CONFIG);
+      const value = await edge.get('sdk_domains');
+      const selected = await edge.getAll(['sdk_domains', 'sdk_terms']);
+      return JSON.stringify(value) === JSON.stringify(domains) && JSON.stringify(selected.sdk_domains) === JSON.stringify(domains)
+        && JSON.stringify(selected.sdk_terms) === JSON.stringify(terms) && Object.keys(selected).length === 2
+        ? [] : ['Edge Config get/getAll did not preserve the stored values and selected keys'];
+    },
+  },
+];

package/src/conformance.ts

@@ -499,8 +499,8 @@ async function lifeServed(pack: string): Promise<string[]> {
       }, server.managedDatabaseUrl ? { managedDatabaseUrl: server.managedDatabaseUrl } : {}),
       // a socket opened as an application opens it: a WebSocket to the served port, the vendor's host in its Host header
       socket: (url: string, headers: Record<string, string>) => new WebSocket(`ws://127.0.0.1:${port}${url}`, { headers } as unknown as string[]),
-      // a line connection opened as an application's client opens it: TCP to the protocol listener (the primary port)
-      stream: lineConnection(server.port),
+      // TCP to the native wire: a separate listener beside HTTP, or the primary protocol port.
+      stream: lineConnection(server.wirePort ?? server.port),
       // bounded: Bun's server.stop(true) never settles once a WebSocket peer has closed under it (discord's life, Bun
       // 1.3.11: the walk ended and the stop spun at full CPU for 45 minutes), so the check waits 5 s and goes on
       stop: async () => { await within(5000, Promise.resolve(server.stop())); },

package/src/walk/serve-pack.ts

@@ -6,6 +6,7 @@ import { startTwinDatabase, type TwinDatabase } from './walk-database.ts';
 export type ServedPack = {
   port: number;
   inspectPort?: number;
+  wirePort?: number;
   stop: () => void | Promise<void>;
   managedDatabaseUrl?: () => Promise<string>;
 };