@prestack/thread 0.1.2 → 0.1.4

package/dist/integrity/slopnators/sl_unkept_rows.js

@@ -1,104 +0,0 @@
-import { existsSync, readdirSync, readFileSync } from "../../core/files.js";
-import { resolve } from 'node:path';
-const STORES = 'src/stores';
-/* What hands an operation its seams, seeded once and then the app's own. */
-const SEAMS = 'src/seams.ts';
-/* What the declarations settle, which the seams file is expected to hand on. */
-const DECLARED = 'DECLARED';
-/*
- * WHAT THIS READS, AND WHY IT READS THAT RATHER THAN THE TARGETS SHEET.
- *
- * A target that keeps entities derives a store of its own, written by `thread schema` into
- * `src/stores/<target>.ts`. So one of those files existing IS the fact that this app declares
- * somewhere to keep rows — already resolved, by the command that resolved it, with no second reading
- * of what a reach can hold and no chance of the two disagreeing about it.
- *
- * Where rows go is settled in `src/_generated/seams.ts`, which `thread capabilities` writes from those
- * stores and refuses when it drifts. The one place it can still go wrong is `src/seams.ts`, which is
- * the app's own: an app that stops handing on what was settled there hands its operations a store
- * that keeps nothing, while the tables are written, the migrations are written, and the gate is green.
- */
-function held(root, at) {
-    const path = resolve(root, at);
-    try {
-        return existsSync(path) ? readFileSync(path, 'utf8') : '';
-    }
-    catch {
-        return '';
-    }
-}
-function derived(root) {
-    const at = resolve(root, STORES);
-    try {
-        return existsSync(at) ? readdirSync(at).filter((one) => one.endsWith('.ts')) : [];
-    }
-    catch {
-        return [];
-    }
-}
-export const slopnator = {
-    checks: (root) => {
-        const stores = derived(root);
-        if (stores.length === 0)
-            return [];
-        /*
-         * AN APP WITH NOTHING THAT HANDS A STORE TO AN OPERATION IS NOT KEEPING ROWS THROUGH ONE, SO
-         * THERE IS NOTHING TO REFUSE.
-         *
-         * The seams file is seeded by `thread capabilities`, which ships in the operations package — so
-         * an app that attached data and integrity and nothing else has no seams and no command that
-         * seeds one. Its absence means rows go nowhere yet, which is a state to pass rather than refuse:
-         * nothing is being lost, because nothing is being kept.
-         */
-        const where = held(root, SEAMS);
-        if (where === '')
-            return [];
-        if (where.includes(DECLARED))
-            return [];
-        return [
-            `${STORES} holds ${stores.join(', ')} and ${SEAMS} no longer hands on ${DECLARED}, so every row this app keeps goes ` +
-                'somewhere that is gone the moment it stops. The tables are written, the migrations are written, the gate is ' +
-                `green, and the database is never opened. Spread ${DECLARED} back into SEAMS, or name its store there`,
-        ];
-    },
-    proves: {
-        wrong: [
-            {
-                files: [
-                    { at: 'src/stores/pl_probe.ts', source: 'export const store = {}\n' },
-                    {
-                        at: 'src/seams.ts',
-                        source: "import { inMemorySeams } from '../../operations/memory.ts'\n\nexport const SEAMS = inMemorySeams().seams\n",
-                    },
-                ],
-                at: 'src/seams.ts',
-            },
-        ],
-        right: [
-            {
-                files: [
-                    { at: 'src/stores/pl_probe.ts', source: 'export const store = {}\n' },
-                    {
-                        at: 'src/seams.ts',
-                        source: "import { DECLARED } from './_generated/seams.ts'\n\nexport const SEAMS = { ...DECLARED }\n",
-                    },
-                ],
-                at: 'src/seams.ts',
-            },
-            /* An app that derived a store and has nothing handing one to an operation — data attached, operations not. */
-            {
-                files: [{ at: 'src/stores/pl_probe.ts', source: 'export const store = {}\n' }],
-                at: 'src/seams.ts',
-            },
-            {
-                files: [
-                    {
-                        at: 'src/seams.ts',
-                        source: "import { inMemorySeams } from '../../operations/memory.ts'\n\nexport const SEAMS = inMemorySeams().seams\n",
-                    },
-                ],
-                at: 'src/seams.ts',
-            },
-        ],
-    },
-};

