@datakable/core 2.0.1 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. package/README.md +3 -2
  2. package/dist/{codes-B9bCK73-.d.cts → codes-4sYQv_7J.d.cts} +42 -12
  3. package/dist/{codes-B9bCK73-.d.ts → codes-4sYQv_7J.d.ts} +42 -12
  4. package/dist/column-filters.d.cts +2 -2
  5. package/dist/column-filters.d.ts +2 -2
  6. package/dist/diagnostics/build.cjs +1 -1
  7. package/dist/diagnostics/build.cjs.map +1 -1
  8. package/dist/diagnostics/build.js +2 -2
  9. package/dist/diagnostics/build.js.map +1 -1
  10. package/dist/diagnostics/console.cjs +15 -4
  11. package/dist/diagnostics/console.cjs.map +1 -1
  12. package/dist/diagnostics/console.js +15 -4
  13. package/dist/diagnostics/console.js.map +1 -1
  14. package/dist/diagnostics/explain.cjs.map +1 -1
  15. package/dist/diagnostics/explain.js.map +1 -1
  16. package/dist/diagnostics/hub.cjs +7 -1
  17. package/dist/diagnostics/hub.cjs.map +1 -1
  18. package/dist/diagnostics/hub.js +7 -1
  19. package/dist/diagnostics/hub.js.map +1 -1
  20. package/dist/diagnostics/prose.cjs +10 -1
  21. package/dist/diagnostics/prose.cjs.map +1 -1
  22. package/dist/diagnostics/prose.js +9 -1
  23. package/dist/diagnostics/prose.js.map +1 -1
  24. package/dist/diagnostics/redact.cjs +1 -1
  25. package/dist/diagnostics/redact.cjs.map +1 -1
  26. package/dist/diagnostics/redact.js +1 -1
  27. package/dist/diagnostics/redact.js.map +1 -1
  28. package/dist/diagnostics/types.cjs.map +1 -1
  29. package/dist/{explain-i0OATi_W.d.ts → explain-DmwN_RG9.d.cts} +13 -6
  30. package/dist/{explain-Q8Cg0cZy.d.cts → explain-Dr3SmMNY.d.ts} +13 -6
  31. package/dist/feature/install.cjs +2 -1
  32. package/dist/feature/install.cjs.map +1 -1
  33. package/dist/feature/install.js +2 -1
  34. package/dist/feature/install.js.map +1 -1
  35. package/dist/feature/slice-guard.cjs +76 -0
  36. package/dist/feature/slice-guard.cjs.map +1 -0
  37. package/dist/feature/slice-guard.js +50 -0
  38. package/dist/feature/slice-guard.js.map +1 -0
  39. package/dist/features/column-filters/codes.cjs +2 -19
  40. package/dist/features/column-filters/codes.cjs.map +1 -1
  41. package/dist/features/column-filters/codes.js +2 -19
  42. package/dist/features/column-filters/codes.js.map +1 -1
  43. package/dist/features/column-filters/column-filters.cjs +37 -22
  44. package/dist/features/column-filters/column-filters.cjs.map +1 -1
  45. package/dist/features/column-filters/column-filters.js +37 -22
  46. package/dist/features/column-filters/column-filters.js.map +1 -1
  47. package/dist/features/column-filters/match.cjs +6 -2
  48. package/dist/features/column-filters/match.cjs.map +1 -1
  49. package/dist/features/column-filters/match.js +6 -2
  50. package/dist/features/column-filters/match.js.map +1 -1
  51. package/dist/features/pagination/pagination.cjs +2 -2
  52. package/dist/features/pagination/pagination.cjs.map +1 -1
  53. package/dist/features/pagination/pagination.js +2 -2
  54. package/dist/features/pagination/pagination.js.map +1 -1
  55. package/dist/features/search/codes.cjs +18 -2
  56. package/dist/features/search/codes.cjs.map +1 -1
  57. package/dist/features/search/codes.js +16 -1
  58. package/dist/features/search/codes.js.map +1 -1
  59. package/dist/features/search/search-engine.cjs +24 -5
  60. package/dist/features/search/search-engine.cjs.map +1 -1
  61. package/dist/features/search/search-engine.js +25 -6
  62. package/dist/features/search/search-engine.js.map +1 -1
  63. package/dist/features/sorting/sorting.cjs +55 -24
  64. package/dist/features/sorting/sorting.cjs.map +1 -1
  65. package/dist/features/sorting/sorting.js +55 -24
  66. package/dist/features/sorting/sorting.js.map +1 -1
  67. package/dist/index.d.cts +26 -17
  68. package/dist/index.d.ts +26 -17
  69. package/dist/intercept/runtime.cjs +3 -2
  70. package/dist/intercept/runtime.cjs.map +1 -1
  71. package/dist/intercept/runtime.js +3 -2
  72. package/dist/intercept/runtime.js.map +1 -1
  73. package/dist/messages/index.cjs +2 -0
  74. package/dist/messages/index.cjs.map +1 -1
  75. package/dist/messages/index.js +2 -0
  76. package/dist/messages/index.js.map +1 -1
  77. package/dist/pagination.d.cts +2 -2
  78. package/dist/pagination.d.ts +2 -2
  79. package/dist/schema.d.cts +2 -2
  80. package/dist/schema.d.ts +2 -2
  81. package/dist/{search-async-entry-CuLYPfY_.d.cts → search-async-entry-BiemO3JT.d.cts} +2 -2
  82. package/dist/{search-async-entry-Cx7xpuVZ.d.ts → search-async-entry-GRj0E06n.d.ts} +2 -2
  83. package/dist/search-async.d.cts +3 -3
  84. package/dist/search-async.d.ts +3 -3
  85. package/dist/search.d.cts +4 -4
  86. package/dist/search.d.ts +4 -4
  87. package/dist/server.d.cts +3 -3
  88. package/dist/server.d.ts +3 -3
  89. package/dist/sorting.d.cts +2 -2
  90. package/dist/sorting.d.ts +2 -2
  91. package/dist/source/async-control.cjs +2 -1
  92. package/dist/source/async-control.cjs.map +1 -1
  93. package/dist/source/async-control.js +2 -1
  94. package/dist/source/async-control.js.map +1 -1
  95. package/dist/source/fetcher.cjs.map +1 -1
  96. package/dist/source/fetcher.js.map +1 -1
  97. package/dist/source/server.cjs +58 -5
  98. package/dist/source/server.cjs.map +1 -1
  99. package/dist/source/server.js +58 -5
  100. package/dist/source/server.js.map +1 -1
  101. package/dist/table/create-table.cjs +30 -20
  102. package/dist/table/create-table.cjs.map +1 -1
  103. package/dist/table/create-table.js +30 -20
  104. package/dist/table/create-table.js.map +1 -1
  105. package/dist/table/index.cjs +3 -0
  106. package/dist/table/index.cjs.map +1 -1
  107. package/dist/table/index.js +5 -1
  108. package/dist/table/index.js.map +1 -1
  109. package/dist/table/state-codes.cjs +72 -0
  110. package/dist/table/state-codes.cjs.map +1 -0
  111. package/dist/table/state-codes.js +45 -0
  112. package/dist/table/state-codes.js.map +1 -0
  113. package/dist/table/types.cjs.map +1 -1
  114. package/dist/table/types.js.map +1 -1
  115. package/dist/validity.d.cts +2 -2
  116. package/dist/validity.d.ts +2 -2
  117. package/dist/version.cjs +1 -1
  118. package/dist/version.cjs.map +1 -1
  119. package/dist/version.js +1 -1
  120. package/dist/version.js.map +1 -1
  121. package/package.json +1 -1
  122. package/dist/ingest/test-schemas.cjs +0 -73
  123. package/dist/ingest/test-schemas.cjs.map +0 -1
  124. package/dist/ingest/test-schemas.js +0 -46
  125. package/dist/ingest/test-schemas.js.map +0 -1
@@ -1,5 +1,9 @@
1
1
  // src/source/server.ts
2
+ import { keepDiagnostics } from "../diagnostics/catalog.js";
3
+ import "../diagnostics/process-guard.js";
2
4
  import { errorName } from "../intercept/classify.js";
