@datakable/core 1.0.1 → 1.1.0

package/dist/sorting.d.ts

@@ -1,5 +1,5 @@
-export { W as comparatorDiagnostics, ar as sortingDiagnostics } from './codes-OsjAR3Wz.js';
-import { ad as SortAlgorithm, a1 as Path, e as FeatureTypes, F as Feature } from './explain-Dn99IQt0.js';
+export { W as comparatorDiagnostics, ar as sortingDiagnostics } from './codes-B9bCK73-.js';
+import { ad as SortAlgorithm, a1 as Path, e as FeatureTypes, F as Feature } from './explain-i0OATi_W.js';
 import { a as DataMode } from './mode-DFV8ryXo.js';
 
 /** The rank of `v` in {@link RANK}. */

package/dist/source/codes.cjs

@@ -25,6 +25,7 @@ __export(codes_exports, {
 });
 module.exports = __toCommonJS(codes_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var asyncMessages = {
   DK_ASYNC_TIMEOUT: {
     problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,

package/dist/source/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAcnD,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AAcA,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/source/codes.js

@@ -1,5 +1,6 @@
 // src/source/codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var asyncMessages = {
   DK_ASYNC_TIMEOUT: {
     problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,

package/dist/source/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAcnD,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/source/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_ASYNC_TIMEOUT: {\n      /** The option that ran too long (`fetcher`, `searchFn`); a closed set, never row data. */\n      source: string\n      /** The timeout that was exceeded, in ms. */\n      timeout: number\n    }\n  }\n}\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const asyncMessages: DiagnosticMessages<'DK_ASYNC_TIMEOUT'> = {\n  DK_ASYNC_TIMEOUT: {\n    problem: (d) => `${d.source} did not settle within the timeout (${d.timeout} ms)`,\n    impact: () =>\n      'the request was aborted and its late result is ignored; the previous results were kept ' +\n      \"(status: 'error')\",\n    fix: (d) => [\n      `make ${d.source} answer faster (smaller pages, a server-side index), or raise \\`timeout\\` ` +\n        `(now ${d.timeout} ms)`,\n      `pass ctx.signal to fetch() inside ${d.source} so the timed-out request is cancelled on the ` +\n        'network too',\n    ],\n  },\n}\n\n/** Codes owned by asyncControl (spec §3.4, §7.1, §8.3). */\nexport const asyncDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_ASYNC_TIMEOUT',\n      level: 'error',\n      where: (d) => ({ kind: 'option', path: d.source }),\n    },\n    (process.env.NODE_ENV !== \"production\") && asyncMessages.DK_ASYNC_TIMEOUT,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AAcA,IAAM,gBAAwD;AAAA,EACnE,kBAAkB;AAAA,IAChB,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,uCAAuC,EAAE,OAAO;AAAA,IAC3E,QAAQ,MACN;AAAA,IAEF,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,MAAM,kFACN,EAAE,OAAO;AAAA,MACnB,qCAAqC,EAAE,MAAM;AAAA,IAE/C;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,EAAE,OAAO;AAAA,IAClD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/source/fetch-codes.cjs

@@ -25,6 +25,7 @@ __export(fetch_codes_exports, {
 });
 module.exports = __toCommonJS(fetch_codes_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var BAD = {
   "not-an-object": (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,
   "rows-not-an-array": (d) => `fetcher result.rows is ${d.received}, not an array`,

package/dist/source/fetch-codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/source/fetch-codes.js

@@ -1,5 +1,6 @@
 // src/source/fetch-codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var BAD = {
   "not-an-object": (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,
   "rows-not-an-array": (d) => `fetcher result.rows is ${d.received}, not an array`,

package/dist/source/fetch-codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AA0C1D,IAAM,MAGF;AAAA,EACF,iBAAiB,CAAC,MAAM,yBAAyB,EAAE,QAAQ;AAAA,EAC3D,qBAAqB,CAAC,MAAM,0BAA0B,EAAE,QAAQ;AAAA,EAChE,oBAAoB,MAClB;AAAA,EACF,oBAAoB,CAAC,MAAM,8BAA8B,EAAE,QAAQ;AAAA,EACnE,sBAAsB,CAAC,MACrB,4BAA4B,EAAE,QAAQ,kCAAkC,EAAE,IAAI;AAClF;AAEA,IAAM,UAAU,EAAE,MAAM,UAAU,MAAM,UAAU;AAG3C,IAAM,gBAMT;AAAA,EACF,eAAe;AAAA,IACb,SAAS,CAAC,MACR,YAAY,EAAE,MAAM,MAAM,EAAE,WAAW,6BAA6B,EAAE,MAAM,MACxE,EAAE,WAAW;AAAA,IACnB,QAAQ,MACN;AAAA,IACF,KAAK,CAAC,MAAM;AAAA,MACV,SAAS,EAAE,MAAM,wBAAwB,EAAE,MAAM;AAAA,MACjD,cAAc,EAAE,MAAM,oBAAoB,EAAE,MAAM;AAAA,IACpD;AAAA,EACF;AAAA,EACA,gCAAgC;AAAA,IAC9B,SAAS,MAAM;AAAA,IACf,QAAQ,CAAC,MACP,EAAE,UAAU,SACR,2EACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV,2DACG,EAAE,SAAS,SAAS,IAAI,gBAAgB,EAAE,SAAS,KAAK,IAAI,CAAC,MAAM,MACpE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,iBAAiB;AAAA,IACf,SAAS,CAAC,MAAM,4BAA4B,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAChF,QAAQ,CAAC,MACP,EAAE,UACE,iDACA;AAAA,IACN,KAAK,MAAM;AAAA,MACT;AAAA,MAEA;AAAA,IAEF;AAAA,EACF;AAAA,EACA,kBAAkB;AAAA,IAChB,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,IACd,KAAK,MAAM;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB,SAAS,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC;AAAA,IAChC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,EAAE,YAAY,uBACV,0FACA;AAAA,MAEJ;AAAA,IAEF;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,CAAC,OAAO,EAAE,MAAM,WAAW,MAAM,EAAE,OAAO;AAAA,IACnD;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,MAAM;AAAA,IACf;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/source/fetch-codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\n/** Why a fetcher result was rejected (`DK_FETCH_BAD_RESPONSE`); a closed set, never row data. */\nexport type BadResponse =\n  | 'not-an-object'\n  | 'rows-not-an-array'\n  | 'rowCount-missing'\n  | 'rowCount-invalid'\n  | 'rowCount-too-small'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_MODE_ORDER: {\n      /** The client-mode feature that runs before a server-mode one. */\n      client: string\n      clientStage: string\n      /** The server-mode feature after it. */\n      server: string\n      serverStage: string\n    }\n    DK_FETCHER_WITHOUT_SERVER_MODE: {\n      /** The installed pipeline features (all client mode). */\n      features: string[]\n      phase: 'init' | 'setOptions'\n    }\n    DK_FETCH_FAILED: {\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n      /** Whether rows were shown before (`false`: the first request failed). */\n      hadRows: boolean\n    }\n    DK_FETCH_ABORTED: Record<string, never>\n    DK_FETCH_BAD_RESPONSE: {\n      problem: BadResponse\n      /** The type of what was returned (`describeValue`), for the shape problems. */\n      received?: string\n      rows?: number\n      rowCount?: number\n    }\n  }\n}\n\nconst BAD: Record<\n  BadResponse,\n  (d: { received?: string; rows?: number; rowCount?: number }) => string\n> = {\n  'not-an-object': (d) => `fetcher resolved with ${d.received}, not { rows, rowCount }`,\n  'rows-not-an-array': (d) => `fetcher result.rows is ${d.received}, not an array`,\n  'rowCount-missing': () =>\n    'fetcher result has no rowCount, and pagination is in server mode (it needs the total)',\n  'rowCount-invalid': (d) => `fetcher result.rowCount is ${d.received}, not an integer ≥ 0`,\n  'rowCount-too-small': (d) =>\n    `fetcher result.rowCount (${d.rowCount}) is smaller than rows.length (${d.rows})`,\n}\n\nconst FETCHER = { kind: 'option', path: 'fetcher' } as const\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const fetchMessages: DiagnosticMessages<\n  | 'DK_MODE_ORDER'\n  | 'DK_FETCHER_WITHOUT_SERVER_MODE'\n  | 'DK_FETCH_FAILED'\n  | 'DK_FETCH_ABORTED'\n  | 'DK_FETCH_BAD_RESPONSE'\n> = {\n  DK_MODE_ORDER: {\n    problem: (d) =>\n      `feature \"${d.server}\" (${d.serverStage}) is in server mode, but \"${d.client}\" ` +\n      `(${d.clientStage}) runs before it in client mode; server steps must come first`,\n    impact: () =>\n      'the table was not created: the client step would only see the rows the server returned',\n    fix: (d) => [\n      `move \"${d.client}\" to the server too: ${d.client}({ mode: 'server' })`,\n      `or handle \"${d.server}\" in the client: ${d.server}({ mode: 'client' }) (the default)`,\n    ],\n  },\n  DK_FETCHER_WITHOUT_SERVER_MODE: {\n    problem: () => 'options.fetcher is set, but no feature is in server mode',\n    impact: (d) =>\n      d.phase === 'init'\n        ? 'the table was not created: nothing would tell the fetcher what to load'\n        : 'setOptions() was rejected; the previous options are kept',\n    fix: (d) => [\n      `set mode: 'server' on the features the server handles` +\n        (d.features.length > 0 ? ` (installed: ${d.features.join(', ')})` : '') +\n        `, e.g. pagination({ mode: 'server' })`,\n      'or remove fetcher and pass the rows as options.data (client mode)',\n    ],\n  },\n  DK_FETCH_FAILED: {\n    problem: (d) => `fetcher rejected or threw${d.errorName ? ` ${d.errorName}` : ''}`,\n    impact: (d) =>\n      d.hadRows\n        ? \"the previous rows are kept (status: 'error')\"\n        : \"nothing is shown yet (status: 'error', isInitialLoad: true)\",\n    fix: () => [\n      'check the request the fetcher sends (the original error is context.cause, passed to ' +\n        'onDiagnostic)',\n      'retry from the UI with table.refetch(); the next state change (page, sort, filter, ' +\n        'query) or a new fetcher also runs it again',\n    ],\n  },\n  DK_FETCH_ABORTED: {\n    problem: () => 'a fetcher request was superseded by a newer one (latest wins)',\n    impact: () => 'its result is ignored; the request was aborted through ctx.signal',\n    fix: () => [\n      'nothing to fix; pass params.signal to fetch() so superseded requests stop on the network',\n    ],\n  },\n  DK_FETCH_BAD_RESPONSE: {\n    problem: (d) => BAD[d.problem](d),\n    impact: () => \"the result was ignored and the previous rows are kept (status: 'error')\",\n    fix: (d) => [\n      d.problem === 'rowCount-too-small'\n        ? 'return rowCount as the total number of matching rows on the server, not the page size'\n        : 'resolve the fetcher with { rows: T[], rowCount: number } (rowCount = the total ' +\n          'number of matching rows on the server)',\n      'map your API response in the fetcher: async (p) => { const r = await api(p); ' +\n        'return { rows: r.items, rowCount: r.total } }',\n    ],\n  },\n}\n\n/** Codes owned by the data modes and the server source (spec §7.1, §8.3). */\nexport const fetchDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_MODE_ORDER',\n      level: 'error',\n      config: true,\n      where: (d) => ({ kind: 'feature', name: d.server }),\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_MODE_ORDER,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCHER_WITHOUT_SERVER_MODE',\n      level: 'error',\n      config: true,\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCHER_WITHOUT_SERVER_MODE,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_FAILED',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_ABORTED',\n      level: 'info',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_ABORTED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_FETCH_BAD_RESPONSE',\n      level: 'error',\n      where: () => FETCHER,\n    },\n    (process.env.NODE_ENV !== \"production\") && fetchMessages.DK_FETCH_BAD_RESPONSE,\n  ),\n]\n"],"mappings":"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","names":[]}

package/dist/table/codes.cjs

@@ -25,6 +25,7 @@ __export(codes_exports, {
 });
 module.exports = __toCommonJS(codes_exports);
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var listSlices = (s) => s.length === 0 ? "a function updater" : s.map((k) => `"${k}"`).join(", ");
 var tableMessages = {
   DK_LISTENER_FAILED: {

package/dist/table/codes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AA2B1D,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA0D;AAC1D,2BAAO;AA2BP,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,MAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,MACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/table/codes.js

@@ -1,5 +1,6 @@
 // src/table/codes.ts
 import { defineDiagnostic } from "../diagnostics/catalog.js";
+import "../diagnostics/process-guard.js";
 var listSlices = (s) => s.length === 0 ? "a function updater" : s.map((k) => `"${k}"`).join(", ");
 var tableMessages = {
   DK_LISTENER_FAILED: {

package/dist/table/codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AA2B1D,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}
+{"version":3,"sources":["../../src/table/codes.ts"],"sourcesContent":["import { type DiagnosticMessages, defineDiagnostic } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\n\ndeclare module '../diagnostics/catalog' {\n  interface DiagnosticCatalog {\n    DK_LISTENER_FAILED: {\n      /** Subscription number (1 = the first `subscribe` call). */\n      listener: number\n      /** `error.name` only; the full error is `context.cause`. */\n      errorName?: string\n    }\n    DK_UPDATE_LOOP: {\n      limit: number\n      /** Slice names of the dropped update. */\n      slices: string[]\n      /** The listener whose update was dropped, if one was running. */\n      listener?: number\n    }\n    DK_TABLE_DESTROYED: { method: string }\n    DK_CONTROLLED_WITHOUT_HANDLER: {\n      /** Controlled slices (keys of `options.state`). */\n      slices: string[]\n      /** `true` when an update to them was just dropped. */\n      dropped: boolean\n    }\n  }\n}\n\nconst listSlices = (s: string[]) =>\n  s.length === 0 ? 'a function updater' : s.map((k) => `\"${k}\"`).join(', ')\n\n/** Message text (§8.2): development builds, or production via `@datakable/core/messages`. */\nexport const tableMessages: DiagnosticMessages<\n  'DK_LISTENER_FAILED' | 'DK_UPDATE_LOOP' | 'DK_TABLE_DESTROYED' | 'DK_CONTROLLED_WITHOUT_HANDLER'\n> = {\n  DK_LISTENER_FAILED: {\n    problem: (d) =>\n      `subscribe listener #${d.listener} threw${d.errorName ? ` ${d.errorName}` : ''} ` +\n      'while being notified of a state change',\n    impact: () => 'the other listeners still ran; the state change is committed',\n    fix: (d) => [\n      `catch errors inside listener #${d.listener} (the ${d.listener}. subscribe call); ` +\n        'listeners must not throw',\n      'the original error is context.cause (passed to onDiagnostic)',\n    ],\n  },\n  DK_UPDATE_LOOP: {\n    problem: (d) =>\n      `state updates re-entered from listeners ${d.limit} rounds in a row ` +\n      `(last update: ${listSlices(d.slices)})`,\n    impact: () => 'the update was dropped to break the loop; the state is unchanged by it',\n    fix: (d) => [\n      `make ${d.listener === undefined ? 'the listener' : `listener #${d.listener}`} update ` +\n        'state only when the value differs (compare before calling setState)',\n      'derive the value instead of storing it, or move the update out of the listener',\n    ],\n  },\n  DK_TABLE_DESTROYED: {\n    problem: (d) => `table.${d.method}() was called after table.destroy()`,\n    impact: () => 'the call was ignored (no-op)',\n    fix: (d) => [\n      `stop calling ${d.method}() after destroy(): unsubscribe / cancel timers in your cleanup`,\n      'create a new table with createTable() if the component is mounted again',\n    ],\n  },\n  DK_CONTROLLED_WITHOUT_HANDLER: {\n    problem: (d) =>\n      `options.state controls ${listSlices(d.slices)} but options.onStateChange is missing`,\n    impact: (d) =>\n      d.dropped\n        ? 'an update to these slices was dropped: interactions that change them are frozen'\n        : 'interactions that change these slices are frozen (their updates are dropped)',\n    fix: (d) => [\n      'pass onStateChange: (updater) => setMyState(updater), and feed the result back with ' +\n        'setOptions({ state })',\n      `or remove ${listSlices(d.slices)} from options.state (use initialState) so the table ` +\n        'owns them',\n    ],\n  },\n}\n\n/** Codes owned by the store (§3.2, §8.3). */\nexport const tableDiagnostics = [\n  defineDiagnostic(\n    {\n      code: 'DK_LISTENER_FAILED',\n      level: 'error',\n      where: (d) => ({ kind: 'operation', op: 'table.subscribe', slot: `listener #${d.listener}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_LISTENER_FAILED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_UPDATE_LOOP',\n      level: 'error',\n      where: (d) =>\n        d.listener === undefined\n          ? { kind: 'operation', op: 'table.setState' }\n          : { kind: 'operation', op: 'table.setState', slot: `listener #${d.listener}` },\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_UPDATE_LOOP,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_TABLE_DESTROYED',\n      level: 'warn',\n      where: (d) => ({ kind: 'operation', op: `table.${d.method}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_TABLE_DESTROYED,\n  ),\n  defineDiagnostic(\n    {\n      code: 'DK_CONTROLLED_WITHOUT_HANDLER',\n      level: 'warn',\n      where: (d) => ({ kind: 'option', path: `state.${d.slices[0] ?? ''}` }),\n    },\n    (process.env.NODE_ENV !== \"production\") && tableMessages.DK_CONTROLLED_WITHOUT_HANDLER,\n  ),\n]\n"],"mappings":";AAAA,SAAkC,wBAAwB;AAC1D,OAAO;AA2BP,IAAM,aAAa,CAAC,MAClB,EAAE,WAAW,IAAI,uBAAuB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AAGnE,IAAM,gBAET;AAAA,EACF,oBAAoB;AAAA,IAClB,SAAS,CAAC,MACR,uBAAuB,EAAE,QAAQ,SAAS,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK,EAAE;AAAA,IAEhF,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,iCAAiC,EAAE,QAAQ,SAAS,EAAE,QAAQ;AAAA,MAE9D;AAAA,IACF;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS,CAAC,MACR,2CAA2C,EAAE,KAAK,kCACjC,WAAW,EAAE,MAAM,CAAC;AAAA,IACvC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,QAAQ,EAAE,aAAa,SAAY,iBAAiB,aAAa,EAAE,QAAQ,EAAE;AAAA,MAE7E;AAAA,IACF;AAAA,EACF;AAAA,EACA,oBAAoB;AAAA,IAClB,SAAS,CAAC,MAAM,SAAS,EAAE,MAAM;AAAA,IACjC,QAAQ,MAAM;AAAA,IACd,KAAK,CAAC,MAAM;AAAA,MACV,gBAAgB,EAAE,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EACA,+BAA+B;AAAA,IAC7B,SAAS,CAAC,MACR,0BAA0B,WAAW,EAAE,MAAM,CAAC;AAAA,IAChD,QAAQ,CAAC,MACP,EAAE,UACE,oFACA;AAAA,IACN,KAAK,CAAC,MAAM;AAAA,MACV;AAAA,MAEA,aAAa,WAAW,EAAE,MAAM,CAAC;AAAA,IAEnC;AAAA,EACF;AACF;AAGO,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,mBAAmB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IAC7F;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,MACN,EAAE,aAAa,SACX,EAAE,MAAM,aAAa,IAAI,iBAAiB,IAC1C,EAAE,MAAM,aAAa,IAAI,kBAAkB,MAAM,aAAa,EAAE,QAAQ,GAAG;AAAA,IACnF;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,aAAa,IAAI,SAAS,EAAE,MAAM,GAAG;AAAA,IAC9D;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AAAA,EACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO,CAAC,OAAO,EAAE,MAAM,UAAU,MAAM,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG;AAAA,IACtE;AAAA,IACC,QAAQ,IAAI,aAAa,gBAAiB,cAAc;AAAA,EAC3D;AACF;","names":[]}

package/dist/table/create-table.cjs

@@ -27,8 +27,10 @@ var import_codes = require("../catalog/codes.cjs");
 var import_validator = require("../catalog/validator.cjs");
 var import_build = require("../diagnostics/build.cjs");
 var import_catalog = require("../diagnostics/catalog.cjs");
+var import_process_guard = require("../diagnostics/process-guard.cjs");
 var import_explain = require("../diagnostics/explain.cjs");
 var import_hub = require("../diagnostics/hub.cjs");
+var import_redact = require("../diagnostics/redact.cjs");
 var import_tracer = require("../diagnostics/tracer.cjs");
 var import_runtime = require("../feature/runtime.cjs");
 var import_data_checks = require("../ingest/data-checks.cjs");
@@ -65,7 +67,23 @@ var RANK = [
   "error"
 ];
 var isThenable = (v) => v != null && typeof v.then === "function";
-var freeze = (s) => process.env.NODE_ENV !== "production" ? Object.freeze(s) : s;
+var deepFrozen = process.env.NODE_ENV !== "production" ? /* @__PURE__ */ new WeakSet() : void 0;
+function deepFreeze(v) {
+  if (v === null || typeof v !== "object" || deepFrozen?.has(v)) return;
+  const isArray = Array.isArray(v);
+  if (!isArray) {
+    const proto = Object.getPrototypeOf(v);
+    if (proto !== Object.prototype && proto !== null) return;
+  }
+  deepFrozen?.add(v);
+  Object.freeze(v);
+  if (isArray) for (let i = 0; i < v.length; i++) deepFreeze(v[i]);
+  else for (const k in v) deepFreeze(v[k]);
+}
+var freeze = (s) => {
+  if (process.env.NODE_ENV !== "production") deepFreeze(s);
+  return s;
+};
 var columnId = (c) => c.key ?? c.id;
 function createTable(initialOptions) {
   let options = { ...initialOptions };
@@ -118,7 +136,11 @@ function createTable(initialOptions) {
     ...typeof redactOption === "string" ? { level: redactOption } : {},
     ...typeof redactOption === "function" ? { redact: redactOption } : {},
     sensitiveColumns,
-    rowKeySensitive: () => typeof options.rowKey === "string" && sensitiveColumns().includes(options.rowKey)
+    // A rowKey path into (or above) a sensitive column reads its data too (#45).
+    rowKeySensitive: () => {
+      const k = options.rowKey;
+      return typeof k === "string" && sensitiveColumns().some((c) => (0, import_redact.pathsOverlap)(k, c));
+    }
   };
   const hub = (0, import_hub.createDiagnostics)({
     ...options.name === void 0 ? {} : { name: options.name },
@@ -159,7 +181,7 @@ function createTable(initialOptions) {
     options.invalidRows ?? "drop",
     () => options.columns
   );
-  if (options.schema && !schemaIngest) unwrapped("schema", "withSchema");
+  if (options.schema && !schemaIngest) unwrapped("schema", options.schema, "withSchema");
   function sensitiveColumns() {
     const out = [];
     for (const c of options.columns ?? EMPTY) {
@@ -329,7 +351,7 @@ function createTable(initialOptions) {
     if (next === data) return;
     data = next;
     pending = true;
-    dataChecks?.check(data, options.columns);
+    if (process.env.NODE_ENV !== "production") dataChecks?.check(data, options.columns);
     rowModelDirty = true;
   }
   const runner = (0, import_runner.createPipeline)({
@@ -485,7 +507,7 @@ function createTable(initialOptions) {
         );
       });
     } finally {
-      if (!fetched) dataCheck?.remember(options.data);
+      if (process.env.NODE_ENV !== "production" && !fetched) dataCheck?.remember(options.data);
     }
   }
   function update(updater, slot) {
@@ -554,7 +576,7 @@ function createTable(initialOptions) {
         if (next.rowCount !== previous.rowCount) pending = true;
         if (next.fetcher !== previous.fetcher) server?.reset();
         if (next.data !== previous.data) ingest();
-        else {
+        else if (process.env.NODE_ENV !== "production") {
           if ("data" in partial) dataCheck?.check(next.data);
           if (next.columns !== previous.columns) dataChecks?.check(data, next.columns);
         }
@@ -625,13 +647,20 @@ function createTable(initialOptions) {
   function useServer(fetcher, phase) {
     const factory = fetcher?.[import_server_brand.SERVER_SOURCE];
     if (factory) server = use(factory);
-    else if (fetcher) unwrapped("fetcher", "withFetcher", phase);
+    else if (fetcher) unwrapped("fetcher", fetcher, "withFetcher", "server", phase);
     return server;
   }
-  function unwrapped(path, wrap, phase = "init") {
+  function unwrapped(path, value, wrap, entry = path, phase = "init") {
     return (0, import_build.throwConfigError)(
       "DK_INVALID_OPTION",
-      { path, expected: `${wrap}(${path})`, received: path, suggestions: [], phase },
+      {
+        path,
+        expected: `wrapped|${wrap}|${path}|${entry}`,
+        // prose key (diagnostics/prose.ts)
+        received: typeof value,
+        suggestions: [],
+        phase
+      },
       { table: hub.table, trigger: phase }
     );
   }
@@ -653,6 +682,7 @@ function createTable(initialOptions) {
   }
   (0, import_internals.setTableInternals)(table, {
     features: pipeline,
+    name: options.name,
     rowCount: () => typeof options.fetcher === "function" ? server?.rowCount() : options.rowCount,
     hasFetcher: () => typeof options.fetcher === "function",
     emit: hub.emit,