package/dist/integrity/slopnators/sl_unkept_rows.ts

@@ -1,111 +0,0 @@
-import { existsSync, readdirSync, readFileSync } from '../../core/files.ts'
-import { resolve } from 'node:path'
-
-import type { Slopnator } from '../slopnator.ts'
-
-const STORES = 'src/stores'
-
-/* What hands an operation its seams, seeded once and then the app's own. */
-const SEAMS = 'src/seams.ts'
-
-/* What the declarations settle, which the seams file is expected to hand on. */
-const DECLARED = 'DECLARED'
-
-/*
- * WHAT THIS READS, AND WHY IT READS THAT RATHER THAN THE TARGETS SHEET.
- *
- * A target that keeps entities derives a store of its own, written by `thread schema` into
- * `src/stores/<target>.ts`. So one of those files existing IS the fact that this app declares
- * somewhere to keep rows — already resolved, by the command that resolved it, with no second reading
- * of what a reach can hold and no chance of the two disagreeing about it.
- *
- * Where rows go is settled in `src/_generated/seams.ts`, which `thread capabilities` writes from those
- * stores and refuses when it drifts. The one place it can still go wrong is `src/seams.ts`, which is
- * the app's own: an app that stops handing on what was settled there hands its operations a store
- * that keeps nothing, while the tables are written, the migrations are written, and the gate is green.
- */
-function held(root: string, at: string): string {
-  const path = resolve(root, at)
-  try {
-    return existsSync(path) ? readFileSync(path, 'utf8') : ''
-  } catch {
-    return ''
-  }
-}
-
-function derived(root: string): readonly string[] {
-  const at = resolve(root, STORES)
-  try {
-    return existsSync(at) ? readdirSync(at).filter((one) => one.endsWith('.ts')) : []
-  } catch {
-    return []
-  }
-}
-
-export const slopnator: Slopnator = {
-  checks: (root) => {
-    const stores = derived(root)
-    if (stores.length === 0) return []
-
-    /*
-     * AN APP WITH NOTHING THAT HANDS A STORE TO AN OPERATION IS NOT KEEPING ROWS THROUGH ONE, SO
-     * THERE IS NOTHING TO REFUSE.
-     *
-     * The seams file is seeded by `thread capabilities`, which ships in the operations package — so
-     * an app that attached data and integrity and nothing else has no seams and no command that
-     * seeds one. Its absence means rows go nowhere yet, which is a state to pass rather than refuse:
-     * nothing is being lost, because nothing is being kept.
-     */
-    const where = held(root, SEAMS)
-    if (where === '') return []
-
-    if (where.includes(DECLARED)) return []
-
-    return [
-      `${STORES} holds ${stores.join(', ')} and ${SEAMS} no longer hands on ${DECLARED}, so every row this app keeps goes ` +
-        'somewhere that is gone the moment it stops. The tables are written, the migrations are written, the gate is ' +
-        `green, and the database is never opened. Spread ${DECLARED} back into SEAMS, or name its store there`,
-    ]
-  },
-  proves: {
-    wrong: [
-      {
-        files: [
-          { at: 'src/stores/pl_probe.ts', source: 'export const store = {}\n' },
-          {
-            at: 'src/seams.ts',
-            source: "import { inMemorySeams } from '../../operations/memory.ts'\n\nexport const SEAMS = inMemorySeams().seams\n",
-          },
-        ],
-        at: 'src/seams.ts',
-      },
-    ],
-    right: [
-      {
-        files: [
-          { at: 'src/stores/pl_probe.ts', source: 'export const store = {}\n' },
-          {
-            at: 'src/seams.ts',
-            source: "import { DECLARED } from './_generated/seams.ts'\n\nexport const SEAMS = { ...DECLARED }\n",
-          },
-        ],
-        at: 'src/seams.ts',
-      },
-
-      /* An app that derived a store and has nothing handing one to an operation — data attached, operations not. */
-      {
-        files: [{ at: 'src/stores/pl_probe.ts', source: 'export const store = {}\n' }],
-        at: 'src/seams.ts',
-      },
-      {
-        files: [
-          {
-            at: 'src/seams.ts',
-            source: "import { inMemorySeams } from '../../operations/memory.ts'\n\nexport const SEAMS = inMemorySeams().seams\n",
-          },
-        ],
-        at: 'src/seams.ts',
-      },
-    ],
-  },
-}