5
+ import { resolveColumns } from "../pipeline/columns.js";
6
+ import { stateDiagnostics } from "../table/state-codes.js";
3
7
  import {
4
8
  callFetcher,
5
9
  checkFetcher,
@@ -10,6 +14,7 @@ import {
10
14
  sameParams
11
15
  } from "./fetcher.js";
12
16
  import { asyncRequests } from "./requests.js";
17
+ keepDiagnostics(stateDiagnostics);
13
18
  var serverSource = (host) => {
14
19
  const requests = host.use(asyncRequests);
15
20
  const serverFeatures = host.features.filter(isServer);
@@ -59,18 +64,64 @@ var serverSource = (host) => {
59
64
  host.ingest(result.rows);
60
65
  return true;
61
66
  }
67
+ let sortIn;
68
+ let sortCols;
69
+ let sortOut = [];
70
+ function sortOf(by) {
71
+ const columns = host.options().columns;
72
+ if (by !== sortIn || columns !== sortCols) {
73
+ sortIn = by;
74
+ sortCols = columns;
75
+ const known = columns?.length ? resolveColumns(columns).list.filter((c) => c.def.sortable !== false).map((c) => c.id) : void 0;
76
+ const out = (Array.isArray(by) ? by : []).flatMap((e) => {
77
+ const id = e?.id;
78
+ if (typeof id !== "string") return [];
79
+ if (known && !known.includes(id)) {
80
+ if (process.env.NODE_ENV !== "production") host.emit("DK_STATE_UNKNOWN_KEY", { slice: "sorting", key: id, known });
81
+ return [];
82
+ }
83
+ return [{ id, desc: e.desc === true }];
84
+ });
85
+ const same = Array.isArray(by) && by.length === out.length && out.every((e, i) => {
86
+ const b = by[i];
87
+ return b.id === e.id && b.desc === e.desc && Object.keys(b).length === 2;
88
+ });
89
+ sortOut = same ? by : out;
90
+ }
91
+ return sortOut;
92
+ }
93
+ const paramsOf = () => {
94
+ const p = fetchParams(serverFeatures, host.state());
95
+ if (p.sort) p.sort = sortOf(p.sort);
96
+ return p;
97
+ };
98
+ let later;
99
+ let settleLater;
100
+ host.intercept({
101
+ name: "serverSource",
102
+ on: ["table:destroy"],
103
+ intercept(_ctx, next) {
104
+ settleLater?.({ status: "superseded" });
105
+ return next();
106
+ }
107
+ });
62
108
  function sync(force = false) {
63
109
  const fetcher = host.options().fetcher;
64
110
  if (typeof fetcher !== "function" || host.destroyed()) return;
65
- const params = fetchParams(serverFeatures, host.state());
66
- if (!force && fetched && sameParams(fetched, params)) return;
67
- if (requests.defer("fetcher")) return;
111
+ const params = paramsOf();
112
+ if (!force && !settleLater && fetched && sameParams(fetched, params)) return;
113
+ if (requests.defer("fetcher")) {
114
+ if (force) later ??= new Promise((resolve) => settleLater = resolve);
115
+ return later;
116
+ }
68
117
  fetched = params;
118
+ const waiting = settleLater;
119
+ settleLater = later = void 0;
69
120
  let result;
70
121
  const done = () => ({
71
122
  status: result ?? (host.destroyed() ? "superseded" : "error")
72
123
  });
73
- return requests.request("fetcher", (signal) => callFetcher(fetcher, params, signal), {
124
+ const out = requests.request("fetcher", (signal) => callFetcher(fetcher, params, signal), {
74
125
  params,
75
126
  onSettle: (value, outcome) => {
76
127
  result = outcome === "superseded" || outcome === "aborted" ? "superseded" : "error";
@@ -78,11 +129,13 @@ var serverSource = (host) => {
78
129
  }
79
130
  // strict: the DatakableError was reported by the hub; the status is 'error' (apply).
80
131
  }).then(done, done);
132
+ waiting?.(out);
133
+ return out;
81
134
  }
82
135
  const options = host.options();
83
136
  checkFetcher(host.features, options.fetcher, host.name);
84
137
  if (options.initialData !== void 0 && options.data === void 0) {
85
- fetched = fetchParams(serverFeatures, host.state());
138
+ fetched = paramsOf();
86
139
  rowCount = options.rowCount ?? options.initialData.length;
87
140
  }
88
141
  return {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/source/server.ts"],"sourcesContent":["import { errorName } from '../intercept/classify'\nimport type { ExtensionFactory, TableExtension, TableHost } from '../table/internals'\nimport type { AsyncStatus } from './async-control'\nimport {\n callFetcher,\n checkFetcher,\n checkResponse,\n type Fetcher,\n FetchFailure,\n type FetchKey,\n type FetchOutcome,\n fetchParams,\n isServer,\n sameParams,\n} from './fetcher'\nimport { asyncRequests } from './requests'\n\n/** The server source of one table (§7.1): the fetcher's requests, its status and row count. */\nexport interface ServerSource extends TableExtension {\n /**\n * Starts a fetcher request when the server-mode state differs from the last request's (or\n * `force`: `refetch()`). Resolves with the outcome; never rejects.\n */\n sync(force?: boolean): Promise<FetchOutcome> | undefined\n /** `rowCount` of the last applied fetcher result (§6.5). */\n rowCount(): number | undefined\n /** `setOptions({ fetcher })`, before anything changes: `DK_FETCHER_WITHOUT_SERVER_MODE`. */\n check(fetcher: unknown): void\n /** A new fetcher reference: it runs at once, even with the same params (flush → sync). */\n reset(): void\n}\n\n/**\n * The server source as a table extension (changed 2026-10-13 for §9.3): it comes with\n * `withFetcher(fetcher)`, so a table without a fetcher never bundles it.\n */\nexport const serverSource: ExtensionFactory<ServerSource> = (host: TableHost) => {\n const requests = host.use(asyncRequests)\n const serverFeatures = host.features.filter(isServer)\n /** The latest fetcher request failed or returned a bad response: 'error' until one applies. */\n let failed = false\n /** `rowCount` of the last applied fetcher result (§6.5). */\n let rowCount: number | undefined\n /** Params of the last fetcher request; a flush with other params starts a new one (§7.1). */\n let fetched: FetchKey | undefined\n\n function fail() {\n if (failed) return\n failed = true\n host.touch()\n }\n\n /**\n * Applies a fetcher outcome; only the latest request reaches `'applied'` (asyncControl). `true`\n * when its rows were applied.\n */\n function apply(value: unknown, outcome: AsyncStatus): boolean {\n if (outcome === 'superseded') {\n host.emit('DK_FETCH_ABORTED', {})\n return false\n }\n if (outcome === 'aborted') return false\n // 'error' / 'timeout': already reported by the errorBoundary / asyncControl.\n if (outcome !== 'applied') {\n fail()\n return false\n }\n if (value instanceof FetchFailure) {\n fail()\n const name = errorName(value.error)\n host.emit(\n 'DK_FETCH_FAILED',\n { ...(name === undefined ? {} : { errorName: name }), hadRows: host.loaded() },\n { cause: value.error },\n )\n return false\n }\n const bad = checkResponse(\n value,\n serverFeatures.some((f) => f.stage === 'paginate'),\n )\n if (bad) {\n fail()\n host.emit('DK_FETCH_BAD_RESPONSE', bad)\n return false\n }\n if (failed) {\n failed = false\n host.touch()\n }\n const result = value as { rows: readonly unknown[]; rowCount?: number }\n rowCount = result.rowCount ?? result.rows.length\n host.ingest(result.rows)\n return true\n }\n\n function sync(force = false): Promise<FetchOutcome> | undefined {\n const fetcher = host.options().fetcher as Fetcher<unknown> | undefined\n if (typeof fetcher !== 'function' || host.destroyed()) return\n const params = fetchParams(serverFeatures, host.state())\n if (!force && fetched && sameParams(fetched, params)) return\n // Deferred (SSR, §7.2): no request until startTable; then the latest params are fetched.\n if (requests.defer('fetcher')) return\n fetched = params\n let result: FetchOutcome['status'] | undefined\n const done = (): FetchOutcome => ({\n status: result ?? (host.destroyed() ? 'superseded' : 'error'),\n })\n return requests\n .request('fetcher', (signal) => callFetcher(fetcher, params, signal), {\n params,\n onSettle: (value, outcome) => {\n result = outcome === 'superseded' || outcome === 'aborted' ? 'superseded' : 'error'\n if (apply(value, outcome)) result = 'applied'\n },\n // strict: the DatakableError was reported by the hub; the status is 'error' (apply).\n })\n .then(done, done)\n }\n\n const options = host.options()\n checkFetcher(host.features, options.fetcher, host.name)\n // initialData answers the initial server state (§7.2): no first request, its total as rowCount.\n if (options.initialData !== undefined && options.data === undefined) {\n fetched = fetchParams(serverFeatures, host.state())\n rowCount = options.rowCount ?? options.initialData.length\n }\n\n return {\n sync,\n rowCount: () => rowCount,\n status: () => (failed ? 'error' : undefined),\n check: (fetcher) => checkFetcher(host.features, fetcher, host.name, 'setOptions'),\n reset() {\n fetched = undefined\n },\n }\n}\n"],"mappings":";AAAA,SAAS,iBAAiB;AAG1B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB;AAqBvB,IAAM,eAA+C,CAAC,SAAoB;AAC/E,QAAM,WAAW,KAAK,IAAI,aAAa;AACvC,QAAM,iBAAiB,KAAK,SAAS,OAAO,QAAQ;AAEpD,MAAI,SAAS;AAEb,MAAI;AAEJ,MAAI;AAEJ,WAAS,OAAO;AACd,QAAI,OAAQ;AACZ,aAAS;AACT,SAAK,MAAM;AAAA,EACb;AAMA,WAAS,MAAM,OAAgB,SAA+B;AAC5D,QAAI,YAAY,cAAc;AAC5B,WAAK,KAAK,oBAAoB,CAAC,CAAC;AAChC,aAAO;AAAA,IACT;AACA,QAAI,YAAY,UAAW,QAAO;AAElC,QAAI,YAAY,WAAW;AACzB,WAAK;AACL,aAAO;AAAA,IACT;AACA,QAAI,iBAAiB,cAAc;AACjC,WAAK;AACL,YAAM,OAAO,UAAU,MAAM,KAAK;AAClC,WAAK;AAAA,QACH;AAAA,QACA,EAAE,GAAI,SAAS,SAAY,CAAC,IAAI,EAAE,WAAW,KAAK,GAAI,SAAS,KAAK,OAAO,EAAE;AAAA,QAC7E,EAAE,OAAO,MAAM,MAAM;AAAA,MACvB;AACA,aAAO;AAAA,IACT;AACA,UAAM,MAAM;AAAA,MACV;AAAA,MACA,eAAe,KAAK,CAAC,MAAM,EAAE,UAAU,UAAU;AAAA,IACnD;AACA,QAAI,KAAK;AACP,WAAK;AACL,WAAK,KAAK,yBAAyB,GAAG;AACtC,aAAO;AAAA,IACT;AACA,QAAI,QAAQ;AACV,eAAS;AACT,WAAK,MAAM;AAAA,IACb;AACA,UAAM,SAAS;AACf,eAAW,OAAO,YAAY,OAAO,KAAK;AAC1C,SAAK,OAAO,OAAO,IAAI;AACvB,WAAO;AAAA,EACT;AAEA,WAAS,KAAK,QAAQ,OAA0C;AAC9D,UAAM,UAAU,KAAK,QAAQ,EAAE;AAC/B,QAAI,OAAO,YAAY,cAAc,KAAK,UAAU,EAAG;AACvD,UAAM,SAAS,YAAY,gBAAgB,KAAK,MAAM,CAAC;AACvD,QAAI,CAAC,SAAS,WAAW,WAAW,SAAS,MAAM,EAAG;AAEtD,QAAI,SAAS,MAAM,SAAS,EAAG;AAC/B,cAAU;AACV,QAAI;AACJ,UAAM,OAAO,OAAqB;AAAA,MAChC,QAAQ,WAAW,KAAK,UAAU,IAAI,eAAe;AAAA,IACvD;AACA,WAAO,SACJ,QAAQ,WAAW,CAAC,WAAW,YAAY,SAAS,QAAQ,MAAM,GAAG;AAAA,MACpE;AAAA,MACA,UAAU,CAAC,OAAO,YAAY;AAC5B,iBAAS,YAAY,gBAAgB,YAAY,YAAY,eAAe;AAC5E,YAAI,MAAM,OAAO,OAAO,EAAG,UAAS;AAAA,MACtC;AAAA;AAAA,IAEF,CAAC,EACA,KAAK,MAAM,IAAI;AAAA,EACpB;AAEA,QAAM,UAAU,KAAK,QAAQ;AAC7B,eAAa,KAAK,UAAU,QAAQ,SAAS,KAAK,IAAI;AAEtD,MAAI,QAAQ,gBAAgB,UAAa,QAAQ,SAAS,QAAW;AACnE,cAAU,YAAY,gBAAgB,KAAK,MAAM,CAAC;AAClD,eAAW,QAAQ,YAAY,QAAQ,YAAY;AAAA,EACrD;AAEA,SAAO;AAAA,IACL;AAAA,IACA,UAAU,MAAM;AAAA,IAChB,QAAQ,MAAO,SAAS,UAAU;AAAA,IAClC,OAAO,CAAC,YAAY,aAAa,KAAK,UAAU,SAAS,KAAK,MAAM,YAAY;AAAA,IAChF,QAAQ;AACN,gBAAU;AAAA,IACZ;AAAA,EACF;AACF;","names":[]}
1
+ {"version":3,"sources":["../../src/source/server.ts"],"sourcesContent":["import { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport { errorName } from '../intercept/classify'\nimport type { Interceptor } from '../intercept/define'\nimport type { OpName } from '../intercept/operations'\nimport { resolveColumns } from '../pipeline/columns'\nimport type { ExtensionFactory, TableExtension, TableHost } from '../table/internals'\nimport { stateDiagnostics } from '../table/state-codes'\nimport type { AsyncStatus } from './async-control'\nimport {\n callFetcher,\n checkFetcher,\n checkResponse,\n type Fetcher,\n FetchFailure,\n type FetchKey,\n type FetchOutcome,\n type FetchParams,\n fetchParams,\n isServer,\n sameParams,\n} from './fetcher'\nimport { asyncRequests } from './requests'\n\n/** The server source of one table (§7.1): the fetcher's requests, its status and row count. */\nexport interface ServerSource extends TableExtension {\n /**\n * Starts a fetcher request when the server-mode state differs from the last request's (or\n * `force`: `refetch()`). Resolves with the outcome; never rejects. Deferred (`createDeferred`),\n * `force` resolves with the request that runs after `startTable` (`'superseded'` when the table\n * is destroyed first, #90).\n */\n sync(force?: boolean): Promise<FetchOutcome> | undefined\n /** `rowCount` of the last applied fetcher result (§6.5). */\n rowCount(): number | undefined\n /** `setOptions({ fetcher })`, before anything changes: `DK_FETCHER_WITHOUT_SERVER_MODE`. */\n check(fetcher: unknown): void\n /** A new fetcher reference: it runs at once, even with the same params (flush → sync). */\n reset(): void\n}\n\n/**\n * The server source as a table extension (changed 2026-10-13 for §9.3): it comes with\n * `withFetcher(fetcher)`, so a table without a fetcher never bundles it.\n */\n// DK_STATE_UNKNOWN_KEY for a restored sort id that names no column (#100).\nkeepDiagnostics(stateDiagnostics)\n\ntype Sort = NonNullable<FetchParams['sort']>\n\nexport const serverSource: ExtensionFactory<ServerSource> = (host: TableHost) => {\n const requests = host.use(asyncRequests)\n const serverFeatures = host.features.filter(isServer)\n /** The latest fetcher request failed or returned a bad response: 'error' until one applies. */\n let failed = false\n /** `rowCount` of the last applied fetcher result (§6.5). */\n let rowCount: number | undefined\n /** Params of the last fetcher request; a flush with other params starts a new one (§7.1). */\n let fetched: FetchKey | undefined\n\n function fail() {\n if (failed) return\n failed = true\n host.touch()\n }\n\n /**\n * Applies a fetcher outcome; only the latest request reaches `'applied'` (asyncControl). `true`\n * when its rows were applied.\n */\n function apply(value: unknown, outcome: AsyncStatus): boolean {\n if (outcome === 'superseded') {\n host.emit('DK_FETCH_ABORTED', {})\n return false\n }\n if (outcome === 'aborted') return false\n // 'error' / 'timeout': already reported by the errorBoundary / asyncControl.\n if (outcome !== 'applied') {\n fail()\n return false\n }\n if (value instanceof FetchFailure) {\n fail()\n const name = errorName(value.error)\n host.emit(\n 'DK_FETCH_FAILED',\n { ...(name === undefined ? {} : { errorName: name }), hadRows: host.loaded() },\n { cause: value.error },\n )\n return false\n }\n const bad = checkResponse(\n value,\n serverFeatures.some((f) => f.stage === 'paginate'),\n )\n if (bad) {\n fail()\n host.emit('DK_FETCH_BAD_RESPONSE', bad)\n return false\n }\n if (failed) {\n failed = false\n host.touch()\n }\n const result = value as { rows: readonly unknown[]; rowCount?: number }\n rowCount = result.rowCount ?? result.rows.length\n host.ingest(result.rows)\n return true\n }\n\n /** The last sort slice, its columns and the entries sent for them: same input, same array. */\n let sortIn: unknown\n let sortCols: unknown\n let sortOut: Sort = []\n\n /**\n * The sort entries sent to the fetcher (#100): restored state is untrusted. Only\n * `{ id: string, desc: boolean }`; with `columns`, an id that names no sortable column is\n * dropped (in development reported as `DK_STATE_UNKNOWN_KEY`, as columnFilters does).\n */\n function sortOf(by: unknown): Sort {\n const columns = host.options().columns\n if (by !== sortIn || columns !== sortCols) {\n sortIn = by\n sortCols = columns\n const known = columns?.length\n ? resolveColumns(columns)\n .list.filter((c) => (c.def as { sortable?: unknown }).sortable !== false)\n .map((c) => c.id)\n : undefined\n const out = (Array.isArray(by) ? by : []).flatMap((e) => {\n const id = e?.id\n if (typeof id !== 'string') return []\n if (known && !known.includes(id)) {\n if ((process.env.NODE_ENV !== \"production\")) host.emit('DK_STATE_UNKNOWN_KEY', { slice: 'sorting', key: id, known })\n return []\n }\n return [{ id, desc: e.desc === true }]\n })\n // Unchanged: the slice itself, so the same state never refetches.\n // Field by field, never JSON.stringify (a deep restored entry would overflow it, #103).\n const same =\n Array.isArray(by) &&\n by.length === out.length &&\n out.every((e, i) => {\n const b = by[i]\n return b.id === e.id && b.desc === e.desc && Object.keys(b).length === 2\n })\n sortOut = same ? (by as Sort) : out\n }\n return sortOut\n }\n\n const paramsOf = () => {\n const p = fetchParams(serverFeatures, host.state())\n if (p.sort) p.sort = sortOf(p.sort)\n return p\n }\n\n /** `refetch()` while deferred (#90): settled with the first request after `startTable`. */\n let later: Promise<FetchOutcome> | undefined\n let settleLater: ((outcome: FetchOutcome | Promise<FetchOutcome>) => void) | undefined\n\n host.intercept({\n name: 'serverSource',\n on: ['table:destroy'],\n intercept(_ctx, next) {\n settleLater?.({ status: 'superseded' })\n return next()\n },\n } as Interceptor<OpName>)\n\n function sync(force = false): Promise<FetchOutcome> | undefined {\n const fetcher = host.options().fetcher as Fetcher<unknown> | undefined\n if (typeof fetcher !== 'function' || host.destroyed()) return\n const params = paramsOf()\n if (!force && !settleLater && fetched && sameParams(fetched, params)) return\n // Deferred (SSR, §7.2): no request until startTable; then the latest params are fetched.\n if (requests.defer('fetcher')) {\n if (force) later ??= new Promise((resolve) => (settleLater = resolve))\n return later\n }\n fetched = params\n const waiting = settleLater\n settleLater = later = undefined\n let result: FetchOutcome['status'] | undefined\n const done = (): FetchOutcome => ({\n status: result ?? (host.destroyed() ? 'superseded' : 'error'),\n })\n const out = requests\n .request('fetcher', (signal) => callFetcher(fetcher, params, signal), {\n params,\n onSettle: (value, outcome) => {\n result = outcome === 'superseded' || outcome === 'aborted' ? 'superseded' : 'error'\n if (apply(value, outcome)) result = 'applied'\n },\n // strict: the DatakableError was reported by the hub; the status is 'error' (apply).\n })\n .then(done, done)\n waiting?.(out)\n return out\n }\n\n const options = host.options()\n checkFetcher(host.features, options.fetcher, host.name)\n // initialData answers the initial server state (§7.2): no first request, its total as rowCount.\n if (options.initialData !== undefined && options.data === undefined) {\n fetched = paramsOf()\n rowCount = options.rowCount ?? options.initialData.length\n }\n\n return {\n sync,\n rowCount: () => rowCount,\n status: () => (failed ? 'error' : undefined),\n check: (fetcher) => checkFetcher(host.features, fetcher, host.name, 'setOptions'),\n reset() {\n fetched = undefined\n },\n }\n}\n"],"mappings":"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","names":[]}
@@ -49,13 +49,15 @@ var import_codes2 = require("./codes.cjs");
49
49
  var import_data_mutation = require("./data-mutation.cjs");
50
50
  var import_internals = require("./internals.cjs");
51
51
  var import_read_once = require("./read-once.cjs");
52
+ var import_state_codes = require("./state-codes.cjs");
52
53
  var import_state_feedback = require("./state-feedback.cjs");
53
54
  var import_types = require("./types.cjs");
54
55
  (0, import_catalog.keepDiagnostics)(
55
56
  import_codes2.tableDiagnostics,
56
57
  import_data_mutation.dataMutationDiagnostics,
57
58
  import_state_feedback.stateFeedbackDiagnostics,
58
- import_codes.optionDiagnostics
59
+ import_codes.optionDiagnostics,
60
+ import_state_codes.stateDiagnostics
59
61
  );
60
62
  var EMPTY = [];
61
63
  var RANK = [
@@ -68,17 +70,21 @@ var RANK = [
68
70
  ];
69
71
  var isThenable = (v) => v != null && typeof v.then === "function";
70
72
  var deepFrozen = process.env.NODE_ENV !== "production" ? /* @__PURE__ */ new WeakSet() : void 0;
71
- function deepFreeze(v) {
72
- if (v === null || typeof v !== "object" || deepFrozen?.has(v)) return;
73
- const isArray = Array.isArray(v);
74
- if (!isArray) {
75
- const proto = Object.getPrototypeOf(v);
76
- if (proto !== Object.prototype && proto !== null) return;
77
- }
78
- deepFrozen?.add(v);
79
- Object.freeze(v);
80
- if (isArray) for (let i = 0; i < v.length; i++) deepFreeze(v[i]);
81
- else for (const k in v) deepFreeze(v[k]);
73
+ function deepFreeze(root) {
74
+ const stack = [root];
75
+ while (stack.length > 0) {
76
+ const v = stack.pop();
77
+ if (v === null || typeof v !== "object" || deepFrozen?.has(v)) continue;
78
+ const isArray = Array.isArray(v);
79
+ if (!isArray) {
80
+ const proto = Object.getPrototypeOf(v);
81
+ if (proto !== Object.prototype && proto !== null) continue;
82
+ }
83
+ deepFrozen?.add(v);
84
+ Object.freeze(v);
85
+ if (isArray) for (let i = 0; i < v.length; i++) stack.push(v[i]);
86
+ else for (const k in v) stack.push(v[k]);
87
+ }
82
88
  }
83
89
  var freeze = (s) => {
84
90
  if (process.env.NODE_ENV !== "production") deepFreeze(s);
@@ -96,7 +102,7 @@ function createTable(initialOptions) {
96
102
  let ingestFailed = false;
97
103
  let validatingSeq = 0;
98
104
  let schemaOutcome;
99
- let initialInput = options.data === void 0 ? options.initialData : void 0;
105
+ let initialInput = options.data == null ? options.initialData : void 0;
100
106
  let initialRows;
101
107
  let deferring = import_internals.deferral.depth > 0;
102
108
  const extensions = /* @__PURE__ */ new Map();
@@ -207,10 +213,15 @@ function createTable(initialOptions) {
207
213
  trigger = prev;
208
214
  }
209
215
  }
216
+ function protoKey(k) {
217
+ if (k !== import_state_codes.PROTO_KEY) return false;
218
+ hub.emit("DK_STATE_UNKNOWN_KEY", { slice: "", key: k, known: EMPTY });
219
+ return true;
220
+ }
210
221
  function controlledKeys(state) {
211
222
  const keys = /* @__PURE__ */ new Set();
212
223
  if (state) {
213
- for (const k of Object.keys(state)) if (state[k] !== void 0) keys.add(k);
224
+ for (const k of Object.keys(state)) if (state[k] !== void 0 && !protoKey(k)) keys.add(k);
214
225
  }
215
226
  return keys;
216
227
  }
@@ -257,6 +268,7 @@ function createTable(initialOptions) {
257
268
  let changes;
258
269
  let dropped;
259
270
  for (const k of Object.keys(partial)) {
271
+ if (protoKey(k)) continue;
260
272
  const v = partial[k];
261
273
  if (Object.is(snapshot[k], v)) continue;
262
274
  if (controlled.has(k)) {
@@ -459,7 +471,7 @@ function createTable(initialOptions) {
459
471
  const initial = fetched === void 0 && initialInput !== void 0;
460
472
  const input = fetched ?? (initial ? initialInput : options.data);
461
473
  initialInput = void 0;
462
- const given = input !== void 0;
474
+ const given = input != null;
463
475
  const source = fetched ? "fetch" : "data-change";
464
476
  if (validatingSeq !== 0) {
465
477
  validatingSeq = 0;
@@ -694,11 +706,9 @@ function createTable(initialOptions) {
694
706
  });
695
707
  controlled = controlledKeys(options.state);
696
708
  if (process.env.NODE_ENV !== "production") feedback?.settle(options.state, controlled);
697
- snapshot = overlay(
698
- freeze(
699
- rt ? rt.initialSlices(features, options.initialState, hub.emit) : { ...options.initialState }
700
- )
701
- );
709
+ const restored = { ...options.initialState };
710
+ if (Object.hasOwn(restored, import_state_codes.PROTO_KEY) && protoKey(import_state_codes.PROTO_KEY)) delete restored[import_state_codes.PROTO_KEY];
711
+ snapshot = overlay(freeze(rt ? rt.initialSlices(features, restored, hub.emit) : restored));
702
712
  notified = snapshot;
703
713
  rt?.installApis(features, {
704
714
  table,
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/table/create-table.ts"],"sourcesContent":["import { optionDiagnostics } from '../catalog/codes'\nimport { validateOptionChange, validateOptions } from '../catalog/validator'\nimport { DatakableError, defaultPhase, throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport { type ExplainHost, explainRow, explainTable } from '../diagnostics/explain'\nimport { createDiagnostics } from '../diagnostics/hub'\nimport { pathsOverlap, type RedactionOptions } from '../diagnostics/redact'\nimport { tracer } from '../diagnostics/tracer'\nimport type { Trigger } from '../diagnostics/types'\nimport { runtimeFor } from '../feature/runtime'\nimport type { AnyFeature, ApiOf, SliceUpdater, TableStateFor } from '../feature/types'\nimport { createDataChecks } from '../ingest/data-checks'\nimport { createDerivedColumns } from '../ingest/derive-columns'\nimport type { SchemaOutcome } from '../ingest/schema'\nimport { SCHEMA_INGEST, type TableSchema } from '../ingest/schema-brand'\nimport type { InvalidRowsMode } from '../ingest/schema-codes'\nimport type { StandardSchemaV1 } from '../ingest/standard-schema'\nimport { errorBoundary } from '../intercept/boundary'\nimport { callUser, errorName } from '../intercept/classify'\nimport { type ContextBase, createContext } from '../intercept/context'\nimport type { Interceptor } from '../intercept/define'\nimport { FAILED, FALLBACK } from '../intercept/fallbacks'\nimport type { OpInput, OpName, OpResult } from '../intercept/operations'\nimport { type Core, createInterceptorRuntime } from '../intercept/runtime'\nimport { createPipeline } from '../pipeline/runner'\nimport type { RowModel, RowModelStatus } from '../pipeline/types'\nimport { checkModeOrder, type FetchOutcome } from '../source/fetcher'\nimport type { ServerSource } from '../source/server'\nimport { SERVER_SOURCE, type ServerFetcher } from '../source/server-brand'\nimport { checkVersions } from '../versioning/registry'\nimport { tableDiagnostics } from './codes'\nimport { createDataMutationCheck, dataMutationDiagnostics } from './data-mutation'\nimport {\n deferral,\n type ExtensionFactory,\n setTableInternals,\n type TableExtension,\n type TableHost,\n} from './internals'\nimport { keepReadOnce } from './read-once'\nimport { createStateFeedbackCheck, stateFeedbackDiagnostics } from './state-feedback'\nimport {\n type ControlledState,\n type Listener,\n type Table,\n type TableOptions,\n type TableState,\n UPDATE_DEPTH_LIMIT,\n type Updater,\n} from './types'\n\nkeepDiagnostics(\n tableDiagnostics,\n dataMutationDiagnostics,\n stateFeedbackDiagnostics,\n optionDiagnostics,\n)\n\nconst EMPTY: readonly never[] = []\n\n/** §6.6 status precedence, lowest first: the table shows the highest of its sources. */\nconst RANK: readonly RowModelStatus[] = [\n 'idle',\n 'pending',\n 'validating',\n 'searching',\n 'fetching',\n 'error',\n]\n\nconst isThenable = (v: unknown): v is PromiseLike<unknown> =>\n v != null && typeof (v as { then?: unknown }).then === 'function'\n\n/** Objects already deep-frozen (dev): an unchanged slice is not walked again on the next commit. */\nconst deepFrozen = (process.env.NODE_ENV !== \"production\") ? new WeakSet<object>() : undefined\n\n/**\n * Freezes plain objects and arrays reachable from `v` (dev). Class instances (Date, Map, typed\n * arrays, user classes) are left alone: freezing them would break their own methods.\n */\nfunction deepFreeze(v: unknown): void {\n if (v === null || typeof v !== 'object' || deepFrozen?.has(v)) return\n const isArray = Array.isArray(v)\n if (!isArray) {\n const proto = Object.getPrototypeOf(v)\n if (proto !== Object.prototype && proto !== null) return\n }\n deepFrozen?.add(v)\n Object.freeze(v)\n if (isArray) for (let i = 0; i < v.length; i++) deepFreeze(v[i])\n else for (const k in v) deepFreeze((v as Record<string, unknown>)[k])\n}\n\n/** Snapshots and their slices are immutable in development (#20); production skips the walk. */\nconst freeze = <S extends object>(s: S): S => {\n if ((process.env.NODE_ENV !== \"production\")) deepFreeze(s)\n return s\n}\n\n/** The row type: the schema output with a `schema` (§5.1), else `T`. */\nexport type SchemaRow<T, Sch> = [Sch] extends [TableSchema] ? StandardSchemaV1.InferOutput<Sch> : T\n\n/**\n * `createTable` options: with a `schema`, the row type is its output and `data` is the raw input\n * (`unknown[]`, e.g. parsed JSON), validated per row.\n */\nexport type CreateTableOptions<T, S extends TableState, Sch, M extends InvalidRowsMode> = Omit<\n TableOptions<SchemaRow<T, Sch>, S>,\n 'data' | 'schema' | 'invalidRows' | 'fetcher' | 'initialData'\n> & {\n data?: readonly ([Sch] extends [TableSchema] ? unknown : T)[]\n /** With a schema, the raw rows (validated like `data`). */\n initialData?: readonly ([Sch] extends [TableSchema] ? unknown : T)[]\n /** With a schema, the fetcher returns raw rows (validated like `data`). */\n fetcher?: ServerFetcher<[Sch] extends [TableSchema] ? unknown : T>\n // Without an inferred schema (explicit type arguments, a `TableOptions<T>` object) these keep\n // their `TableOptions` types.\n schema?: [Sch] extends [TableSchema] ? Sch : TableSchema<unknown, T>\n invalidRows?: [Sch] extends [TableSchema] ? M : InvalidRowsMode\n}\n\n/** Column id: `key` for key columns, `id` for accessor columns. */\nconst columnId = (c: { key?: unknown; id?: unknown }): unknown => c.key ?? c.id\n\n/**\n * Creates the table store (§3.2): immutable state snapshots, controlled slices, isolated listeners,\n * a re-entrancy guard and `destroy()`. Every unit of work runs as an operation (§3.4) through the\n * table's interceptor runtime, with the errorBoundary outermost and diagnostics on a per-table hub.\n *\n * `ctx.where` is always a constant option path or method name (`options`, `options.data`,\n * `setState`, `destroy`): it reaches fingerprints, docs URLs and issue links unredacted, so it must\n * never carry row keys or cell values.\n */\nexport function createTable<\n T,\n S extends TableState = never,\n const Fs extends readonly AnyFeature[] = [],\n const Sch extends TableSchema | undefined = undefined,\n const M extends InvalidRowsMode = 'drop',\n>(\n options: CreateTableOptions<T, TableStateFor<S, Fs, SchemaRow<T, Sch>>, Sch, M> & {\n features?: Fs\n },\n): Table<\n SchemaRow<T, Sch>,\n TableStateFor<S, Fs, SchemaRow<T, Sch>>,\n M,\n [Sch] extends [TableSchema] ? unknown : T\n> &\n ApiOf<Fs, SchemaRow<T, Sch>>\nexport function createTable<T, S extends TableState>(\n initialOptions: TableOptions<T, S>,\n): Table<T, S> {\n let options: TableOptions<T, S> = { ...initialOptions }\n let destroyed = false\n let trigger: Trigger = 'init'\n /** Pipeline run id; each `pipeline:run` increments it. */\n let run = 0\n let data: readonly T[] = EMPTY\n let ingestSeq = 0\n /** Data given by the user has been applied once (`RowModel.isInitialLoad`, §6.6). */\n let loaded = false\n /** The last `data:ingest` failed (op fallback): `status: 'error'` until one succeeds (§6.6). */\n let ingestFailed = false\n /** The ingest whose async schema validation is in flight (`status: 'validating'`); 0: none. */\n let validatingSeq = 0\n /** Rows of the current data that failed the schema (`getInvalidRows`, §5.1). */\n let schemaOutcome: SchemaOutcome | undefined\n /**\n * SSR (§7.2): `options.initialData` until the creation ingest read it (`undefined` with `data`),\n * then its ingested rows while they are the table's data (`initialRows`).\n */\n let initialInput = options.data === undefined ? options.initialData : undefined\n let initialRows: readonly unknown[] | undefined\n /** Created inside `createDeferred` (§7.2): async work waits for `startTable`. */\n let deferring = deferral.depth > 0\n /**\n * Opt-in parts of the store (`TableInternals.use`): the async request machinery and the server\n * source. A table without an async source creates none (§9.3).\n */\n const extensions = new Map<ExtensionFactory<TableExtension>, TableExtension>()\n /** The server source (`withFetcher`, §7.1), once a fetcher was given. */\n let server: ServerSource | undefined\n\n let controlled = new Set<string>()\n let snapshot: S\n /** The snapshot listeners last saw (`prev` of the next notification). */\n let notified: S\n /** A committed change (state or data) not yet notified. */\n let pending = false\n let notifying = false\n let rounds = 0\n let loopReported = false\n let current: number | undefined\n let listenerSeq = 0\n const listeners = new Map<number, Listener<S>>()\n /** Depth of feature API calls in progress: listeners are notified when the outermost returns. */\n let apiDepth = 0\n /** Data, state or columns changed since the row model was computed. */\n let rowModelDirty = true\n /** Diagnostic context (§8.1): the data mode of each pipeline feature (set once features load). */\n const modes: Record<string, 'client' | 'server'> = {}\n\n const table: Table<T, S> = {\n getState: () => snapshot,\n setState,\n subscribe,\n setOptions,\n getOptions: () => options,\n getData: () => data,\n // Core method: on the literal before installApis, so no feature can take the name.\n getRowModel,\n getInvalidRows: () => schemaOutcome?.invalid ?? EMPTY,\n getDiagnostics: () => hub.getDiagnostics(),\n // Core methods (§8.4), read-only: also on the literal before installApis.\n explain: () => explainTable(explainHost),\n explainRow: (key) => explainRow(explainHost, key),\n refetch,\n destroy,\n }\n\n // Redaction (§8.2): `diagnostics.redact` gives the level or a custom rule; column defs give the\n // sensitive columns and whether the rowKey column is sensitive. Both are read per emit, so\n // `setOptions({ columns })` is followed.\n const redactOption = options.diagnostics?.redact\n const redaction: RedactionOptions = {\n ...(typeof redactOption === 'string' ? { level: redactOption } : {}),\n ...(typeof redactOption === 'function' ? { redact: redactOption } : {}),\n sensitiveColumns,\n // A rowKey path into (or above) a sensitive column reads its data too (#45).\n rowKeySensitive: () => {\n const k = options.rowKey\n return typeof k === 'string' && sensitiveColumns().some((c) => pathsOverlap(k, c))\n },\n }\n const hub = createDiagnostics({\n ...(options.name === undefined ? {} : { name: options.name }),\n table,\n onDiagnostic: (d) => options.onDiagnostic?.(d),\n ...(options.strict === undefined ? {} : { strict: options.strict }),\n getContext: () => ({ trigger, run, mode: modes }),\n getDataRef: () => data,\n redaction,\n })\n // Option validator (§3.4, `table:init`), development only: before anything reads the options.\n // Invalid values throw DK_INVALID_OPTION; unknown / no-effect options are reported on the hub.\n if ((process.env.NODE_ENV !== \"production\")) validateOptions(options, { table: hub.table, emit: hub.emit })\n // Features (§3.3) are read once, at creation. `features` is the listed order (API install, conflict\n // reports); `pipeline` is stage order for the runner. Duplicates throw here (config error).\n const features: readonly AnyFeature[] = options.features ?? EMPTY\n // The feature runtime comes with the features (`defineFeature`): none for a table without.\n const rt = runtimeFor(features)\n const pipeline = rt ? rt.orderFeatures(features, hub.table) : EMPTY\n // Data modes (§7.1): DK_MODE_ORDER (a config error, development). A fetcher without a server-mode\n // feature (DK_FETCHER_WITHOUT_SERVER_MODE) is checked by the server source.\n if ((process.env.NODE_ENV !== \"production\")) checkModeOrder(pipeline, hub.table)\n for (const f of pipeline) if (f.stage !== 'none') modes[f.name] = f.mode ?? 'client'\n // Extension interceptors come first (asyncControl, one per table, installed with the first async\n // source: user / feature interceptors and the core see its signal); the boundary stays\n // outermost. Feature interceptors (pipeline order) come next, then the user's.\n const front: Interceptor<OpName>[] = []\n const featureInterceptors = pipeline.flatMap((f) => f.interceptors ?? EMPTY)\n // The tracer (§3.4, explain timings) is development-only: `(process.env.NODE_ENV !== \"production\")` folds to `false` in production\n // builds, which drops it from the bundle; there it is opt-in with `interceptors: [tracer()]`.\n const traced = (process.env.NODE_ENV !== \"production\") ? [tracer() as Interceptor<OpName>] : EMPTY\n const withFront = (list: readonly Interceptor<OpName>[] | undefined) => [\n ...front,\n ...traced,\n ...featureInterceptors,\n ...(list ?? EMPTY),\n ]\n const runtime = createInterceptorRuntime({\n interceptors: withFront(options.interceptors),\n emit: hub.emit,\n })\n runtime.installBoundary(errorBoundary)\n hub.attach(runtime)\n // Dev check (§5.3): the same `data` array passed again with changed contents (DK_DATA_MUTATED).\n const dataCheck = (process.env.NODE_ENV !== \"production\") ? createDataMutationCheck(hub.emit) : undefined\n // Feature `requires.core` (throws DK_FEATURE_INCOMPATIBLE), duplicate cores, version mismatch\n // (§8.5): development checks (changed 2026-10-13 for §9.3).\n if ((process.env.NODE_ENV !== \"production\")) checkVersions(features, hub.emit, hub.table)\n // Ingest data checks (§5.3) and zero-config columns (§4.1): both read only the first rows.\n // The data checks are developer hints: development only (changed 2026-10-13 for §9.3).\n const dataChecks = (process.env.NODE_ENV !== \"production\") ? createDataChecks(hub.emit) : undefined\n /** Controlled changes not fed back (DK_CONTROLLED_NOT_FED_BACK, development). */\n const feedback = (process.env.NODE_ENV !== \"production\") ? createStateFeedbackCheck(hub.emit) : undefined\n const derivedColumns = createDerivedColumns()\n // Schema ingest (§5.1): `schema` and `invalidRows` are read once (validated above). The step\n // comes with the schema (`withSchema`, `@datakable/core/schema`): a table without one never\n // bundles it.\n const schemaIngest = (options.schema as Partial<TableSchema> | undefined)?.[SCHEMA_INGEST]?.(\n options.invalidRows ?? 'drop',\n () => options.columns,\n )\n // Never silent (§8.6): in production (no option validator) an unwrapped schema would be ignored.\n if (options.schema && !schemaIngest) unwrapped('schema', options.schema, 'withSchema')\n\n function sensitiveColumns(): string[] {\n const out: string[] = []\n for (const c of options.columns ?? EMPTY) {\n const id = columnId(c as { key?: unknown; id?: unknown })\n if (c.sensitive && typeof id === 'string') out.push(id)\n }\n return out\n }\n\n function base(): ContextBase {\n return { table, run, trigger, phase: defaultPhase(), emit: hub.emit }\n }\n\n function op<O extends OpName>(\n name: O,\n input: OpInput<O>,\n where: string,\n core: Core<O>,\n fallback?: unknown,\n ): OpResult<O> {\n const ctx = createContext(name, input, where, base())\n if (fallback !== undefined) ctx.meta.set(FALLBACK, fallback)\n return runtime.run(name, ctx, core)\n }\n\n function withTrigger<R>(t: Trigger, fn: () => R): R {\n const prev = trigger\n trigger = t\n try {\n return fn()\n } finally {\n trigger = prev\n }\n }\n\n // --- state -------------------------------------------------------------------------------------\n\n function controlledKeys(state: ControlledState<S> | undefined): Set<string> {\n const keys = new Set<string>()\n if (state) for (const k of Object.keys(state)) if (state[k] !== undefined) keys.add(k)\n return keys\n }\n\n /** `s` with the controlled slices from `options.state`; `s` itself when none differ. */\n function overlay(s: S): S {\n let next: TableState | undefined\n const state = options.state as TableState | undefined\n if (state) {\n for (const k of controlled) {\n if (!Object.is(s[k], state[k])) {\n next ??= { ...s }\n next[k] = state[k]\n }\n }\n }\n return next ? freeze(next as S) : s\n }\n\n function commit(next: S) {\n snapshot = next\n pending = true\n rowModelDirty = true\n }\n\n function warnControlled(dropped: string[] | undefined) {\n if (options.onStateChange || controlled.size === 0) return\n const slices = dropped ?? [...controlled]\n hub.emit('DK_CONTROLLED_WITHOUT_HANDLER', { slices, dropped: dropped !== undefined })\n }\n\n function syncControlled() {\n controlled = controlledKeys(options.state)\n const next = overlay(snapshot)\n if (next !== snapshot) commit(next)\n if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n warnControlled(undefined)\n }\n\n function dispatch(updater: Updater<S>, slot: string) {\n // A method argument, not an option: `where` = `operation table.setState at updater`.\n const partial: Partial<S> =\n typeof updater === 'function'\n ? callUser(\n 'updater',\n updater,\n snapshot,\n undefined,\n slot === 'setState' ? 'table.setState' : `${slot}.setState`,\n )\n : updater\n if (partial === null || typeof partial !== 'object') return\n let next: TableState | undefined\n let changes: TableState | undefined\n let dropped: string[] | undefined\n for (const k of Object.keys(partial)) {\n const v = (partial as TableState)[k]\n if (Object.is(snapshot[k], v)) continue\n if (controlled.has(k)) {\n if (options.onStateChange) {\n changes ??= {}\n changes[k] = v\n } else {\n dropped ??= []\n dropped.push(k)\n }\n continue\n }\n next ??= { ...snapshot }\n next[k] = v\n }\n // The owner is told first: if onStateChange throws, nothing is committed (state unchanged).\n if (changes && options.onStateChange) {\n const c = changes as Partial<S>\n if ((process.env.NODE_ENV !== \"production\")) feedback?.ask(Object.keys(changes), trigger)\n callUser('onStateChange', options.onStateChange, (prev: Partial<S>) => ({ ...prev, ...c }))\n if ((process.env.NODE_ENV !== \"production\")) feedback?.asked()\n }\n if (next) commit(freeze(next as S))\n if (dropped) warnControlled(dropped)\n }\n\n /**\n * Notifies listeners until no change is pending. Updates made by listeners are committed at once\n * and notified in the next round (not nested), so every listener sees rounds in order.\n */\n function flush() {\n if (notifying) return\n sync()\n if (!pending) return\n notifying = true\n let rethrow: unknown\n try {\n while (pending && !destroyed) {\n // Server state changed (this round's state): the fetch starts in the same notification.\n sync()\n pending = false\n rounds++\n const prev = notified\n const state = snapshot\n notified = state\n // Listeners read the row model of the state they are notified with.\n ensureRowModel()\n for (const [id, listener] of [...listeners]) {\n // A listener may destroy the table: the rest of the round is not notified.\n if (destroyed) break\n current = id\n try {\n listener(state, prev)\n } catch (e) {\n // strict: a DatakableError (e.g. DK_UPDATE_LOOP) thrown inside the listener.\n if (e instanceof DatakableError) {\n rethrow ??= e\n continue\n }\n try {\n const name = errorName(e)\n hub.emit(\n 'DK_LISTENER_FAILED',\n { listener: id, ...(name === undefined ? {} : { errorName: name }) },\n { cause: e },\n )\n } catch (strictError) {\n rethrow ??= strictError\n }\n }\n }\n }\n } finally {\n notifying = false\n rounds = 0\n loopReported = false\n current = undefined\n }\n if (rethrow !== undefined) throw rethrow\n }\n\n /** `false` (and one `DK_UPDATE_LOOP`) when a re-entrant update would exceed the depth limit. */\n function admit(slices: string[]): boolean {\n if (!notifying || rounds < UPDATE_DEPTH_LIMIT) return true\n if (!loopReported) {\n loopReported = true\n hub.emit('DK_UPDATE_LOOP', {\n limit: UPDATE_DEPTH_LIMIT,\n slices,\n ...(current === undefined ? {} : { listener: current }),\n })\n }\n return false\n }\n\n function destroyedCall(method: string) {\n withTrigger(`api:${method}`, () => hub.emit('DK_TABLE_DESTROYED', { method }))\n }\n\n // --- data --------------------------------------------------------------------------------------\n\n /** Applies ingested data; `given`: it came from a user `options.data` (marks the first load). */\n function setData(next: readonly T[], given: boolean) {\n if (given && !loaded) {\n // isInitialLoad flips: a new row model and a notification even for the same reference.\n loaded = true\n pending = true\n rowModelDirty = true\n }\n if (next === data) return\n data = next\n pending = true\n // After `data` is set: diagnostics dedupe per data reference.\n if ((process.env.NODE_ENV !== \"production\")) dataChecks?.check(data, options.columns)\n // The pipeline runs before the next notification (or on getRowModel), as `pipeline:run` with\n // ctx.meta[FALLBACK] = the last good row model (pipeline/runner.ts).\n rowModelDirty = true\n }\n\n // --- row model ---------------------------------------------------------------------------------\n\n const runner = createPipeline<T>({\n runtime,\n featureRuntime: rt,\n emit: hub.emit,\n features: pipeline,\n listed: features,\n base,\n nextRun: () => ++run,\n getData: () => data,\n getState: () => snapshot,\n getColumns: () => options.columns ?? derivedColumns(data),\n getRowKey: () => options.rowKey,\n isInitialLoad: () => !loaded,\n status,\n issues: (index) => schemaOutcome?.flagged?.get(index),\n flagMode: schemaIngest !== undefined && options.invalidRows === 'flag',\n // Time-sliced work ended (§9.1): 'pending' → the finished row model, never silent (§6.6).\n refresh: (t) => {\n if (destroyed) return\n withTrigger(t, () => {\n touch()\n if (apiDepth === 0) flush()\n })\n },\n })\n\n const explainHost: ExplainHost = {\n table,\n features: pipeline,\n rowModel: getRowModel as () => RowModel<unknown>,\n lastRun: runner.lastRun,\n replay: runner.replayContext,\n data: () => data,\n state: () => snapshot,\n rowKey: () => options.rowKey,\n schemaMode: () => (schemaIngest ? (options.invalidRows ?? 'drop') : undefined),\n schema: () => schemaOutcome,\n diagnostics: () => hub.getDiagnostics(),\n redaction,\n ...(rt ? { detail: rt.explainDetail } : {}),\n }\n\n /**\n * Status from outside the pipeline (§6.6): a failed ingest, a running async schema, the search\n * slice (`pending` / `searching` / `error`), and the extensions' (a failed fetch, an in-flight\n * fetcher / `searchFn`, deferred async work). Precedence: error > fetching > searching >\n * validating > pending > idle.\n */\n function status(): RowModelStatus {\n const search = searchStatus()\n let s: RowModelStatus =\n ingestFailed || search === 'error'\n ? 'error'\n : search === 'searching'\n ? 'searching'\n : validatingSeq !== 0\n ? 'validating'\n : search === 'pending'\n ? 'pending'\n : 'idle'\n for (const e of extensions.values()) {\n const x = e.status?.()\n if (x !== undefined && RANK.indexOf(x) > RANK.indexOf(s)) s = x\n }\n return s\n }\n\n /** Extensions start work that follows state (the fetcher on server state, §7.1). */\n function sync() {\n for (const e of extensions.values()) e.sync?.()\n }\n\n /** The `status` of the first search-stage slice that reports one (§6.3). */\n function searchStatus(): unknown {\n for (const f of pipeline) {\n if (f.stage !== 'search') continue\n const s = (snapshot as Record<string, unknown> | undefined)?.[f.name]\n if (s !== null && typeof s === 'object' && 'status' in s) {\n const v = (s as { status: unknown }).status\n if (v !== 'idle') return v\n }\n }\n return 'idle'\n }\n\n /** A row model change not caused by state: recompute and notify on the next flush. */\n function touch() {\n pending = true\n rowModelDirty = true\n }\n\n /** Recomputes the row model if data, state or columns changed (never after destroy). */\n function ensureRowModel() {\n if (!rowModelDirty || destroyed) return\n rowModelDirty = false\n runner.run()\n }\n\n function getRowModel(): RowModel<T> {\n ensureRowModel()\n // Only empty when destroyed before the first run.\n return (\n runner.current() ?? {\n rows: EMPTY,\n filteredCount: 0,\n totalCount: 0,\n status: status(),\n isInitialLoad: !loaded,\n }\n )\n }\n\n /**\n * Applies the result of the latest `data:ingest`. A fallback (the boundary set `FAILED`) keeps\n * the previous data, sets `status: 'error'` and never marks the table loaded (§6.6, §8.6).\n */\n function applyIngest(out: readonly unknown[], failed: boolean, given: boolean, initial = false) {\n if (validatingSeq !== 0) {\n validatingSeq = 0\n touch()\n }\n if (failed) {\n ingestFailed = true\n touch()\n return\n }\n if (ingestFailed) {\n ingestFailed = false\n touch()\n }\n schemaOutcome = schemaIngest?.outcome(out)\n setData(out as readonly T[], given)\n // `initialData` is the initial async result only while it is the data (§7.2).\n initialRows = initial ? out : undefined\n }\n\n /**\n * `data:ingest` with the previous data as fallback: the schema step (§5.1) runs in its core. An\n * async result is applied if still latest. `fetched`: rows of an applied fetcher result (§7.1),\n * ingested like `options.data` (schema, data checks) and marking the table loaded.\n */\n function ingest(fetched?: readonly unknown[]) {\n const seq = ++ingestSeq\n // At creation, `initialData` stands in for a missing `data` (§7.2); read once.\n const initial = fetched === undefined && initialInput !== undefined\n const input = fetched ?? (initial ? initialInput : options.data)\n initialInput = undefined\n const given = input !== undefined\n const source: Trigger = fetched ? 'fetch' : 'data-change'\n // A validation still in flight is superseded (its result is discarded): not 'validating' now,\n // unless this ingest's own schema step goes async.\n if (validatingSeq !== 0) {\n validatingSeq = 0\n touch()\n }\n try {\n withTrigger(source, () => {\n const ctx = createContext(\n 'data:ingest',\n { data: input ?? EMPTY },\n fetched ? 'fetcher' : initial ? 'options.initialData' : 'options.data',\n base(),\n )\n ctx.meta.set(FALLBACK, data)\n let sync = true\n const out = runtime.run('data:ingest', ctx, (c) => {\n const input = c.input.data as readonly unknown[]\n if (!schemaIngest) return input\n const r = schemaIngest.validate(input, c.emit)\n if (isThenable(r) && seq === ingestSeq && !destroyed) {\n // 'validating' is never silent: a new row model and a notification now (§6.6).\n validatingSeq = seq\n touch()\n if (!sync) flush()\n }\n return r\n })\n sync = false\n if (!isThenable(out)) {\n applyIngest(out, ctx.meta.has(FAILED), given, initial)\n return\n }\n const settle = (d: readonly unknown[], failed: boolean) => {\n if (seq !== ingestSeq || destroyed) return\n withTrigger(source, () => {\n applyIngest(d, failed, given, initial)\n flush()\n })\n }\n Promise.resolve(out).then(\n (d) => settle(d, ctx.meta.has(FAILED)),\n // A DatakableError the boundary rethrew (strict, or `invalidRows: 'throw'` with an async\n // schema, already reported): the previous data is kept with 'error'. No unhandled\n // rejection either way (§8.6).\n () => settle(data, true),\n )\n })\n } finally {\n // Dev (§5.3): fingerprint `data` after the core read it, so the check never takes reads\n // first; also when the ingest threw, so a later same-reference check compares this data.\n if ((process.env.NODE_ENV !== \"production\") && !fetched) dataCheck?.remember(options.data)\n }\n }\n\n // --- API ---------------------------------------------------------------------------------------\n\n /** `state:dispatch` (where = `slot`, a constant method / feature name); notifies unless batched. */\n function update(updater: Updater<S>, slot: string) {\n void op('state:dispatch', { updater }, slot, (): undefined => {\n dispatch(updater, slot)\n })\n if (apiDepth === 0) flush()\n }\n\n function setState(updater: Updater<S>) {\n if (destroyed) return destroyedCall('setState')\n if (!admit(typeof updater === 'function' ? [] : Object.keys(updater ?? {}))) return\n withTrigger('api:setState', () => update(updater, 'setState'))\n }\n\n // --- features ----------------------------------------------------------------------------------\n\n /** A feature's `ctx.setState`: replaces its own slice (trigger: the API call's, if any). */\n function setSlice(name: string, updater: SliceUpdater<unknown>) {\n if (destroyed) return destroyedCall(`${name}.setState`)\n if (!admit([name])) return\n const slice: Updater<S> =\n typeof updater === 'function'\n ? (prev) => ({ [name]: (updater as (p: unknown) => unknown)(prev[name]) }) as Partial<S>\n : ({ [name]: updater } as Partial<S>)\n update(slice, name)\n }\n\n /** Runs a feature API method (wrapped once by `installApis`). */\n function callApi(method: string, fn: () => unknown, ifDestroyed?: () => unknown): unknown {\n if (destroyed) {\n destroyedCall(method)\n return ifDestroyed?.()\n }\n return withTrigger(`api:${method}`, () => {\n apiDepth++\n try {\n return fn()\n } finally {\n apiDepth--\n if (apiDepth === 0) flush()\n }\n })\n }\n\n function subscribe(listener: Listener<S>): () => void {\n if (destroyed) {\n destroyedCall('subscribe')\n return () => {}\n }\n const id = ++listenerSeq\n listeners.set(id, listener)\n return () => {\n listeners.delete(id)\n }\n }\n\n function setOptions(partial: Partial<TableOptions<T, S>>) {\n if (destroyed) return destroyedCall('setOptions')\n if (!admit(Object.keys(partial.state ?? {}))) return\n withTrigger('setOptions', () => {\n const previous = options\n const next = { ...options, ...partial }\n // Option validator (§3.4, `table:setOptions`, development): an invalid value throws before\n // anything changes. Read-once options (`features`, `timeout`, `diagnostics`, …) keep their\n // value in every build.\n if ((process.env.NODE_ENV !== \"production\")) validateOptionChange(partial, next, previous, { table: hub.table, emit: hub.emit })\n else keepReadOnce(partial, next, previous)\n if ('fetcher' in partial) useServer(next.fetcher, 'setOptions')?.check(next.fetcher)\n void op('table:setOptions', { options: next, previous }, 'options', (): undefined => {\n options = next\n if (next.interceptors !== previous.interceptors) {\n runtime.setInterceptors(withFront(next.interceptors))\n }\n if ('state' in partial || 'onStateChange' in partial) syncControlled()\n if (next.columns !== previous.columns || next.rowKey !== previous.rowKey) {\n rowModelDirty = true\n pending = true\n }\n // The page count changed (§6.5): listeners re-read it (and pagination clamps).\n if (next.rowCount !== previous.rowCount) pending = true\n // A new fetcher reference runs at once, even with the same params (flush → sync).\n if (next.fetcher !== previous.fetcher) server?.reset()\n // New data is checked when applied (setData); same data with new columns is checked here.\n if (next.data !== previous.data) ingest()\n else if ((process.env.NODE_ENV !== \"production\")) {\n if ('data' in partial) dataCheck?.check(next.data)\n if (next.columns !== previous.columns) dataChecks?.check(data, next.columns)\n }\n })\n flush()\n })\n }\n\n function destroy() {\n if (destroyed) return\n withTrigger('api:destroy', () => {\n try {\n void op('table:destroy', undefined, 'destroy', (): undefined => {\n destroyed = true\n })\n } finally {\n // Even if an interceptor skipped the core: the table is destroyed.\n destroyed = true\n ingestSeq++\n listeners.clear()\n runner.dispose()\n if ((process.env.NODE_ENV !== \"production\")) feedback?.dispose()\n }\n })\n }\n\n // --- extensions (§9.3) ---------------------------------------------------------------------\n\n function batch<R>(t: Trigger, fn: () => R): R {\n return withTrigger(t, () => {\n apiDepth++\n try {\n return fn()\n } finally {\n apiDepth--\n if (apiDepth === 0) flush()\n }\n })\n }\n\n const host: TableHost = {\n table: table as unknown as Table<unknown, TableState>,\n name: hub.table,\n emit: hub.emit,\n runtime,\n features: pipeline,\n options: () => options as TableOptions<unknown>,\n state: () => snapshot,\n base,\n destroyed: () => destroyed,\n loaded: () => loaded,\n status,\n touch,\n notify: () => {\n if (apiDepth === 0) flush()\n },\n batch,\n ingest: (rows) => ingest(rows),\n intercept(interceptor) {\n front.push(interceptor)\n runtime.setInterceptors(withFront(options.interceptors))\n },\n deferring: () => deferring,\n use,\n }\n\n function use<E extends TableExtension>(factory: ExtensionFactory<E>): E {\n let e = extensions.get(factory as ExtensionFactory<TableExtension>) as E | undefined\n if (!e) {\n e = factory(host)\n extensions.set(factory as ExtensionFactory<TableExtension>, e)\n }\n return e\n }\n\n /** The server source a `withFetcher` fetcher brings (created once); else the current one. */\n function useServer(fetcher: unknown, phase?: 'setOptions'): ServerSource | undefined {\n const factory = (fetcher as Partial<ServerFetcher<unknown>> | undefined)?.[SERVER_SOURCE]\n if (factory) server = use(factory)\n // Never silent (§8.6): in production an unwrapped fetcher would never run.\n else if (fetcher) unwrapped('fetcher', fetcher, 'withFetcher', 'server', phase)\n return server\n }\n\n /**\n * `DK_INVALID_OPTION` for a schema / fetcher not wrapped with its opt-in import (§5.1, §7.1). A\n * production check: in development the option validator reports it first, with the full text.\n */\n function unwrapped(\n path: 'schema' | 'fetcher',\n value: unknown,\n wrap: string,\n entry: string = path,\n phase: 'init' | 'setOptions' = 'init',\n ): never {\n return throwConfigError(\n 'DK_INVALID_OPTION',\n {\n path,\n expected: `wrapped|${wrap}|${path}|${entry}`, // prose key (diagnostics/prose.ts)\n received: typeof value,\n suggestions: [],\n phase,\n },\n { table: hub.table, trigger: phase },\n )\n }\n\n /**\n * Runs the fetcher again with the current params (§7.1); never rejects. Without a fetcher:\n * `{ status: 'applied' }` at once.\n */\n function refetch(): Promise<FetchOutcome> {\n if (destroyed) {\n destroyedCall('refetch')\n return Promise.resolve({ status: 'superseded' })\n }\n return (\n withTrigger('api:refetch', () => server?.sync(true)) ?? Promise.resolve({ status: 'applied' })\n )\n }\n\n /** `startTable` (§7.2): the deferred work starts; listeners see the new status at once. */\n function start() {\n if (!deferring || destroyed) return\n deferring = false\n let had = false\n for (const e of extensions.values()) if (e.start?.()) had = true\n if (!had) return\n // The pipeline re-runs: 'pending' ends and the search feature's check starts its searchFn.\n touch()\n withTrigger('hydrate', () => flush())\n }\n\n setTableInternals(table, {\n features: pipeline,\n name: options.name,\n rowCount: () => (typeof options.fetcher === 'function' ? server?.rowCount() : options.rowCount),\n hasFetcher: () => typeof options.fetcher === 'function',\n emit: hub.emit,\n use,\n peek: (factory) => extensions.get(factory as ExtensionFactory<TableExtension>) as never,\n extensions: () => extensions.values(),\n start,\n initialRows: () =>\n initialRows !== undefined && initialRows === data ? initialRows : undefined,\n })\n\n // --- init --------------------------------------------------------------------------------------\n\n controlled = controlledKeys(options.state)\n if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n // Feature `initialState()` slices, with `options.initialState` on top per slice.\n snapshot = overlay(\n freeze(\n (rt\n ? rt.initialSlices(features, options.initialState, hub.emit)\n : { ...options.initialState }) as S,\n ),\n )\n notified = snapshot\n // Merges the feature APIs onto the table; a name clash throws DK_FEATURE_API_CONFLICT.\n rt?.installApis(features, {\n table: table as unknown as Table<unknown, TableState>,\n tableName: hub.table,\n emit: hub.emit,\n getSlice: (name) => snapshot[name],\n setSlice,\n call: callApi,\n })\n // Server source (§7.1): with a `withFetcher` fetcher (throws DK_FETCHER_WITHOUT_SERVER_MODE).\n useServer(options.fetcher)\n withTrigger('init', () => {\n // `void`: sync ops never return a promise (op kinds, §3.4).\n void op('table:init', { options }, 'options', (): undefined => {\n // Ingest first: dedupe is per data reference, so warnings follow the initial data.\n ingest()\n warnControlled(undefined)\n })\n // Server source (§7.1): the first request starts now ('fetching', isInitialLoad: true), unless\n // initialData answered the initial server state (§7.2).\n sync()\n })\n pending = false\n return table\n}\n"],"mappings":"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","names":["import_runtime","import_codes","sync","input"]}
1
+ {"version":3,"sources":["../../src/table/create-table.ts"],"sourcesContent":["import { optionDiagnostics } from '../catalog/codes'\nimport { validateOptionChange, validateOptions } from '../catalog/validator'\nimport { DatakableError, defaultPhase, throwConfigError } from '../diagnostics/build'\nimport { keepDiagnostics } from '../diagnostics/catalog'\nimport '../diagnostics/process-guard'\nimport { type ExplainHost, explainRow, explainTable } from '../diagnostics/explain'\nimport { createDiagnostics } from '../diagnostics/hub'\nimport { pathsOverlap, type RedactionOptions } from '../diagnostics/redact'\nimport { tracer } from '../diagnostics/tracer'\nimport type { Trigger } from '../diagnostics/types'\nimport { runtimeFor } from '../feature/runtime'\nimport type { AnyFeature, ApiOf, SliceUpdater, TableStateFor } from '../feature/types'\nimport { createDataChecks } from '../ingest/data-checks'\nimport { createDerivedColumns } from '../ingest/derive-columns'\nimport type { SchemaOutcome } from '../ingest/schema'\nimport { SCHEMA_INGEST, type TableSchema } from '../ingest/schema-brand'\nimport type { InvalidRowsMode } from '../ingest/schema-codes'\nimport type { StandardSchemaV1 } from '../ingest/standard-schema'\nimport { errorBoundary } from '../intercept/boundary'\nimport { callUser, errorName } from '../intercept/classify'\nimport { type ContextBase, createContext } from '../intercept/context'\nimport type { Interceptor } from '../intercept/define'\nimport { FAILED, FALLBACK } from '../intercept/fallbacks'\nimport type { OpInput, OpName, OpResult } from '../intercept/operations'\nimport { type Core, createInterceptorRuntime } from '../intercept/runtime'\nimport { createPipeline } from '../pipeline/runner'\nimport type { RowModel, RowModelStatus } from '../pipeline/types'\nimport { checkModeOrder, type FetchOutcome } from '../source/fetcher'\nimport type { ServerSource } from '../source/server'\nimport { SERVER_SOURCE, type ServerFetcher } from '../source/server-brand'\nimport { checkVersions } from '../versioning/registry'\nimport { tableDiagnostics } from './codes'\nimport { createDataMutationCheck, dataMutationDiagnostics } from './data-mutation'\nimport {\n deferral,\n type ExtensionFactory,\n setTableInternals,\n type TableExtension,\n type TableHost,\n} from './internals'\nimport { keepReadOnce } from './read-once'\nimport { PROTO_KEY, stateDiagnostics } from './state-codes'\nimport { createStateFeedbackCheck, stateFeedbackDiagnostics } from './state-feedback'\nimport {\n type ControlledState,\n type Listener,\n type Table,\n type TableOptions,\n type TableState,\n UPDATE_DEPTH_LIMIT,\n type Updater,\n} from './types'\n\nkeepDiagnostics(\n tableDiagnostics,\n dataMutationDiagnostics,\n stateFeedbackDiagnostics,\n optionDiagnostics,\n stateDiagnostics,\n)\n\nconst EMPTY: readonly never[] = []\n\n/** §6.6 status precedence, lowest first: the table shows the highest of its sources. */\nconst RANK: readonly RowModelStatus[] = [\n 'idle',\n 'pending',\n 'validating',\n 'searching',\n 'fetching',\n 'error',\n]\n\nconst isThenable = (v: unknown): v is PromiseLike<unknown> =>\n v != null && typeof (v as { then?: unknown }).then === 'function'\n\n/** Objects already deep-frozen (dev): an unchanged slice is not walked again on the next commit. */\nconst deepFrozen = (process.env.NODE_ENV !== \"production\") ? new WeakSet<object>() : undefined\n\n/**\n * Freezes plain objects and arrays reachable from `root` (dev). Class instances (Date, Map, typed\n * arrays, user classes) are left alone: freezing them would break their own methods. Iterative (an\n * explicit stack): restored state can be nested deeper than the call stack allows (#103).\n */\nfunction deepFreeze(root: unknown): void {\n const stack = [root]\n while (stack.length > 0) {\n const v = stack.pop()\n if (v === null || typeof v !== 'object' || deepFrozen?.has(v)) continue\n const isArray = Array.isArray(v)\n if (!isArray) {\n const proto = Object.getPrototypeOf(v)\n if (proto !== Object.prototype && proto !== null) continue\n }\n deepFrozen?.add(v)\n Object.freeze(v)\n if (isArray) for (let i = 0; i < v.length; i++) stack.push(v[i])\n else for (const k in v) stack.push((v as Record<string, unknown>)[k])\n }\n}\n\n/** Snapshots and their slices are immutable in development (#20); production skips the walk. */\nconst freeze = <S extends object>(s: S): S => {\n if ((process.env.NODE_ENV !== \"production\")) deepFreeze(s)\n return s\n}\n\n/** `undefined` exactly (not `any`, `never` or a union with it). */\ntype IsUndefined<X> =\n (<G>() => G extends X ? 1 : 2) extends <G>() => G extends undefined ? 1 : 2 ? true : false\n\n/**\n * `true` when `Sch` (the inferred `schema` option) is a schema. Its default, `undefined` (no\n * schema), is excluded explicitly: without `strictNullChecks` `undefined` is assignable to every\n * type, `TableSchema` included, which typed `data` as `unknown[]` and `T` as `unknown` (#93).\n */\nexport type HasSchema<Sch> = [Sch] extends [TableSchema]\n ? IsUndefined<Sch> extends true\n ? false\n : true\n : false\n\n/** The row type: the schema output with a `schema` (§5.1), else `T`. */\nexport type SchemaRow<T, Sch> = [Sch] extends [TableSchema]\n ? IsUndefined<Sch> extends true\n ? T\n : StandardSchemaV1.InferOutput<Sch>\n : T\n\n/**\n * `createTable` options: with a `schema`, the row type is its output and `data` is the raw input\n * (`unknown[]`, e.g. parsed JSON), validated per row.\n */\nexport type CreateTableOptions<T, S extends TableState, Sch, M extends InvalidRowsMode> = Omit<\n TableOptions<SchemaRow<T, Sch>, S>,\n 'data' | 'schema' | 'invalidRows' | 'fetcher' | 'initialData'\n> & {\n data?: readonly (HasSchema<Sch> extends true ? unknown : T)[]\n /** With a schema, the raw rows (validated like `data`). */\n initialData?: readonly (HasSchema<Sch> extends true ? unknown : T)[]\n /** With a schema, the fetcher returns raw rows (validated like `data`). */\n fetcher?: ServerFetcher<HasSchema<Sch> extends true ? unknown : T>\n // Without an inferred schema (explicit type arguments, a `TableOptions<T>` object) these keep\n // their `TableOptions` types.\n schema?: HasSchema<Sch> extends true ? Sch : TableSchema<unknown, T>\n invalidRows?: HasSchema<Sch> extends true ? M : InvalidRowsMode\n}\n\n/** Column id: `key` for key columns, `id` for accessor columns. */\nconst columnId = (c: { key?: unknown; id?: unknown }): unknown => c.key ?? c.id\n\n/**\n * Creates the table store (§3.2): immutable state snapshots, controlled slices, isolated listeners,\n * a re-entrancy guard and `destroy()`. Every unit of work runs as an operation (§3.4) through the\n * table's interceptor runtime, with the errorBoundary outermost and diagnostics on a per-table hub.\n *\n * `ctx.where` is always a constant option path or method name (`options`, `options.data`,\n * `setState`, `destroy`): it reaches fingerprints, docs URLs and issue links unredacted, so it must\n * never carry row keys or cell values.\n */\nexport function createTable<\n T,\n S extends TableState = never,\n const Fs extends readonly AnyFeature[] = [],\n const Sch extends TableSchema | undefined = undefined,\n const M extends InvalidRowsMode = 'drop',\n>(\n options: CreateTableOptions<T, TableStateFor<S, Fs, SchemaRow<T, Sch>>, Sch, M> & {\n features?: Fs\n },\n): Table<\n SchemaRow<T, Sch>,\n TableStateFor<S, Fs, SchemaRow<T, Sch>>,\n M,\n HasSchema<Sch> extends true ? unknown : T\n> &\n ApiOf<Fs, SchemaRow<T, Sch>>\nexport function createTable<T, S extends TableState>(\n initialOptions: TableOptions<T, S>,\n): Table<T, S> {\n let options: TableOptions<T, S> = { ...initialOptions }\n let destroyed = false\n let trigger: Trigger = 'init'\n /** Pipeline run id; each `pipeline:run` increments it. */\n let run = 0\n let data: readonly T[] = EMPTY\n let ingestSeq = 0\n /** Data given by the user has been applied once (`RowModel.isInitialLoad`, §6.6). */\n let loaded = false\n /** The last `data:ingest` failed (op fallback): `status: 'error'` until one succeeds (§6.6). */\n let ingestFailed = false\n /** The ingest whose async schema validation is in flight (`status: 'validating'`); 0: none. */\n let validatingSeq = 0\n /** Rows of the current data that failed the schema (`getInvalidRows`, §5.1). */\n let schemaOutcome: SchemaOutcome | undefined\n /**\n * SSR (§7.2): `options.initialData` until the creation ingest read it (`undefined` with `data`),\n * then its ingested rows while they are the table's data (`initialRows`).\n */\n let initialInput = options.data == null ? options.initialData : undefined\n let initialRows: readonly unknown[] | undefined\n /** Created inside `createDeferred` (§7.2): async work waits for `startTable`. */\n let deferring = deferral.depth > 0\n /**\n * Opt-in parts of the store (`TableInternals.use`): the async request machinery and the server\n * source. A table without an async source creates none (§9.3).\n */\n const extensions = new Map<ExtensionFactory<TableExtension>, TableExtension>()\n /** The server source (`withFetcher`, §7.1), once a fetcher was given. */\n let server: ServerSource | undefined\n\n let controlled = new Set<string>()\n let snapshot: S\n /** The snapshot listeners last saw (`prev` of the next notification). */\n let notified: S\n /** A committed change (state or data) not yet notified. */\n let pending = false\n let notifying = false\n let rounds = 0\n let loopReported = false\n let current: number | undefined\n let listenerSeq = 0\n const listeners = new Map<number, Listener<S>>()\n /** Depth of feature API calls in progress: listeners are notified when the outermost returns. */\n let apiDepth = 0\n /** Data, state or columns changed since the row model was computed. */\n let rowModelDirty = true\n /** Diagnostic context (§8.1): the data mode of each pipeline feature (set once features load). */\n const modes: Record<string, 'client' | 'server'> = {}\n\n const table: Table<T, S> = {\n getState: () => snapshot,\n setState,\n subscribe,\n setOptions,\n getOptions: () => options,\n getData: () => data,\n // Core method: on the literal before installApis, so no feature can take the name.\n getRowModel,\n getInvalidRows: () => schemaOutcome?.invalid ?? EMPTY,\n getDiagnostics: () => hub.getDiagnostics(),\n // Core methods (§8.4), read-only: also on the literal before installApis.\n explain: () => explainTable(explainHost),\n explainRow: (key) => explainRow(explainHost, key),\n refetch,\n destroy,\n }\n\n // Redaction (§8.2): `diagnostics.redact` gives the level or a custom rule; column defs give the\n // sensitive columns and whether the rowKey column is sensitive. Both are read per emit, so\n // `setOptions({ columns })` is followed.\n const redactOption = options.diagnostics?.redact\n const redaction: RedactionOptions = {\n ...(typeof redactOption === 'string' ? { level: redactOption } : {}),\n ...(typeof redactOption === 'function' ? { redact: redactOption } : {}),\n sensitiveColumns,\n // A rowKey path into (or above) a sensitive column reads its data too (#45).\n rowKeySensitive: () => {\n const k = options.rowKey\n return typeof k === 'string' && sensitiveColumns().some((c) => pathsOverlap(k, c))\n },\n }\n const hub = createDiagnostics({\n ...(options.name === undefined ? {} : { name: options.name }),\n table,\n onDiagnostic: (d) => options.onDiagnostic?.(d),\n ...(options.strict === undefined ? {} : { strict: options.strict }),\n getContext: () => ({ trigger, run, mode: modes }),\n getDataRef: () => data,\n redaction,\n })\n // Option validator (§3.4, `table:init`), development only: before anything reads the options.\n // Invalid values throw DK_INVALID_OPTION; unknown / no-effect options are reported on the hub.\n if ((process.env.NODE_ENV !== \"production\")) validateOptions(options, { table: hub.table, emit: hub.emit })\n // Features (§3.3) are read once, at creation. `features` is the listed order (API install, conflict\n // reports); `pipeline` is stage order for the runner. Duplicates throw here (config error).\n const features: readonly AnyFeature[] = options.features ?? EMPTY\n // The feature runtime comes with the features (`defineFeature`): none for a table without.\n const rt = runtimeFor(features)\n const pipeline = rt ? rt.orderFeatures(features, hub.table) : EMPTY\n // Data modes (§7.1): DK_MODE_ORDER (a config error, development). A fetcher without a server-mode\n // feature (DK_FETCHER_WITHOUT_SERVER_MODE) is checked by the server source.\n if ((process.env.NODE_ENV !== \"production\")) checkModeOrder(pipeline, hub.table)\n for (const f of pipeline) if (f.stage !== 'none') modes[f.name] = f.mode ?? 'client'\n // Extension interceptors come first (asyncControl, one per table, installed with the first async\n // source: user / feature interceptors and the core see its signal); the boundary stays\n // outermost. Feature interceptors (pipeline order) come next, then the user's.\n const front: Interceptor<OpName>[] = []\n const featureInterceptors = pipeline.flatMap((f) => f.interceptors ?? EMPTY)\n // The tracer (§3.4, explain timings) is development-only: `(process.env.NODE_ENV !== \"production\")` folds to `false` in production\n // builds, which drops it from the bundle; there it is opt-in with `interceptors: [tracer()]`.\n const traced = (process.env.NODE_ENV !== \"production\") ? [tracer() as Interceptor<OpName>] : EMPTY\n const withFront = (list: readonly Interceptor<OpName>[] | undefined) => [\n ...front,\n ...traced,\n ...featureInterceptors,\n ...(list ?? EMPTY),\n ]\n const runtime = createInterceptorRuntime({\n interceptors: withFront(options.interceptors),\n emit: hub.emit,\n })\n runtime.installBoundary(errorBoundary)\n hub.attach(runtime)\n // Dev check (§5.3): the same `data` array passed again with changed contents (DK_DATA_MUTATED).\n const dataCheck = (process.env.NODE_ENV !== \"production\") ? createDataMutationCheck(hub.emit) : undefined\n // Feature `requires.core` (throws DK_FEATURE_INCOMPATIBLE), duplicate cores, version mismatch\n // (§8.5): development checks (changed 2026-10-13 for §9.3).\n if ((process.env.NODE_ENV !== \"production\")) checkVersions(features, hub.emit, hub.table)\n // Ingest data checks (§5.3) and zero-config columns (§4.1): both read only the first rows.\n // The data checks are developer hints: development only (changed 2026-10-13 for §9.3).\n const dataChecks = (process.env.NODE_ENV !== \"production\") ? createDataChecks(hub.emit) : undefined\n /** Controlled changes not fed back (DK_CONTROLLED_NOT_FED_BACK, development). */\n const feedback = (process.env.NODE_ENV !== \"production\") ? createStateFeedbackCheck(hub.emit) : undefined\n const derivedColumns = createDerivedColumns()\n // Schema ingest (§5.1): `schema` and `invalidRows` are read once (validated above). The step\n // comes with the schema (`withSchema`, `@datakable/core/schema`): a table without one never\n // bundles it.\n const schemaIngest = (options.schema as Partial<TableSchema> | undefined)?.[SCHEMA_INGEST]?.(\n options.invalidRows ?? 'drop',\n () => options.columns,\n )\n // Never silent (§8.6): in production (no option validator) an unwrapped schema would be ignored.\n if (options.schema && !schemaIngest) unwrapped('schema', options.schema, 'withSchema')\n\n function sensitiveColumns(): string[] {\n const out: string[] = []\n for (const c of options.columns ?? EMPTY) {\n const id = columnId(c as { key?: unknown; id?: unknown })\n if (c.sensitive && typeof id === 'string') out.push(id)\n }\n return out\n }\n\n function base(): ContextBase {\n return { table, run, trigger, phase: defaultPhase(), emit: hub.emit }\n }\n\n function op<O extends OpName>(\n name: O,\n input: OpInput<O>,\n where: string,\n core: Core<O>,\n fallback?: unknown,\n ): OpResult<O> {\n const ctx = createContext(name, input, where, base())\n if (fallback !== undefined) ctx.meta.set(FALLBACK, fallback)\n return runtime.run(name, ctx, core)\n }\n\n function withTrigger<R>(t: Trigger, fn: () => R): R {\n const prev = trigger\n trigger = t\n try {\n return fn()\n } finally {\n trigger = prev\n }\n }\n\n // --- state -------------------------------------------------------------------------------------\n\n /** A `__proto__` key (JSON.parse makes it own) is never written into state (#102). */\n function protoKey(k: string): boolean {\n if (k !== PROTO_KEY) return false\n hub.emit('DK_STATE_UNKNOWN_KEY', { slice: '', key: k, known: EMPTY })\n return true\n }\n\n function controlledKeys(state: ControlledState<S> | undefined): Set<string> {\n const keys = new Set<string>()\n if (state) {\n for (const k of Object.keys(state)) if (state[k] !== undefined && !protoKey(k)) keys.add(k)\n }\n return keys\n }\n\n /** `s` with the controlled slices from `options.state`; `s` itself when none differ. */\n function overlay(s: S): S {\n let next: TableState | undefined\n const state = options.state as TableState | undefined\n if (state) {\n for (const k of controlled) {\n if (!Object.is(s[k], state[k])) {\n next ??= { ...s }\n next[k] = state[k]\n }\n }\n }\n return next ? freeze(next as S) : s\n }\n\n function commit(next: S) {\n snapshot = next\n pending = true\n rowModelDirty = true\n }\n\n function warnControlled(dropped: string[] | undefined) {\n if (options.onStateChange || controlled.size === 0) return\n const slices = dropped ?? [...controlled]\n hub.emit('DK_CONTROLLED_WITHOUT_HANDLER', { slices, dropped: dropped !== undefined })\n }\n\n function syncControlled() {\n controlled = controlledKeys(options.state)\n const next = overlay(snapshot)\n if (next !== snapshot) commit(next)\n if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n warnControlled(undefined)\n }\n\n function dispatch(updater: Updater<S>, slot: string) {\n // A method argument, not an option: `where` = `operation table.setState at updater`.\n const partial: Partial<S> =\n typeof updater === 'function'\n ? callUser(\n 'updater',\n updater,\n snapshot,\n undefined,\n slot === 'setState' ? 'table.setState' : `${slot}.setState`,\n )\n : updater\n if (partial === null || typeof partial !== 'object') return\n let next: TableState | undefined\n let changes: TableState | undefined\n let dropped: string[] | undefined\n for (const k of Object.keys(partial)) {\n if (protoKey(k)) continue\n const v = (partial as TableState)[k]\n if (Object.is(snapshot[k], v)) continue\n if (controlled.has(k)) {\n if (options.onStateChange) {\n changes ??= {}\n changes[k] = v\n } else {\n dropped ??= []\n dropped.push(k)\n }\n continue\n }\n next ??= { ...snapshot }\n next[k] = v\n }\n // The owner is told first: if onStateChange throws, nothing is committed (state unchanged).\n if (changes && options.onStateChange) {\n const c = changes as Partial<S>\n if ((process.env.NODE_ENV !== \"production\")) feedback?.ask(Object.keys(changes), trigger)\n callUser('onStateChange', options.onStateChange, (prev: Partial<S>) => ({ ...prev, ...c }))\n if ((process.env.NODE_ENV !== \"production\")) feedback?.asked()\n }\n if (next) commit(freeze(next as S))\n if (dropped) warnControlled(dropped)\n }\n\n /**\n * Notifies listeners until no change is pending. Updates made by listeners are committed at once\n * and notified in the next round (not nested), so every listener sees rounds in order.\n */\n function flush() {\n if (notifying) return\n sync()\n if (!pending) return\n notifying = true\n let rethrow: unknown\n try {\n while (pending && !destroyed) {\n // Server state changed (this round's state): the fetch starts in the same notification.\n sync()\n pending = false\n rounds++\n const prev = notified\n const state = snapshot\n notified = state\n // Listeners read the row model of the state they are notified with.\n ensureRowModel()\n for (const [id, listener] of [...listeners]) {\n // A listener may destroy the table: the rest of the round is not notified.\n if (destroyed) break\n current = id\n try {\n listener(state, prev)\n } catch (e) {\n // strict: a DatakableError (e.g. DK_UPDATE_LOOP) thrown inside the listener.\n if (e instanceof DatakableError) {\n rethrow ??= e\n continue\n }\n try {\n const name = errorName(e)\n hub.emit(\n 'DK_LISTENER_FAILED',\n { listener: id, ...(name === undefined ? {} : { errorName: name }) },\n { cause: e },\n )\n } catch (strictError) {\n rethrow ??= strictError\n }\n }\n }\n }\n } finally {\n notifying = false\n rounds = 0\n loopReported = false\n current = undefined\n }\n if (rethrow !== undefined) throw rethrow\n }\n\n /** `false` (and one `DK_UPDATE_LOOP`) when a re-entrant update would exceed the depth limit. */\n function admit(slices: string[]): boolean {\n if (!notifying || rounds < UPDATE_DEPTH_LIMIT) return true\n if (!loopReported) {\n loopReported = true\n hub.emit('DK_UPDATE_LOOP', {\n limit: UPDATE_DEPTH_LIMIT,\n slices,\n ...(current === undefined ? {} : { listener: current }),\n })\n }\n return false\n }\n\n function destroyedCall(method: string) {\n withTrigger(`api:${method}`, () => hub.emit('DK_TABLE_DESTROYED', { method }))\n }\n\n // --- data --------------------------------------------------------------------------------------\n\n /** Applies ingested data; `given`: it came from a user `options.data` (marks the first load). */\n function setData(next: readonly T[], given: boolean) {\n if (given && !loaded) {\n // isInitialLoad flips: a new row model and a notification even for the same reference.\n loaded = true\n pending = true\n rowModelDirty = true\n }\n if (next === data) return\n data = next\n pending = true\n // After `data` is set: diagnostics dedupe per data reference.\n if ((process.env.NODE_ENV !== \"production\")) dataChecks?.check(data, options.columns)\n // The pipeline runs before the next notification (or on getRowModel), as `pipeline:run` with\n // ctx.meta[FALLBACK] = the last good row model (pipeline/runner.ts).\n rowModelDirty = true\n }\n\n // --- row model ---------------------------------------------------------------------------------\n\n const runner = createPipeline<T>({\n runtime,\n featureRuntime: rt,\n emit: hub.emit,\n features: pipeline,\n listed: features,\n base,\n nextRun: () => ++run,\n getData: () => data,\n getState: () => snapshot,\n getColumns: () => options.columns ?? derivedColumns(data),\n getRowKey: () => options.rowKey,\n isInitialLoad: () => !loaded,\n status,\n issues: (index) => schemaOutcome?.flagged?.get(index),\n flagMode: schemaIngest !== undefined && options.invalidRows === 'flag',\n // Time-sliced work ended (§9.1): 'pending' → the finished row model, never silent (§6.6).\n refresh: (t) => {\n if (destroyed) return\n withTrigger(t, () => {\n touch()\n if (apiDepth === 0) flush()\n })\n },\n })\n\n const explainHost: ExplainHost = {\n table,\n features: pipeline,\n rowModel: getRowModel as () => RowModel<unknown>,\n lastRun: runner.lastRun,\n replay: runner.replayContext,\n data: () => data,\n state: () => snapshot,\n rowKey: () => options.rowKey,\n schemaMode: () => (schemaIngest ? (options.invalidRows ?? 'drop') : undefined),\n schema: () => schemaOutcome,\n diagnostics: () => hub.getDiagnostics(),\n redaction,\n ...(rt ? { detail: rt.explainDetail } : {}),\n }\n\n /**\n * Status from outside the pipeline (§6.6): a failed ingest, a running async schema, the search\n * slice (`pending` / `searching` / `error`), and the extensions' (a failed fetch, an in-flight\n * fetcher / `searchFn`, deferred async work). Precedence: error > fetching > searching >\n * validating > pending > idle.\n */\n function status(): RowModelStatus {\n const search = searchStatus()\n let s: RowModelStatus =\n ingestFailed || search === 'error'\n ? 'error'\n : search === 'searching'\n ? 'searching'\n : validatingSeq !== 0\n ? 'validating'\n : search === 'pending'\n ? 'pending'\n : 'idle'\n for (const e of extensions.values()) {\n const x = e.status?.()\n if (x !== undefined && RANK.indexOf(x) > RANK.indexOf(s)) s = x\n }\n return s\n }\n\n /** Extensions start work that follows state (the fetcher on server state, §7.1). */\n function sync() {\n for (const e of extensions.values()) e.sync?.()\n }\n\n /** The `status` of the first search-stage slice that reports one (§6.3). */\n function searchStatus(): unknown {\n for (const f of pipeline) {\n if (f.stage !== 'search') continue\n const s = (snapshot as Record<string, unknown> | undefined)?.[f.name]\n if (s !== null && typeof s === 'object' && 'status' in s) {\n const v = (s as { status: unknown }).status\n if (v !== 'idle') return v\n }\n }\n return 'idle'\n }\n\n /** A row model change not caused by state: recompute and notify on the next flush. */\n function touch() {\n pending = true\n rowModelDirty = true\n }\n\n /** Recomputes the row model if data, state or columns changed (never after destroy). */\n function ensureRowModel() {\n if (!rowModelDirty || destroyed) return\n rowModelDirty = false\n runner.run()\n }\n\n function getRowModel(): RowModel<T> {\n ensureRowModel()\n // Only empty when destroyed before the first run.\n return (\n runner.current() ?? {\n rows: EMPTY,\n filteredCount: 0,\n totalCount: 0,\n status: status(),\n isInitialLoad: !loaded,\n }\n )\n }\n\n /**\n * Applies the result of the latest `data:ingest`. A fallback (the boundary set `FAILED`) keeps\n * the previous data, sets `status: 'error'` and never marks the table loaded (§6.6, §8.6).\n */\n function applyIngest(out: readonly unknown[], failed: boolean, given: boolean, initial = false) {\n if (validatingSeq !== 0) {\n validatingSeq = 0\n touch()\n }\n if (failed) {\n ingestFailed = true\n touch()\n return\n }\n if (ingestFailed) {\n ingestFailed = false\n touch()\n }\n schemaOutcome = schemaIngest?.outcome(out)\n setData(out as readonly T[], given)\n // `initialData` is the initial async result only while it is the data (§7.2).\n initialRows = initial ? out : undefined\n }\n\n /**\n * `data:ingest` with the previous data as fallback: the schema step (§5.1) runs in its core. An\n * async result is applied if still latest. `fetched`: rows of an applied fetcher result (§7.1),\n * ingested like `options.data` (schema, data checks) and marking the table loaded.\n */\n function ingest(fetched?: readonly unknown[]) {\n const seq = ++ingestSeq\n // At creation, `initialData` stands in for a missing `data` (§7.2); read once.\n const initial = fetched === undefined && initialInput !== undefined\n const input = fetched ?? (initial ? initialInput : options.data)\n initialInput = undefined\n // `data: null` counts as not given (production has no option validator, #94).\n const given = input != null\n const source: Trigger = fetched ? 'fetch' : 'data-change'\n // A validation still in flight is superseded (its result is discarded): not 'validating' now,\n // unless this ingest's own schema step goes async.\n if (validatingSeq !== 0) {\n validatingSeq = 0\n touch()\n }\n try {\n withTrigger(source, () => {\n const ctx = createContext(\n 'data:ingest',\n { data: input ?? EMPTY },\n fetched ? 'fetcher' : initial ? 'options.initialData' : 'options.data',\n base(),\n )\n ctx.meta.set(FALLBACK, data)\n let sync = true\n const out = runtime.run('data:ingest', ctx, (c) => {\n const input = c.input.data as readonly unknown[]\n if (!schemaIngest) return input\n const r = schemaIngest.validate(input, c.emit)\n if (isThenable(r) && seq === ingestSeq && !destroyed) {\n // 'validating' is never silent: a new row model and a notification now (§6.6).\n validatingSeq = seq\n touch()\n if (!sync) flush()\n }\n return r\n })\n sync = false\n if (!isThenable(out)) {\n applyIngest(out, ctx.meta.has(FAILED), given, initial)\n return\n }\n const settle = (d: readonly unknown[], failed: boolean) => {\n if (seq !== ingestSeq || destroyed) return\n withTrigger(source, () => {\n applyIngest(d, failed, given, initial)\n flush()\n })\n }\n Promise.resolve(out).then(\n (d) => settle(d, ctx.meta.has(FAILED)),\n // A DatakableError the boundary rethrew (strict, or `invalidRows: 'throw'` with an async\n // schema, already reported): the previous data is kept with 'error'. No unhandled\n // rejection either way (§8.6).\n () => settle(data, true),\n )\n })\n } finally {\n // Dev (§5.3): fingerprint `data` after the core read it, so the check never takes reads\n // first; also when the ingest threw, so a later same-reference check compares this data.\n if ((process.env.NODE_ENV !== \"production\") && !fetched) dataCheck?.remember(options.data)\n }\n }\n\n // --- API ---------------------------------------------------------------------------------------\n\n /** `state:dispatch` (where = `slot`, a constant method / feature name); notifies unless batched. */\n function update(updater: Updater<S>, slot: string) {\n void op('state:dispatch', { updater }, slot, (): undefined => {\n dispatch(updater, slot)\n })\n if (apiDepth === 0) flush()\n }\n\n function setState(updater: Updater<S>) {\n if (destroyed) return destroyedCall('setState')\n if (!admit(typeof updater === 'function' ? [] : Object.keys(updater ?? {}))) return\n withTrigger('api:setState', () => update(updater, 'setState'))\n }\n\n // --- features ----------------------------------------------------------------------------------\n\n /** A feature's `ctx.setState`: replaces its own slice (trigger: the API call's, if any). */\n function setSlice(name: string, updater: SliceUpdater<unknown>) {\n if (destroyed) return destroyedCall(`${name}.setState`)\n if (!admit([name])) return\n const slice: Updater<S> =\n typeof updater === 'function'\n ? (prev) => ({ [name]: (updater as (p: unknown) => unknown)(prev[name]) }) as Partial<S>\n : ({ [name]: updater } as Partial<S>)\n update(slice, name)\n }\n\n /** Runs a feature API method (wrapped once by `installApis`). */\n function callApi(method: string, fn: () => unknown, ifDestroyed?: () => unknown): unknown {\n if (destroyed) {\n destroyedCall(method)\n return ifDestroyed?.()\n }\n return withTrigger(`api:${method}`, () => {\n apiDepth++\n try {\n return fn()\n } finally {\n apiDepth--\n if (apiDepth === 0) flush()\n }\n })\n }\n\n function subscribe(listener: Listener<S>): () => void {\n if (destroyed) {\n destroyedCall('subscribe')\n return () => {}\n }\n const id = ++listenerSeq\n listeners.set(id, listener)\n return () => {\n listeners.delete(id)\n }\n }\n\n function setOptions(partial: Partial<TableOptions<T, S>>) {\n if (destroyed) return destroyedCall('setOptions')\n if (!admit(Object.keys(partial.state ?? {}))) return\n withTrigger('setOptions', () => {\n const previous = options\n const next = { ...options, ...partial }\n // Option validator (§3.4, `table:setOptions`, development): an invalid value throws before\n // anything changes. Read-once options (`features`, `timeout`, `diagnostics`, …) keep their\n // value in every build.\n if ((process.env.NODE_ENV !== \"production\")) validateOptionChange(partial, next, previous, { table: hub.table, emit: hub.emit })\n else keepReadOnce(partial, next, previous)\n if ('fetcher' in partial) useServer(next.fetcher, 'setOptions')?.check(next.fetcher)\n void op('table:setOptions', { options: next, previous }, 'options', (): undefined => {\n options = next\n if (next.interceptors !== previous.interceptors) {\n runtime.setInterceptors(withFront(next.interceptors))\n }\n if ('state' in partial || 'onStateChange' in partial) syncControlled()\n if (next.columns !== previous.columns || next.rowKey !== previous.rowKey) {\n rowModelDirty = true\n pending = true\n }\n // The page count changed (§6.5): listeners re-read it (and pagination clamps).\n if (next.rowCount !== previous.rowCount) pending = true\n // A new fetcher reference runs at once, even with the same params (flush → sync).\n if (next.fetcher !== previous.fetcher) server?.reset()\n // New data is checked when applied (setData); same data with new columns is checked here.\n if (next.data !== previous.data) ingest()\n else if ((process.env.NODE_ENV !== \"production\")) {\n if ('data' in partial) dataCheck?.check(next.data)\n if (next.columns !== previous.columns) dataChecks?.check(data, next.columns)\n }\n })\n flush()\n })\n }\n\n function destroy() {\n if (destroyed) return\n withTrigger('api:destroy', () => {\n try {\n void op('table:destroy', undefined, 'destroy', (): undefined => {\n destroyed = true\n })\n } finally {\n // Even if an interceptor skipped the core: the table is destroyed.\n destroyed = true\n ingestSeq++\n listeners.clear()\n runner.dispose()\n if ((process.env.NODE_ENV !== \"production\")) feedback?.dispose()\n }\n })\n }\n\n // --- extensions (§9.3) ---------------------------------------------------------------------\n\n function batch<R>(t: Trigger, fn: () => R): R {\n return withTrigger(t, () => {\n apiDepth++\n try {\n return fn()\n } finally {\n apiDepth--\n if (apiDepth === 0) flush()\n }\n })\n }\n\n const host: TableHost = {\n table: table as unknown as Table<unknown, TableState>,\n name: hub.table,\n emit: hub.emit,\n runtime,\n features: pipeline,\n options: () => options as TableOptions<unknown>,\n state: () => snapshot,\n base,\n destroyed: () => destroyed,\n loaded: () => loaded,\n status,\n touch,\n notify: () => {\n if (apiDepth === 0) flush()\n },\n batch,\n ingest: (rows) => ingest(rows),\n intercept(interceptor) {\n front.push(interceptor)\n runtime.setInterceptors(withFront(options.interceptors))\n },\n deferring: () => deferring,\n use,\n }\n\n function use<E extends TableExtension>(factory: ExtensionFactory<E>): E {\n let e = extensions.get(factory as ExtensionFactory<TableExtension>) as E | undefined\n if (!e) {\n e = factory(host)\n extensions.set(factory as ExtensionFactory<TableExtension>, e)\n }\n return e\n }\n\n /** The server source a `withFetcher` fetcher brings (created once); else the current one. */\n function useServer(fetcher: unknown, phase?: 'setOptions'): ServerSource | undefined {\n const factory = (fetcher as Partial<ServerFetcher<unknown>> | undefined)?.[SERVER_SOURCE]\n if (factory) server = use(factory)\n // Never silent (§8.6): in production an unwrapped fetcher would never run.\n else if (fetcher) unwrapped('fetcher', fetcher, 'withFetcher', 'server', phase)\n return server\n }\n\n /**\n * `DK_INVALID_OPTION` for a schema / fetcher not wrapped with its opt-in import (§5.1, §7.1). A\n * production check: in development the option validator reports it first, with the full text.\n */\n function unwrapped(\n path: 'schema' | 'fetcher',\n value: unknown,\n wrap: string,\n entry: string = path,\n phase: 'init' | 'setOptions' = 'init',\n ): never {\n return throwConfigError(\n 'DK_INVALID_OPTION',\n {\n path,\n expected: `wrapped|${wrap}|${path}|${entry}`, // prose key (diagnostics/prose.ts)\n received: typeof value,\n suggestions: [],\n phase,\n },\n { table: hub.table, trigger: phase },\n )\n }\n\n /**\n * Runs the fetcher again with the current params (§7.1); never rejects. Without a fetcher:\n * `{ status: 'applied' }` at once. Deferred: settles after `startTable` (#90, `server.sync`).\n */\n function refetch(): Promise<FetchOutcome> {\n if (destroyed) {\n destroyedCall('refetch')\n return Promise.resolve({ status: 'superseded' })\n }\n return (\n withTrigger('api:refetch', () => server?.sync(true)) ?? Promise.resolve({ status: 'applied' })\n )\n }\n\n /** `startTable` (§7.2): the deferred work starts; listeners see the new status at once. */\n function start() {\n if (!deferring || destroyed) return\n deferring = false\n let had = false\n for (const e of extensions.values()) if (e.start?.()) had = true\n if (!had) return\n // The pipeline re-runs: 'pending' ends and the search feature's check starts its searchFn.\n touch()\n withTrigger('hydrate', () => flush())\n }\n\n setTableInternals(table, {\n features: pipeline,\n name: options.name,\n rowCount: () => (typeof options.fetcher === 'function' ? server?.rowCount() : options.rowCount),\n hasFetcher: () => typeof options.fetcher === 'function',\n emit: hub.emit,\n use,\n peek: (factory) => extensions.get(factory as ExtensionFactory<TableExtension>) as never,\n extensions: () => extensions.values(),\n start,\n initialRows: () =>\n initialRows !== undefined && initialRows === data ? initialRows : undefined,\n })\n\n // --- init --------------------------------------------------------------------------------------\n\n controlled = controlledKeys(options.state)\n if ((process.env.NODE_ENV !== \"production\")) feedback?.settle(options.state as TableState | undefined, controlled)\n // Feature `initialState()` slices, with `options.initialState` on top per slice.\n // A copy without a `__proto__` key (#102): safe for `Object.assign` in initialSlices.\n const restored: TableState = { ...options.initialState }\n if (Object.hasOwn(restored, PROTO_KEY) && protoKey(PROTO_KEY)) delete restored[PROTO_KEY]\n snapshot = overlay(freeze((rt ? rt.initialSlices(features, restored, hub.emit) : restored) as S))\n notified = snapshot\n // Merges the feature APIs onto the table; a name clash throws DK_FEATURE_API_CONFLICT.\n rt?.installApis(features, {\n table: table as unknown as Table<unknown, TableState>,\n tableName: hub.table,\n emit: hub.emit,\n getSlice: (name) => snapshot[name],\n setSlice,\n call: callApi,\n })\n // Server source (§7.1): with a `withFetcher` fetcher (throws DK_FETCHER_WITHOUT_SERVER_MODE).\n useServer(options.fetcher)\n withTrigger('init', () => {\n // `void`: sync ops never return a promise (op kinds, §3.4).\n void op('table:init', { options }, 'options', (): undefined => {\n // Ingest first: dedupe is per data reference, so warnings follow the initial data.\n ingest()\n warnControlled(undefined)\n })\n // Server source (§7.1): the first request starts now ('fetching', isInitialLoad: true), unless\n // initialData answered the initial server state (§7.2).\n sync()\n })\n pending = false\n return table\n}\n"],"mappings":"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","names":["import_runtime","import_codes","sync","input"]}