@prestack/thread 0.1.3 → 0.1.5

package/dist/core/descend.d.ts

@@ -4,7 +4,7 @@ export declare const ROOT: string;
 export declare const TREE: string;
 export declare const THREAD_AT: string;
 export declare function unkept(at: string): boolean;
-export declare const LISTS: readonly ["declares", "derives", "seeds"];
+export declare const LISTS: readonly ['declares', 'derives', 'seeds'];
 export declare const ROW_LISTS: readonly ["declares", "derives", "seeds", "holds"];
 export interface Row {
     readonly at?: string;
@@ -59,6 +59,7 @@ export declare function shapeFields(named: string, inside?: string): readonly {
     readonly map: boolean;
     readonly worded: boolean;
     readonly guide: string;
+    readonly record: readonly string[];
 }[];
 export interface Field {
     readonly name: string;
@@ -68,9 +69,10 @@ export interface Field {
     readonly boolean: boolean;
     readonly worded: boolean;
     readonly guide: string;
+    readonly record: readonly string[];
 }
 export declare function listShape(at: string, list: string): string | undefined;
-export declare function listFields(at: string, list: string): readonly Field[];
+export declare function listFields(at: string, list: string, within?: number): readonly Field[];
 export declare function rowShape(at: string, list: string): string | undefined;
 interface Held {
     readonly name: string;

package/dist/core/descend.js

@@ -1,10 +1,10 @@
-import { spawnSync } from 'node:child_process';
-import { attached, existsSync, kind, readdirSync, readFileSync, realpathSync, statSync, writeFileSync } from "./files.js";
+import { starts } from '../integrations/cli.js';
+import { attached, beyond, existsSync, here as answering, kind, readdirSync, readFileSync, realpathSync, statSync, writeFileSync } from '../integrations/disk.js';
 import { dirname, join, relative, resolve } from 'node:path';
 import ts from 'typescript';
-import { ignored } from "./init.js";
-import { NAMED, ORGANISATION } from "./scope.js";
-import { findTree } from "./tree.js";
+import { SHAPED, ignored } from './init.js';
+import { ORGANISATION, installed } from './scope.js';
+import { findTree } from './tree.js';
 const BUILT = new Set(ignored()
     .split('\n')
     .map((one) => one.trim())
@@ -32,7 +32,7 @@ function ownIgnores() {
     if (readIgnores)
         return ignores;
     readIgnores = true;
-    if (!attached() && spawnSync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: ROOT, stdio: 'ignore' }).status === 0) {
+    if (!attached() && starts('git', ['rev-parse', '--is-inside-work-tree'], { at: ROOT }).ok) {
         return ignores;
     }
     try {
@@ -55,7 +55,7 @@ export function unkept(at) {
         return held;
     const own = ownIgnores();
     const found = own === undefined
-        ? spawnSync('git', ['check-ignore', '-q', '--', at], { cwd: ROOT, stdio: 'ignore' }).status === 0
+        ? starts('git', ['check-ignore', '-q', '--', at], { at: ROOT }).ok
         : own.some((one) => at === one || at.startsWith(`${one}/`) || at.split('/').includes(one));
     asked.set(at, found);
     return found;
@@ -198,7 +198,7 @@ function listing(at, take, skip, only, deep) {
 function parsing(from) {
     return {
         useCaseSensitiveFileNames: true,
-        fileExists: (at) => existsSync(at),
+        fileExists: (at) => !beyond(at) && existsSync(at),
         readFile: (at) => {
             try {
                 return readFileSync(at);
@@ -237,23 +237,34 @@ export function configured() {
     }
     return { options: { ...FALLBACK, ...INVARIANT }, from: '' };
 }
+const libraries = new Map();
+const DEPENDENCIES = '/node_' + 'modules/';
 export function hosting(options) {
     const host = ts.createCompilerHost(options, true);
     const lib = host.getDefaultLibLocation?.();
+    const settings = JSON.stringify(options);
     const toolchain = (at) => lib !== undefined && (at === lib || at.startsWith(`${lib}/`));
+    const seen = (at) => (beyond(at) ? 'none' : kind(at));
     return {
         ...host,
-        fileExists: (at) => (toolchain(at) ? host.fileExists(at) : kind(at) === 'file'),
-        directoryExists: (at) => (toolchain(at) ? (host.directoryExists?.(at) ?? false) : kind(at) === 'folder'),
-        readFile: (at) => (toolchain(at) ? host.readFile(at) : kind(at) === 'file' ? readFileSync(at) : undefined),
+        fileExists: (at) => (toolchain(at) ? host.fileExists(at) : seen(at) === 'file'),
+        directoryExists: (at) => (toolchain(at) ? (host.directoryExists?.(at) ?? false) : seen(at) === 'folder'),
+        readFile: (at) => (toolchain(at) ? host.readFile(at) : seen(at) === 'file' ? readFileSync(at) : undefined),
         getSourceFile: (at, version) => {
-            if (toolchain(at))
-                return host.getSourceFile(at, version);
-            if (kind(at) !== 'file')
-                return undefined;
-            return ts.createSourceFile(at, readFileSync(at), version, true);
+            const lasting = toolchain(at) ? true : at.includes(DEPENDENCIES);
+            const key = settings + at + JSON.stringify(version);
+            if (lasting && libraries.has(key))
+                return libraries.get(key);
+            const made = toolchain(at)
+                ? host.getSourceFile(at, version)
+                : seen(at) === 'file'
+                    ? ts.createSourceFile(at, readFileSync(at), version, true)
+                    : undefined;
+            if (lasting)
+                libraries.set(key, made);
+            return made;
         },
-        getDirectories: (at) => kind(at) === 'folder' ? readdirSync(at, { withFileTypes: true }).filter((one) => one.isDirectory()).map((one) => one.name) : [],
+        getDirectories: (at) => seen(at) === 'folder' ? readdirSync(at, { withFileTypes: true }).filter((one) => one.isDirectory()).map((one) => one.name) : [],
         realpath: (at) => (toolchain(at) ? (host.realpath?.(at) ?? at) : realpathSync(at)),
         writeFile: (at, said) => {
             writeFileSync(at, said);
@@ -328,8 +339,13 @@ export function read(at) {
     source.set(at, text);
     return text;
 }
+const shapes = new WeakMap();
 export function shapesNamed() {
-    const { program, checker } = compiled();
+    const held = compiled();
+    const known = shapes.get(held);
+    if (known !== undefined)
+        return known;
+    const { program, checker } = held;
     const shape = threadedType(checker, program);
     const found = new Map();
     if (shape === undefined)
@@ -368,6 +384,7 @@ export function shapesNamed() {
             found.set(named, [...where, at]);
         }
     }
+    shapes.set(held, found);
     return found;
 }
 export function threading() {
@@ -408,13 +425,14 @@ export function shapeFields(named, inside) {
                     map: mapped(kind),
                     worded: (kind.isUnion() ? kind.types : [kind]).some((each) => (each.flags & ts.TypeFlags.StringLike) !== 0),
                     guide: ts.displayPartsToString(one.getDocumentationComment(checker)).trim(),
+                    record: recordOf(checker, kind),
                 };
             });
         }
     }
     return [];
 }
-function elementAt(at, list) {
+function elementAt(at, list, within) {
     const { program, checker } = compiled();
     const file = program.getSourceFile(resolve(ROOT, at));
     if (file === undefined)
@@ -424,6 +442,8 @@ function elementAt(at, list) {
     const consider = (node) => {
         if (held !== undefined)
             return;
+        if (within !== undefined && node.getStart() !== within)
+            return;
         const wanted = checker.getContextualType(node) ?? checker.getTypeAtLocation(node);
         const kinds = (wanted.isUnionOrIntersection() ? wanted.types : [wanted])
             .filter((one) => checker.getIndexTypeOfType(one, ts.IndexKind.Number) !== undefined)
@@ -455,8 +475,8 @@ export function listShape(at, list) {
     const held = elementAt(at, list);
     return held === undefined ? undefined : compiled().checker.typeToString(held.type);
 }
-export function listFields(at, list) {
-    const held = elementAt(at, list);
+export function listFields(at, list, within) {
+    const held = elementAt(at, list, within);
     if (held === undefined)
         return [];
     const { checker } = compiled();
@@ -480,12 +500,29 @@ export function listFields(at, list) {
             boolean: flagged(kind),
             worded: worded(kind),
             guide: ts.displayPartsToString(one.getDocumentationComment(checker)).trim(),
+            record: recordOf(checker, kind),
         };
     });
 }
 function elementOf(checker, type) {
     return checker.getIndexTypeOfType(type, ts.IndexKind.Number) ?? type;
 }
+function recordOf(checker, type) {
+    for (const each of type.isUnion() ? type.types : [type]) {
+        if ((each.flags & ts.TypeFlags.StringLike) !== 0 || checker.getIndexTypeOfType(each, ts.IndexKind.Number) === undefined)
+            continue;
+        const element = elementOf(checker, each);
+        if ((element.flags & ts.TypeFlags.Object) === 0)
+            return [];
+        const fields = checker.getPropertiesOfType(element);
+        const worded = fields.every((one) => {
+            const kind = checker.getNonNullableType(checker.getTypeOfSymbol(one));
+            return (kind.isUnion() ? kind.types : [kind]).every((part) => (part.flags & ts.TypeFlags.StringLike) !== 0);
+        });
+        return worded ? fields.map((one) => one.getName()) : [];
+    }
+    return [];
+}
 export function rowShape(at, list) {
     const { program, checker } = compiled();
     const file = program.getSourceFile(resolve(ROOT, at));
@@ -666,7 +703,38 @@ let passed;
 export function reached() {
     return [THREAD_AT, ...descend().threaded.keys()];
 }
+let world = answering();
+const worlds = new WeakMap();
+function kept() {
+    const was = { passed, built, scanned, commands, ignores, readIgnores, source: new Map(source), asked: new Map(asked) };
+    return () => {
+        passed = was.passed;
+        built = was.built;
+        scanned = was.scanned;
+        commands = was.commands;
+        ignores = was.ignores;
+        readIgnores = was.readIgnores;
+        source.clear();
+        for (const [at, text] of was.source)
+            source.set(at, text);
+        asked.clear();
+        for (const [at, ignore] of was.asked)
+            asked.set(at, ignore);
+    };
+}
 export function forget() {
+    const now = answering();
+    if (now === world)
+        libraries.clear();
+    else {
+        worlds.set(world, kept());
+        world = now;
+        const back = worlds.get(now);
+        if (back !== undefined) {
+            back();
+            return;
+        }
+    }
     passed = undefined;
     built = undefined;
     scanned = undefined;
@@ -712,7 +780,7 @@ export function descend() {
         broken.push({
             file: THREAD_AT,
             detail: 'the root does not resolve `Threaded`, so nothing here can be recognised as a declaration and every file reads as unthreaded',
-            instead: `import \`Threaded\` from \`${NAMED}/thread\` in the root, or run \`thread init\`. Without the shape there is nothing to hold anything to`,
+            instead: `import \`Threaded\` from \`${SHAPED}\` in the root, or run \`thread init\`. Without the shape there is nothing to hold anything to`,
         });
         passed = { threaded, mentioned, derived, stated, coined, broken, findings, declarations, rows, sources: sources() };
         return passed;
@@ -781,7 +849,7 @@ export function descend() {
             return;
         }
         const target = resolve(ROOT, row.at);
-        if (unkept(row.at)) {
+        if (!installed(row.at) && unkept(row.at)) {
             findings.push({
                 file: at,
                 detail: `\`${names(row)}\` names \`${row.at}\`, which git ignores, so it is on this machine and in no clone of it`,

package/dist/core/descend.ts

@@ -1,12 +1,12 @@
-import { spawnSync } from 'node:child_process'
-import { attached, existsSync, kind, readdirSync, readFileSync, realpathSync, statSync, writeFileSync } from './files.ts'
+import { starts } from '../integrations/cli.ts'
+import { attached, beyond, existsSync, here as answering, kind, readdirSync, readFileSync, realpathSync, statSync, writeFileSync, type Kind } from '../integrations/disk.ts'
 import { dirname, join, relative, resolve } from 'node:path'
 
 import ts from 'typescript'
 
 import type { Finding } from './finding.ts'
-import { ignored } from './init.ts'
-import { NAMED, ORGANISATION } from './scope.ts'
+import { SHAPED, ignored } from './init.ts'
+import { ORGANISATION, installed } from './scope.ts'
 import { findTree } from './tree.ts'
 
 const BUILT: ReadonlySet<string> = new Set(
@@ -41,7 +41,7 @@ let readIgnores = false
 function ownIgnores(): readonly string[] | undefined {
   if (readIgnores) return ignores
   readIgnores = true
-  if (!attached() && spawnSync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: ROOT, stdio: 'ignore' }).status === 0) {
+  if (!attached() && starts('git', ['rev-parse', '--is-inside-work-tree'], { at: ROOT }).ok) {
     return ignores
   }
   try {
@@ -65,7 +65,7 @@ export function unkept(at: string): boolean {
   const own = ownIgnores()
   const found =
     own === undefined
-      ? spawnSync('git', ['check-ignore', '-q', '--', at], { cwd: ROOT, stdio: 'ignore' }).status === 0
+      ? starts('git', ['check-ignore', '-q', '--', at], { at: ROOT }).ok
       : own.some((one) => at === one || at.startsWith(`${one}/`) || at.split('/').includes(one))
   asked.set(at, found)
   return found
@@ -252,7 +252,7 @@ function listing(at: string, take: readonly string[], skip: readonly string[], o
 function parsing(from: string): ts.ParseConfigHost {
   return {
     useCaseSensitiveFileNames: true,
-    fileExists: (at) => existsSync(at),
+    fileExists: (at) => !beyond(at) && existsSync(at),
     readFile: (at) => {
       try {
         return readFileSync(at)
@@ -301,22 +301,35 @@ export function configured(): { readonly options: ts.CompilerOptions; readonly f
   return { options: { ...FALLBACK, ...INVARIANT }, from: '' }
 }
 
+const libraries = new Map<string, ReturnType<ts.CompilerHost['getSourceFile']>>()
+
+const DEPENDENCIES = '/node_' + 'modules/'
+
 export function hosting(options: ts.CompilerOptions): ts.CompilerHost {
   const host = ts.createCompilerHost(options, true)
   const lib = host.getDefaultLibLocation?.()
+  const settings = JSON.stringify(options)
   const toolchain = (at: string): boolean => lib !== undefined && (at === lib || at.startsWith(`${lib}/`))
+  const seen = (at: string): Kind => (beyond(at) ? 'none' : kind(at))
   return {
     ...host,
-    fileExists: (at) => (toolchain(at) ? host.fileExists(at) : kind(at) === 'file'),
-    directoryExists: (at) => (toolchain(at) ? (host.directoryExists?.(at) ?? false) : kind(at) === 'folder'),
-    readFile: (at) => (toolchain(at) ? host.readFile(at) : kind(at) === 'file' ? readFileSync(at) : undefined),
+    fileExists: (at) => (toolchain(at) ? host.fileExists(at) : seen(at) === 'file'),
+    directoryExists: (at) => (toolchain(at) ? (host.directoryExists?.(at) ?? false) : seen(at) === 'folder'),
+    readFile: (at) => (toolchain(at) ? host.readFile(at) : seen(at) === 'file' ? readFileSync(at) : undefined),
     getSourceFile: (at, version) => {
-      if (toolchain(at)) return host.getSourceFile(at, version)
-      if (kind(at) !== 'file') return undefined
-      return ts.createSourceFile(at, readFileSync(at), version, true)
+      const lasting = toolchain(at) ? true : at.includes(DEPENDENCIES)
+      const key = settings + at + JSON.stringify(version)
+      if (lasting && libraries.has(key)) return libraries.get(key)
+      const made = toolchain(at)
+        ? host.getSourceFile(at, version)
+        : seen(at) === 'file'
+          ? ts.createSourceFile(at, readFileSync(at), version, true)
+          : undefined
+      if (lasting) libraries.set(key, made)
+      return made
     },
     getDirectories: (at) =>
-      kind(at) === 'folder' ? readdirSync(at, { withFileTypes: true }).filter((one) => one.isDirectory()).map((one) => one.name) : [],
+      seen(at) === 'folder' ? readdirSync(at, { withFileTypes: true }).filter((one) => one.isDirectory()).map((one) => one.name) : [],
     realpath: (at) => (toolchain(at) ? (host.realpath?.(at) ?? at) : realpathSync(at)),
     writeFile: (at, said) => {
       writeFileSync(at, said)
@@ -389,8 +402,13 @@ export function read(at: string): string | undefined {
   return text
 }
 
+const shapes = new WeakMap<object, ReadonlyMap<string, readonly string[]>>()
+
 export function shapesNamed(): ReadonlyMap<string, readonly string[]> {
-  const { program, checker } = compiled()
+  const held = compiled()
+  const known = shapes.get(held)
+  if (known !== undefined) return known
+  const { program, checker } = held
   const shape = threadedType(checker, program)
   const found = new Map<string, string[]>()
   if (shape === undefined) return found
@@ -419,6 +437,7 @@ export function shapesNamed(): ReadonlyMap<string, readonly string[]> {
       found.set(named, [...where, at])
     }
   }
+  shapes.set(held, found)
   return found
 }
 
@@ -429,7 +448,7 @@ export function threading(): ReadonlySet<string> {
 export function shapeFields(
   named: string,
   inside?: string,
-): readonly { readonly name: string; readonly required: boolean; readonly list: boolean; readonly map: boolean; readonly worded: boolean; readonly guide: string }[] {
+): readonly { readonly name: string; readonly required: boolean; readonly list: boolean; readonly map: boolean; readonly worded: boolean; readonly guide: string; readonly record: readonly string[] }[] {
   const { program, checker } = compiled()
   for (const at of [...sources(), ...shipped()]) {
     if (!SOURCE.test(at)) continue
@@ -466,6 +485,7 @@ export function shapeFields(
           map: mapped(kind),
           worded: (kind.isUnion() ? kind.types : [kind]).some((each) => (each.flags & ts.TypeFlags.StringLike) !== 0),
           guide: ts.displayPartsToString(one.getDocumentationComment(checker)).trim(),
+          record: recordOf(checker, kind),
         }
       })
     }
@@ -481,9 +501,10 @@ export interface Field {
   readonly boolean: boolean
   readonly worded: boolean
   readonly guide: string
+  readonly record: readonly string[]
 }
 
-function elementAt(at: string, list: string): { readonly type: ts.Type; readonly node: ts.Node } | undefined {
+function elementAt(at: string, list: string, within?: number): { readonly type: ts.Type; readonly node: ts.Node } | undefined {
   const { program, checker } = compiled()
   const file = program.getSourceFile(resolve(ROOT, at))
   if (file === undefined) return undefined
@@ -493,6 +514,7 @@ function elementAt(at: string, list: string): { readonly type: ts.Type; readonly
 
   const consider = (node: ts.ArrayLiteralExpression): void => {
     if (held !== undefined) return
+    if (within !== undefined && node.getStart() !== within) return
     const wanted = checker.getContextualType(node) ?? checker.getTypeAtLocation(node)
     const kinds = (wanted.isUnionOrIntersection() ? wanted.types : [wanted])
       .filter((one) => checker.getIndexTypeOfType(one, ts.IndexKind.Number) !== undefined)
@@ -525,8 +547,8 @@ export function listShape(at: string, list: string): string | undefined {
   return held === undefined ? undefined : compiled().checker.typeToString(held.type)
 }
 
-export function listFields(at: string, list: string): readonly Field[] {
-  const held = elementAt(at, list)
+export function listFields(at: string, list: string, within?: number): readonly Field[] {
+  const held = elementAt(at, list, within)
   if (held === undefined) return []
   const { checker } = compiled()
   const bare = (kind: ts.Type): readonly ts.Type[] =>
@@ -557,6 +579,7 @@ export function listFields(at: string, list: string): readonly Field[] {
       boolean: flagged(kind),
       worded: worded(kind),
       guide: ts.displayPartsToString(one.getDocumentationComment(checker)).trim(),
+      record: recordOf(checker, kind),
     }
   })
 }
@@ -565,6 +588,21 @@ function elementOf(checker: ts.TypeChecker, type: ts.Type): ts.Type {
   return checker.getIndexTypeOfType(type, ts.IndexKind.Number) ?? type
 }
 
+function recordOf(checker: ts.TypeChecker, type: ts.Type): readonly string[] {
+  for (const each of type.isUnion() ? type.types : [type]) {
+    if ((each.flags & ts.TypeFlags.StringLike) !== 0 || checker.getIndexTypeOfType(each, ts.IndexKind.Number) === undefined) continue
+    const element = elementOf(checker, each)
+    if ((element.flags & ts.TypeFlags.Object) === 0) return []
+    const fields = checker.getPropertiesOfType(element)
+    const worded = fields.every((one) => {
+      const kind = checker.getNonNullableType(checker.getTypeOfSymbol(one))
+      return (kind.isUnion() ? kind.types : [kind]).every((part) => (part.flags & ts.TypeFlags.StringLike) !== 0)
+    })
+    return worded ? fields.map((one) => one.getName()) : []
+  }
+  return []
+}
+
 export function rowShape(at: string, list: string): string | undefined {
   const { program, checker } = compiled()
   const file = program.getSourceFile(resolve(ROOT, at))
@@ -751,7 +789,38 @@ export function reached(): readonly string[] {
   return [THREAD_AT, ...descend().threaded.keys()]
 }
 
+let world: object = answering()
+
+const worlds = new WeakMap<object, () => void>()
+
+function kept(): () => void {
+  const was = { passed, built, scanned, commands, ignores, readIgnores, source: new Map(source), asked: new Map(asked) }
+  return () => {
+    passed = was.passed
+    built = was.built
+    scanned = was.scanned
+    commands = was.commands
+    ignores = was.ignores
+    readIgnores = was.readIgnores
+    source.clear()
+    for (const [at, text] of was.source) source.set(at, text)
+    asked.clear()
+    for (const [at, ignore] of was.asked) asked.set(at, ignore)
+  }
+}
+
 export function forget(): void {
+  const now = answering()
+  if (now === world) libraries.clear()
+  else {
+    worlds.set(world, kept())
+    world = now
+    const back = worlds.get(now)
+    if (back !== undefined) {
+      back()
+      return
+    }
+  }
   passed = undefined
   built = undefined
   scanned = undefined
@@ -800,7 +869,7 @@ export function descend(): Pass {
     broken.push({
       file: THREAD_AT,
       detail: 'the root does not resolve `Threaded`, so nothing here can be recognised as a declaration and every file reads as unthreaded',
-      instead: `import \`Threaded\` from \`${NAMED}/thread\` in the root, or run \`thread init\`. Without the shape there is nothing to hold anything to`,
+      instead: `import \`Threaded\` from \`${SHAPED}\` in the root, or run \`thread init\`. Without the shape there is nothing to hold anything to`,
     })
     passed = { threaded, mentioned, derived, stated, coined, broken, findings, declarations, rows, sources: sources() }
     return passed
@@ -871,7 +940,7 @@ export function descend(): Pass {
     }
 
     const target = resolve(ROOT, row.at)
-    if (unkept(row.at)) {
+    if (!installed(row.at) && unkept(row.at)) {
       findings.push({
         file: at,
         detail: `\`${names(row)}\` names \`${row.at}\`, which git ignores, so it is on this machine and in no clone of it`,

package/dist/core/errors/catalogue.d.ts

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

package/dist/{operations/errors/errors.js → core/errors/catalogue.js}

@@ -1,4 +1,4 @@
-import { defineError } from "./catalog.js";
+import { defineError } from './error.js';
 export const AuthUnauthenticated = defineError({
     code: 'auth.unauthenticated',
     class: 'UNAUTHENTICATED',

package/dist/{operations/errors/errors.ts → core/errors/catalogue.ts}

@@ -1,6 +1,6 @@
 
 
-import { defineError } from './catalog.ts'
+import { defineError } from './error.ts'
 
 export const AuthUnauthenticated = defineError({
   code: 'auth.unauthenticated',

package/dist/{operations/errors/catalog.d.ts → core/errors/error.d.ts}

@@ -1,7 +1,6 @@
 import { type ErrorClass } from './classes.ts';
-export declare const NAMESPACES: readonly ["auth", "quota", "rate_limit", "feature", "db", "workflow", "queue", "ai", "search", "comms", "config", "net", "internal"];
-export type Namespace = (typeof NAMESPACES)[number];
-export type ErrorCode = `${Namespace}.${string}`;
+import type { ErrorCode } from './namespaces.ts';
+export type { ErrorCode } from './namespaces.ts';
 export interface ErrorDef<C extends ErrorCode = ErrorCode> {
     readonly code: C;
     readonly class: ErrorClass;

package/dist/{operations/errors/catalog.js → core/errors/error.js}

@@ -1,19 +1,4 @@
-import { classDef } from "./classes.js";
-export const NAMESPACES = [
-    'auth',
-    'quota',
-    'rate_limit',
-    'feature',
-    'db',
-    'workflow',
-    'queue',
-    'ai',
-    'search',
-    'comms',
-    'config',
-    'net',
-    'internal',
-];
+import { classDef } from './classes.js';
 export class PlatformError extends Error {
     def;
     detail;

package/dist/{operations/errors/catalog.ts → core/errors/error.ts}

@@ -2,25 +2,9 @@
 
 import { classDef, type ErrorClass } from './classes.ts'
 
-export const NAMESPACES = [
-  'auth',
-  'quota',
-  'rate_limit',
-  'feature',
-  'db',
-  'workflow',
-  'queue',
-  'ai',
-  'search',
-  'comms',
-  'config',
-  'net',
-  'internal',
-] as const
-
-export type Namespace = (typeof NAMESPACES)[number]
-
-export type ErrorCode = `${Namespace}.${string}`
+import type { ErrorCode } from './namespaces.ts'
+
+export type { ErrorCode } from './namespaces.ts'
 
 export interface ErrorDef<C extends ErrorCode = ErrorCode> {
   readonly code: C

package/dist/core/errors/namespaces.d.ts

@@ -0,0 +1,3 @@
+export declare const NAMESPACES: readonly ['auth', 'quota', 'rate_limit', 'feature', 'db', 'workflow', 'queue', 'ai', 'search', 'comms', 'config', 'net', 'internal'];
+export type Namespace = (typeof NAMESPACES)[number];
+export type ErrorCode = `${Namespace}.${string}`;