package/dist/integrity/slopnators/sl_unseamed_reach.js

@@ -1,73 +0,0 @@
-import { isBuiltin } from 'node:module';
-import { parser } from 'typescript-eslint';
-const CODE = /\.(?:ts|tsx|mts|cts|js|jsx|mjs|cjs)$/;
-const MENTIONS = /\bimport\b|\brequire\s*\(/;
-function reached(node, seen, found) {
-    if (typeof node !== 'object' || node === null)
-        return;
-    if (seen.has(node))
-        return;
-    seen.add(node);
-    if (Array.isArray(node)) {
-        for (const each of node)
-            reached(each, seen, found);
-        return;
-    }
-    const one = node;
-    const type = one['type'];
-    if (type === 'ImportDeclaration' || type === 'ImportExpression' || type === 'ExportNamedDeclaration' || type === 'ExportAllDeclaration') {
-        const source = one['source'];
-        if (typeof source?.value === 'string')
-            found(source.value);
-    }
-    if (type === 'CallExpression') {
-        const callee = one['callee'];
-        if (callee?.type === 'Identifier' && callee.name === 'require') {
-            const first = one['arguments']?.[0];
-            if (typeof first?.value === 'string')
-                found(first.value);
-        }
-    }
-    for (const held of Object.values(one))
-        reached(held, seen, found);
-}
-export const slopnator = {
-    holds: (_node, at) => {
-        if (!CODE.test(at.filename))
-            return false;
-        const text = String(at.text);
-        if (!MENTIONS.test(text))
-            return false;
-        let ast;
-        try {
-            ast = parser.parseForESLint(text, {
-                range: true,
-                ecmaVersion: 'latest',
-                sourceType: 'module',
-                ecmaFeatures: { jsx: true },
-            }).ast;
-        }
-        catch {
-            return false;
-        }
-        const taken = new Set();
-        reached(ast, new WeakSet(), (one) => {
-            if (isBuiltin(one))
-                taken.add(one);
-        });
-        if (taken.size === 0)
-            return false;
-        return `this reaches ${[...taken].sort().join(', ')} straight from the runtime, and a node is handed everything it may touch`;
-    },
-    proves: {
-        wrong: [
-            "import { readFileSync } from 'node:fs'\nexport const node = readFileSync\n",
-            "const { spawn } = require('child_process')\nexport const node = spawn\n",
-            "export const node = async () => await import('node:net')\n",
-        ],
-        right: [
-            "import { nd_read } from '../../operations/nodes.ts'\nexport const node = nd_read(async (hands) => await hands.store.get('a', 'b'))\n",
-            "import type { In } from './input.ts'\nexport const node = null as unknown as In\n",
-        ],
-    },
-};

package/dist/integrity/slopnators/sl_unseamed_reach.ts

@@ -1,79 +0,0 @@
-import { isBuiltin } from 'node:module'
-
-import { parser } from 'typescript-eslint'
-
-import type { Slopnator } from '../slopnator.ts'
-
-const CODE = /\.(?:ts|tsx|mts|cts|js|jsx|mjs|cjs)$/
-
-const MENTIONS = /\bimport\b|\brequire\s*\(/
-
-function reached(node: unknown, seen: WeakSet<object>, found: (one: string) => void): void {
-  if (typeof node !== 'object' || node === null) return
-  if (seen.has(node)) return
-  seen.add(node)
-
-  if (Array.isArray(node)) {
-    for (const each of node) reached(each, seen, found)
-    return
-  }
-
-  const one = node as Record<string, unknown>
-  const type = one['type']
-
-  if (type === 'ImportDeclaration' || type === 'ImportExpression' || type === 'ExportNamedDeclaration' || type === 'ExportAllDeclaration') {
-    const source = one['source'] as { readonly value?: unknown } | null | undefined
-    if (typeof source?.value === 'string') found(source.value)
-  }
-
-  if (type === 'CallExpression') {
-    const callee = one['callee'] as { readonly type?: unknown; readonly name?: unknown } | null | undefined
-    if (callee?.type === 'Identifier' && callee.name === 'require') {
-      const first = (one['arguments'] as readonly { readonly value?: unknown }[] | undefined)?.[0]
-      if (typeof first?.value === 'string') found(first.value)
-    }
-  }
-
-  for (const held of Object.values(one)) reached(held, seen, found)
-}
-
-export const slopnator: Slopnator = {
-  holds: (_node, at) => {
-    if (!CODE.test(at.filename)) return false
-
-    const text = String(at.text)
-    if (!MENTIONS.test(text)) return false
-
-    let ast: unknown
-    try {
-      ast = (parser.parseForESLint as (text: string, options: unknown) => { readonly ast: unknown })(text, {
-        range: true,
-        ecmaVersion: 'latest',
-        sourceType: 'module',
-        ecmaFeatures: { jsx: true },
-      }).ast
-    } catch {
-      return false
-    }
-
-    const taken = new Set<string>()
-    reached(ast, new WeakSet<object>(), (one) => {
-      if (isBuiltin(one)) taken.add(one)
-    })
-
-    if (taken.size === 0) return false
-
-    return `this reaches ${[...taken].sort().join(', ')} straight from the runtime, and a node is handed everything it may touch`
-  },
-  proves: {
-    wrong: [
-      "import { readFileSync } from 'node:fs'\nexport const node = readFileSync\n",
-      "const { spawn } = require('child_process')\nexport const node = spawn\n",
-      "export const node = async () => await import('node:net')\n",
-    ],
-    right: [
-      "import { nd_read } from '../../operations/nodes.ts'\nexport const node = nd_read(async (hands) => await hands.store.get('a', 'b'))\n",
-      "import type { In } from './input.ts'\nexport const node = null as unknown as In\n",
-    ],
-  },
-}

package/dist/operations/cost.d.ts

@@ -1,14 +0,0 @@
-export interface CostAmount {
-    readonly usdMicroCents: number;
-    readonly chargedMicroCents: number;
-    readonly currency: string;
-    readonly meter: string;
-}
-export declare class InvalidCostError extends Error {
-    constructor(message: string);
-}
-export declare function assertValidCost(cost: CostAmount): void;
-export declare const MICRO_CENTS_PER_CENT = 1000000;
-export declare const MICRO_CENTS_PER_UNIT = 100000000;
-export declare function toMicroCents(amount: number): number;
-export declare function fromMicroCents(microCents: number): number;

package/dist/operations/cost.js

@@ -1,37 +0,0 @@
-export class InvalidCostError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'InvalidCostError';
-    }
-}
-function assertIntegerMicroCents(value, field) {
-    if (!Number.isFinite(value) || !Number.isInteger(value)) {
-        throw new InvalidCostError(`${field} must be an integer number of micro-cents, received ${value}. ` +
-            'Convert before recording — never round.');
-    }
-    if (value < 0)
-        throw new InvalidCostError(`${field} must not be negative, received ${value}`);
-}
-export function assertValidCost(cost) {
-    assertIntegerMicroCents(cost.usdMicroCents, 'usdMicroCents');
-    assertIntegerMicroCents(cost.chargedMicroCents, 'chargedMicroCents');
-    if (typeof cost.currency !== 'string' || cost.currency.trim() === '') {
-        throw new InvalidCostError('cost.currency is required and has no default — resolve it from real data (DATA.md §8)');
-    }
-    if (!/^[A-Z]{3}$/.test(cost.currency)) {
-        throw new InvalidCostError(`cost.currency must be an ISO-4217 code, received "${cost.currency}"`);
-    }
-    if (typeof cost.meter !== 'string' || cost.meter.trim() === '') {
-        throw new InvalidCostError('cost.meter is required — a cost with no meter cannot be quota-checked');
-    }
-}
-export const MICRO_CENTS_PER_CENT = 1_000_000;
-export const MICRO_CENTS_PER_UNIT = 100_000_000;
-export function toMicroCents(amount) {
-    if (!Number.isFinite(amount))
-        throw new InvalidCostError(`cannot convert ${amount} to micro-cents`);
-    return Math.round(amount * MICRO_CENTS_PER_UNIT);
-}
-export function fromMicroCents(microCents) {
-    return microCents / MICRO_CENTS_PER_UNIT;
-}

package/dist/operations/cost.ts

@@ -1,58 +0,0 @@
-export interface CostAmount {
-
-  readonly usdMicroCents: number
-
-  readonly chargedMicroCents: number
-
-  readonly currency: string
-
-  readonly meter: string
-}
-
-export class InvalidCostError extends Error {
-  constructor(message: string) {
-    super(message)
-    this.name = 'InvalidCostError'
-  }
-}
-
-function assertIntegerMicroCents(value: number, field: string): void {
-  if (!Number.isFinite(value) || !Number.isInteger(value)) {
-
-    throw new InvalidCostError(
-      `${field} must be an integer number of micro-cents, received ${value}. ` +
-        'Convert before recording — never round.',
-    )
-  }
-  if (value < 0) throw new InvalidCostError(`${field} must not be negative, received ${value}`)
-}
-
-export function assertValidCost(cost: CostAmount): void {
-  assertIntegerMicroCents(cost.usdMicroCents, 'usdMicroCents')
-  assertIntegerMicroCents(cost.chargedMicroCents, 'chargedMicroCents')
-
-  if (typeof cost.currency !== 'string' || cost.currency.trim() === '') {
-    throw new InvalidCostError(
-      'cost.currency is required and has no default — resolve it from real data (DATA.md §8)',
-    )
-  }
-  if (!/^[A-Z]{3}$/.test(cost.currency)) {
-    throw new InvalidCostError(`cost.currency must be an ISO-4217 code, received "${cost.currency}"`)
-  }
-  if (typeof cost.meter !== 'string' || cost.meter.trim() === '') {
-    throw new InvalidCostError('cost.meter is required — a cost with no meter cannot be quota-checked')
-  }
-}
-
-export const MICRO_CENTS_PER_CENT = 1_000_000
-
-export const MICRO_CENTS_PER_UNIT = 100_000_000
-
-export function toMicroCents(amount: number): number {
-  if (!Number.isFinite(amount)) throw new InvalidCostError(`cannot convert ${amount} to micro-cents`)
-  return Math.round(amount * MICRO_CENTS_PER_UNIT)
-}
-
-export function fromMicroCents(microCents: number): number {
-  return microCents / MICRO_CENTS_PER_UNIT
-}

package/dist/operations/errors/errors.d.ts

@@ -1,52 +0,0 @@
-export declare const AuthUnauthenticated: import("./catalog.ts").ErrorFactory<"auth.unauthenticated">;
-export declare const AuthInvalidCredentials: import("./catalog.ts").ErrorFactory<"auth.invalid_credentials">;
-export declare const AuthTokenExpired: import("./catalog.ts").ErrorFactory<"auth.token_expired">;
-export declare const AuthTokenReused: import("./catalog.ts").ErrorFactory<"auth.token_reused">;
-export declare const AuthSessionRevoked: import("./catalog.ts").ErrorFactory<"auth.session_revoked">;
-export declare const AuthDenied: import("./catalog.ts").ErrorFactory<"auth.denied">;
-export declare const QuotaExceeded: import("./catalog.ts").ErrorFactory<"quota.exceeded">;
-export declare const QuotaReservationExpired: import("./catalog.ts").ErrorFactory<"quota.reservation_expired">;
-export declare const RateLimitExceeded: import("./catalog.ts").ErrorFactory<"rate_limit.exceeded">;
-export declare const FeatureNotInPlan: import("./catalog.ts").ErrorFactory<"feature.not_in_plan">;
-export declare const DbNotFound: import("./catalog.ts").ErrorFactory<"db.not_found">;
-export declare const DbConstraintViolation: import("./catalog.ts").ErrorFactory<"db.constraint_violation">;
-export declare const DbAlreadyExists: import("./catalog.ts").ErrorFactory<"db.already_exists">;
-export declare const DbConflict: import("./catalog.ts").ErrorFactory<"db.conflict">;
-export declare const DbMigrationChecksumMismatch: import("./catalog.ts").ErrorFactory<"db.migration_checksum_mismatch">;
-export declare const DbDestructiveWithoutDryRun: import("./catalog.ts").ErrorFactory<"db.destructive_without_dry_run">;
-export declare const DbRoundTripBudgetExceeded: import("./catalog.ts").ErrorFactory<"db.round_trip_budget_exceeded">;
-export declare const DbCursorInvalid: import("./catalog.ts").ErrorFactory<"db.cursor_invalid">;
-export declare const DbCursorExpired: import("./catalog.ts").ErrorFactory<"db.cursor_expired">;
-export declare const WorkflowNodeFailed: import("./catalog.ts").ErrorFactory<"workflow.node_failed">;
-export declare const WorkflowInvalidTransition: import("./catalog.ts").ErrorFactory<"workflow.invalid_transition">;
-export declare const WorkflowCompensationFailed: import("./catalog.ts").ErrorFactory<"workflow.compensation_failed">;
-export declare const WorkflowAlreadyRunning: import("./catalog.ts").ErrorFactory<"workflow.already_running">;
-export declare const QueueJobFailed: import("./catalog.ts").ErrorFactory<"queue.job_failed">;
-export declare const QueueDlqExhausted: import("./catalog.ts").ErrorFactory<"queue.dlq_exhausted">;
-export declare const AiProviderUnavailable: import("./catalog.ts").ErrorFactory<"ai.provider_unavailable">;
-export declare const AiSchemaValidationFailed: import("./catalog.ts").ErrorFactory<"ai.schema_validation_failed">;
-export declare const AiToolNotInMask: import("./catalog.ts").ErrorFactory<"ai.tool_not_in_mask">;
-export declare const AiNodeCapExceeded: import("./catalog.ts").ErrorFactory<"ai.node_cap_exceeded">;
-export declare const SearchIndexFailed: import("./catalog.ts").ErrorFactory<"search.index_failed">;
-export declare const SearchQueryInvalid: import("./catalog.ts").ErrorFactory<"search.query_invalid">;
-export declare const CommsChannelKindUndeclared: import("./catalog.ts").ErrorFactory<"comms.channel_kind_undeclared">;
-export declare const CommsChannelKindUndescribed: import("./catalog.ts").ErrorFactory<"comms.channel_kind_undescribed">;
-export declare const CommsChannelKindUnlabelled: import("./catalog.ts").ErrorFactory<"comms.channel_kind_unlabelled">;
-export declare const CommsChannelKindUndocumented: import("./catalog.ts").ErrorFactory<"comms.channel_kind_undocumented">;
-export declare const CommsChannelKindDuplicate: import("./catalog.ts").ErrorFactory<"comms.channel_kind_duplicate">;
-export declare const ConfigInvalid: import("./catalog.ts").ErrorFactory<"config.invalid">;
-export declare const ConfigMissingEnv: import("./catalog.ts").ErrorFactory<"config.missing_env">;
-export declare const ConfigSecretInPublicVar: import("./catalog.ts").ErrorFactory<"config.secret_in_public_var">;
-export declare const ConfigCredentialInvalid: import("./catalog.ts").ErrorFactory<"config.credential_invalid">;
-export declare const ConfigScopeMissing: import("./catalog.ts").ErrorFactory<"config.scope_missing">;
-export declare const ConfigResourceNotFound: import("./catalog.ts").ErrorFactory<"config.resource_not_found">;
-export declare const ConfigDestinationIncompatible: import("./catalog.ts").ErrorFactory<"config.destination_incompatible">;
-export declare const ConfigBlocksExit: import("./catalog.ts").ErrorFactory<"config.blocks_exit">;
-export declare const NetTimeout: import("./catalog.ts").ErrorFactory<"net.timeout">;
-export declare const NetUpstreamUnavailable: import("./catalog.ts").ErrorFactory<"net.upstream_unavailable">;
-export declare const NetDestinationRefused: import("./catalog.ts").ErrorFactory<"net.destination_refused">;
-export declare const InternalUnexpected: import("./catalog.ts").ErrorFactory<"internal.unexpected">;
-export declare const InternalNotImplemented: import("./catalog.ts").ErrorFactory<"internal.not_implemented">;
-export declare const InternalInvalidArgument: import("./catalog.ts").ErrorFactory<"internal.invalid_argument">;
-export declare const PLATFORM_ERRORS: readonly [import("./catalog.ts").ErrorFactory<"auth.unauthenticated">, import("./catalog.ts").ErrorFactory<"auth.invalid_credentials">, import("./catalog.ts").ErrorFactory<"auth.token_expired">, import("./catalog.ts").ErrorFactory<"auth.token_reused">, import("./catalog.ts").ErrorFactory<"auth.session_revoked">, import("./catalog.ts").ErrorFactory<"auth.denied">, import("./catalog.ts").ErrorFactory<"quota.exceeded">, import("./catalog.ts").ErrorFactory<"quota.reservation_expired">, import("./catalog.ts").ErrorFactory<"rate_limit.exceeded">, import("./catalog.ts").ErrorFactory<"feature.not_in_plan">, import("./catalog.ts").ErrorFactory<"db.not_found">, import("./catalog.ts").ErrorFactory<"db.constraint_violation">, import("./catalog.ts").ErrorFactory<"db.already_exists">, import("./catalog.ts").ErrorFactory<"db.conflict">, import("./catalog.ts").ErrorFactory<"db.migration_checksum_mismatch">, import("./catalog.ts").ErrorFactory<"db.destructive_without_dry_run">, import("./catalog.ts").ErrorFactory<"db.round_trip_budget_exceeded">, import("./catalog.ts").ErrorFactory<"db.cursor_invalid">, import("./catalog.ts").ErrorFactory<"db.cursor_expired">, import("./catalog.ts").ErrorFactory<"workflow.node_failed">, import("./catalog.ts").ErrorFactory<"workflow.invalid_transition">, import("./catalog.ts").ErrorFactory<"workflow.compensation_failed">, import("./catalog.ts").ErrorFactory<"workflow.already_running">, import("./catalog.ts").ErrorFactory<"queue.job_failed">, import("./catalog.ts").ErrorFactory<"queue.dlq_exhausted">, import("./catalog.ts").ErrorFactory<"ai.provider_unavailable">, import("./catalog.ts").ErrorFactory<"ai.schema_validation_failed">, import("./catalog.ts").ErrorFactory<"ai.tool_not_in_mask">, import("./catalog.ts").ErrorFactory<"ai.node_cap_exceeded">, import("./catalog.ts").ErrorFactory<"search.index_failed">, import("./catalog.ts").ErrorFactory<"search.query_invalid">, import("./catalog.ts").ErrorFactory<"comms.channel_kind_undeclared">, import("./catalog.ts").ErrorFactory<"comms.channel_kind_undescribed">, import("./catalog.ts").ErrorFactory<"comms.channel_kind_unlabelled">, import("./catalog.ts").ErrorFactory<"comms.channel_kind_undocumented">, import("./catalog.ts").ErrorFactory<"comms.channel_kind_duplicate">, import("./catalog.ts").ErrorFactory<"config.invalid">, import("./catalog.ts").ErrorFactory<"config.missing_env">, import("./catalog.ts").ErrorFactory<"config.secret_in_public_var">, import("./catalog.ts").ErrorFactory<"config.credential_invalid">, import("./catalog.ts").ErrorFactory<"config.scope_missing">, import("./catalog.ts").ErrorFactory<"config.resource_not_found">, import("./catalog.ts").ErrorFactory<"config.destination_incompatible">, import("./catalog.ts").ErrorFactory<"config.blocks_exit">, import("./catalog.ts").ErrorFactory<"net.timeout">, import("./catalog.ts").ErrorFactory<"net.upstream_unavailable">, import("./catalog.ts").ErrorFactory<"net.destination_refused">, import("./catalog.ts").ErrorFactory<"internal.unexpected">, import("./catalog.ts").ErrorFactory<"internal.not_implemented">, import("./catalog.ts").ErrorFactory<"internal.invalid_argument">];
-export type PlatformErrorCode = (typeof PLATFORM_ERRORS)[number]['def']['code'];

package/dist/operations/http.js

@@ -1,124 +0,0 @@
-import { payloadBytes } from "./metering.js";
-import { ValidationError } from "./result.js";
-export const HTTP_CALL_ACTION = 'http.call';
-export class HttpNotConfiguredError extends Error {
-    constructor() {
-        super('no outward seam is configured. `http.call` needs `seams.http`, which is the transport an app ' +
-            'wires — which hosts it may reach is declared in its tree and is not this seam\'s business.');
-        this.name = 'HttpNotConfiguredError';
-    }
-}
-export class OutwardTransportError extends Error {
-    target;
-    constructor(target, cause) {
-        super(`outward call to "${target}" never reached it: ${cause instanceof Error ? cause.message : String(cause)}`);
-        this.target = target;
-        this.name = 'OutwardTransportError';
-    }
-}
-export function outwardUrl(target, address, path) {
-    let base;
-    try {
-        base = new URL(address);
-    }
-    catch {
-        throw new ValidationError(`the address resolved for "${target}" is not an absolute URL: ${JSON.stringify(address)}`);
-    }
-    if (base.protocol !== 'https:') {
-        throw new ValidationError(`outward calls go over https only, and "${target}" resolved to ${base.protocol.replace(':', '')}`);
-    }
-    if (base.search !== '' || base.hash !== '') {
-        throw new ValidationError(`the address for "${target}" carries a query or a fragment — those belong to the call`);
-    }
-    if (!path.startsWith('/')) {
-        throw new ValidationError(`an outward path starts with "/", and "${path}" does not`);
-    }
-    if (path.startsWith('//')) {
-        throw new ValidationError(`the path "${path}" is protocol-relative, which points at another host`);
-    }
-    const url = new URL(`${base.origin}${base.pathname.replace(/\/$/, '')}${path}`);
-    if (url.origin !== base.origin) {
-        throw new ValidationError(`the path "${path}" resolves to ${url.origin}, which is not where "${target}" is`);
-    }
-    return url;
-}
-function requestBytes(headers, body) {
-    return payloadBytes(headers) + (body === undefined ? 0 : body.byteLength);
-}
-function wireBody(body) {
-    const copy = new ArrayBuffer(body.byteLength);
-    new Uint8Array(copy).set(body);
-    return copy;
-}
-const DEFAULT_TIMEOUT_MS = 10_000;
-export function httpSeam(options = {}) {
-    const send = options.transport ?? fetch;
-    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    return {
-        async call(request) {
-            const url = outwardUrl(request.target, request.address, request.path);
-            const headers = { ...request.headers };
-            if (request.contentType !== undefined)
-                headers['content-type'] = request.contentType;
-            if (request.idempotencyKey !== undefined)
-                headers['idempotency-key'] = request.idempotencyKey;
-            const bytesSent = requestBytes(headers, request.body);
-            const startedAt = Date.now();
-            let response;
-            try {
-                response = await send(url.toString(), {
-                    method: request.method,
-                    headers,
-                    ...(request.body === undefined ? {} : { body: wireBody(request.body) }),
-                    signal: AbortSignal.timeout(timeoutMs),
-                });
-            }
-            catch (error) {
-                throw new OutwardTransportError(request.target, error);
-            }
-            const body = new Uint8Array(await response.arrayBuffer());
-            const responseHeaders = Object.fromEntries(response.headers.entries());
-            return {
-                status: response.status,
-                headers: responseHeaders,
-                body,
-                bytesSent,
-                bytesReceived: payloadBytes(responseHeaders) + body.byteLength,
-                durationMs: Date.now() - startedAt,
-            };
-        },
-    };
-}
-const REDACTED = '(sent)';
-export function recordingHttp(script = {}) {
-    const calls = [];
-    const decoder = new TextDecoder();
-    return {
-        calls,
-        async call(request) {
-            outwardUrl(request.target, request.address, request.path);
-            const body = request.body === undefined ? '' : decoder.decode(request.body);
-            calls.push({
-                target: request.target,
-                method: request.method,
-                path: request.path,
-                headers: Object.fromEntries(Object.keys(request.headers ?? {}).map((one) => [one, REDACTED])),
-                body,
-            });
-            const answer = script[`${request.method} ${request.path}`];
-            if (answer === undefined) {
-                throw new Error(`this scenario scripts no answer for "${request.method} ${request.path}", so nothing here knows what ${request.target} would say. Add that key to the scenario's answers — a call answered by something nobody scripted proves it was made and nothing about what came back.`);
-            }
-            const answered = new TextEncoder().encode(answer.body ?? '');
-            const headers = answer.headers ?? {};
-            return {
-                status: answer.status,
-                headers,
-                body: answered,
-                bytesSent: requestBytes({ ...request.headers }, request.body),
-                bytesReceived: payloadBytes(headers) + answered.byteLength,
-                durationMs: 0,
-            };
-        },
-    };
-}