@fragno-dev/db 0.3.0 → 0.4.1

package/dist/sync/commands.js

@@ -0,0 +1,27 @@
+//#region src/sync/commands.ts
+const createRegistry = (schemaName, commandList) => {
+	const commands = /* @__PURE__ */ new Map();
+	for (const command of commandList) {
+		if (!command || typeof command !== "object") throw new Error("Sync commands must be objects.");
+		const name = command.name;
+		if (typeof name !== "string" || name.trim().length === 0) throw new Error("Sync command name must be a non-empty string.");
+		const existing = commands.get(name);
+		if (existing && existing !== command) throw new Error(`Sync command "${name}" is already defined for schema "${schemaName}".`);
+		commands.set(name, command);
+	}
+	return {
+		schemaName,
+		commands,
+		getCommand: (name) => commands.get(name)
+	};
+};
+const defineSyncCommands = (options) => {
+	const schemaName = options.schema.name;
+	return { create: (factory) => {
+		return createRegistry(schemaName, factory({ defineCommand: (definition) => definition }));
+	} };
+};
+
+//#endregion
+export { defineSyncCommands };
+//# sourceMappingURL=commands.js.map

package/dist/sync/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","names":[],"sources":["../../src/sync/commands.ts"],"sourcesContent":["import type { AnySchema } from \"../schema/create\";\nimport type { SyncCommandDefinition, SyncCommandRegistry } from \"./types\";\n\ntype DefineSyncCommandsContext = {\n  defineCommand: <TInput, TContext>(\n    definition: SyncCommandDefinition<TInput, TContext>,\n  ) => SyncCommandDefinition<TInput, TContext>;\n};\n\nconst createRegistry = (\n  schemaName: string,\n  commandList: readonly SyncCommandDefinition[],\n): SyncCommandRegistry => {\n  const commands = new Map<string, SyncCommandDefinition>();\n\n  for (const command of commandList) {\n    if (!command || typeof command !== \"object\") {\n      throw new Error(\"Sync commands must be objects.\");\n    }\n\n    const name = command.name;\n    if (typeof name !== \"string\" || name.trim().length === 0) {\n      throw new Error(\"Sync command name must be a non-empty string.\");\n    }\n\n    const existing = commands.get(name);\n    if (existing && existing !== command) {\n      throw new Error(`Sync command \"${name}\" is already defined for schema \"${schemaName}\".`);\n    }\n\n    commands.set(name, command);\n  }\n\n  return {\n    schemaName,\n    commands,\n    getCommand: (name) => commands.get(name),\n  };\n};\n\nexport const defineSyncCommands = <TSchema extends AnySchema>(options: { schema: TSchema }) => {\n  const schemaName = options.schema.name;\n  return {\n    create: <const TCommands extends readonly SyncCommandDefinition[]>(\n      factory: (context: DefineSyncCommandsContext) => TCommands,\n    ): SyncCommandRegistry => {\n      const commands = factory({ defineCommand: (definition) => definition });\n      return createRegistry(schemaName, commands);\n    },\n  };\n};\n"],"mappings":";AASA,MAAM,kBACJ,YACA,gBACwB;CACxB,MAAM,2BAAW,IAAI,KAAoC;AAEzD,MAAK,MAAM,WAAW,aAAa;AACjC,MAAI,CAAC,WAAW,OAAO,YAAY,SACjC,OAAM,IAAI,MAAM,iCAAiC;EAGnD,MAAM,OAAO,QAAQ;AACrB,MAAI,OAAO,SAAS,YAAY,KAAK,MAAM,CAAC,WAAW,EACrD,OAAM,IAAI,MAAM,gDAAgD;EAGlE,MAAM,WAAW,SAAS,IAAI,KAAK;AACnC,MAAI,YAAY,aAAa,QAC3B,OAAM,IAAI,MAAM,iBAAiB,KAAK,mCAAmC,WAAW,IAAI;AAG1F,WAAS,IAAI,MAAM,QAAQ;;AAG7B,QAAO;EACL;EACA;EACA,aAAa,SAAS,SAAS,IAAI,KAAK;EACzC;;AAGH,MAAa,sBAAiD,YAAiC;CAC7F,MAAM,aAAa,QAAQ,OAAO;AAClC,QAAO,EACL,SACE,YACwB;AAExB,SAAO,eAAe,YADL,QAAQ,EAAE,gBAAgB,eAAe,YAAY,CAAC,CAC5B;IAE9C"}

package/dist/sync/index.d.ts

@@ -0,0 +1,4 @@
+import { SyncCommandDefinition, SyncCommandHandler, SyncCommandRegistry, SyncCommandTxFactory } from "./types.js";
+import { defineSyncCommands } from "./commands.js";
+import { ReadKey, ReadScope, collectReadKeys, collectReadScopes, collectWriteKeys, stripReadTrackingResults } from "./read-tracking.js";
+export { type ReadKey, type ReadScope, type SyncCommandDefinition, type SyncCommandHandler, type SyncCommandRegistry, type SyncCommandTxFactory, collectReadKeys, collectReadScopes, collectWriteKeys, defineSyncCommands, stripReadTrackingResults };

package/dist/sync/index.js

@@ -0,0 +1,4 @@
+import { defineSyncCommands } from "./commands.js";
+import { collectReadKeys, collectReadScopes, collectWriteKeys, stripReadTrackingResults } from "./read-tracking.js";
+
+export { collectReadKeys, collectReadScopes, collectWriteKeys, defineSyncCommands, stripReadTrackingResults };

package/dist/sync/read-tracking.d.ts

@@ -0,0 +1,25 @@
+import { AnySchema, AnyTable } from "../schema/create.js";
+import { Condition } from "../query/condition-builder.js";
+import { CompiledJoin } from "../query/orm/orm.js";
+import { MutationOperation, RetrievalOperation } from "../query/unit-of-work/unit-of-work.js";
+
+//#region src/sync/read-tracking.d.ts
+type ReadKey = {
+  schema: string;
+  table: string;
+  externalId: string;
+};
+type ReadScope = {
+  schema: string;
+  table: AnyTable;
+  indexName: string;
+  condition?: Condition;
+  joins?: CompiledJoin[];
+};
+declare const collectReadScopes: (operations: ReadonlyArray<RetrievalOperation<AnySchema>>) => ReadScope[];
+declare const collectReadKeys: (operations: ReadonlyArray<RetrievalOperation<AnySchema>>, results: unknown[]) => ReadKey[];
+declare const collectWriteKeys: (operations: ReadonlyArray<MutationOperation<AnySchema>>) => ReadKey[];
+declare const stripReadTrackingResults: (operations: ReadonlyArray<RetrievalOperation<AnySchema>>, results: unknown[]) => void;
+//#endregion
+export { ReadKey, ReadScope, collectReadKeys, collectReadScopes, collectWriteKeys, stripReadTrackingResults };
+//# sourceMappingURL=read-tracking.d.ts.map

package/dist/sync/read-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tracking.d.ts","names":[],"sources":["../../src/sync/read-tracking.ts"],"sourcesContent":[],"mappings":";;;;;;KASY,OAAA;;EAAA,KAAA,EAAA,MAAO;EAMP,UAAA,EAAS,MAAA;CAEZ;AAEK,KAJF,SAAA,GAIE;EACJ,MAAA,EAAA,MAAA;EAAY,KAAA,EAHb,QAGa;EA6HT,SAAA,EAAA,MAAA;EACkC,SAAA,CAAA,EA/HjC,SA+HiC;EAAnB,KAAA,CAAA,EA9HlB,YA8HkB,EAAA;CAAd;AACX,cAFU,iBAEV,EAAA,CAAA,UAAA,EADW,aACX,CADyB,kBACzB,CAD4C,SAC5C,CAAA,CAAA,EAAA,GAAA,SAAA,EAAA;AAAS,cA8CC,eA9CD,EAAA,CAAA,UAAA,EA+CE,aA/CF,CA+CgB,kBA/ChB,CA+CmC,SA/CnC,CAAA,CAAA,EAAA,OAAA,EAAA,OAAA,EAAA,EAAA,GAiDT,OAjDS,EAAA;AA8CC,cA+BA,gBAFZ,EAAA,CAAA,UAAA,EAGa,aAHb,CAG2B,iBAH3B,CAG6C,SAH7C,CAAA,CAAA,EAAA,GAIE,OAJF,EAAA;AA5B8C,cAgElC,wBAhEkC,EAAA,CAAA,UAAA,EAiEjC,aAjEiC,CAiEnB,kBAjEmB,CAiEA,SAjEA,CAAA,CAAA,EAAA,OAAA,EAAA,OAAA,EAAA,EAAA,GAAA,IAAA"}

package/dist/sync/read-tracking.js

@@ -0,0 +1,148 @@
+import { buildCondition } from "../query/condition-builder.js";
+import { FragnoId } from "../schema/create.js";
+
+//#region src/sync/read-tracking.ts
+const isCursorResult = (value) => {
+	if (!value || typeof value !== "object") return false;
+	return Array.isArray(value.items);
+};
+const getExternalId = (value) => {
+	if (typeof value === "string") return value;
+	if (value instanceof FragnoId) return value.externalId;
+	if (value && typeof value === "object") {
+		const candidate = value.externalId;
+		if (typeof candidate === "string") return candidate;
+	}
+};
+const collectKeysFromRecord = (record, table, joins, schemaName, output) => {
+	if (!record || typeof record !== "object") return;
+	const idKey = table.getIdColumn().name;
+	const externalId = getExternalId(record[idKey]);
+	if (externalId !== void 0) output.push({
+		schema: schemaName,
+		table: table.name,
+		externalId
+	});
+	if (!joins || joins.length === 0) return;
+	for (const join of joins) {
+		const { relation, options } = join;
+		if (options === false) continue;
+		const relationValue = record[relation.name];
+		if (relationValue === null || relationValue === void 0) continue;
+		if (Array.isArray(relationValue)) {
+			for (const item of relationValue) collectKeysFromRecord(item, relation.table, options.join, schemaName, output);
+			continue;
+		}
+		collectKeysFromRecord(relationValue, relation.table, options.join, schemaName, output);
+	}
+};
+const shouldStripId = (select, table) => {
+	if (!select || select === true) return false;
+	const idKey = table.getIdColumn().name;
+	return !select.includes(idKey);
+};
+const stripKeysFromRecord = (record, table, joins, stripId) => {
+	if (!record || typeof record !== "object") return;
+	if (stripId) {
+		const idKey = table.getIdColumn().name;
+		delete record[idKey];
+	}
+	if (!joins || joins.length === 0) return;
+	for (const join of joins) {
+		const { relation, options } = join;
+		if (options === false) continue;
+		const relationValue = record[relation.name];
+		if (relationValue === null || relationValue === void 0) continue;
+		const stripRelationId = shouldStripId(options.select, relation.table);
+		if (Array.isArray(relationValue)) {
+			for (const item of relationValue) stripKeysFromRecord(item, relation.table, options.join, stripRelationId);
+			continue;
+		}
+		stripKeysFromRecord(relationValue, relation.table, options.join, stripRelationId);
+	}
+};
+const collectReadScopes = (operations) => {
+	const scopes = [];
+	for (const op of operations) {
+		const schemaName = op.namespace ?? "";
+		if (op.type === "count") {
+			const condition = op.options.where ? buildCondition(op.table.columns, op.options.where) : void 0;
+			if (condition === false) continue;
+			scopes.push({
+				schema: schemaName,
+				table: op.table,
+				indexName: op.indexName,
+				condition: condition === true ? void 0 : condition
+			});
+			continue;
+		}
+		if (op.type === "find") {
+			const condition = op.options.where ? buildCondition(op.table.columns, op.options.where) : void 0;
+			if (condition === false) continue;
+			scopes.push({
+				schema: schemaName,
+				table: op.table,
+				indexName: op.indexName,
+				condition: condition === true ? void 0 : condition,
+				joins: op.options.joins
+			});
+		}
+	}
+	return scopes;
+};
+const collectReadKeys = (operations, results) => {
+	const keys = [];
+	for (const [index, op] of operations.entries()) {
+		if (op.type !== "find") continue;
+		const schemaName = op.namespace ?? "";
+		const result = results[index];
+		let records = [];
+		if (op.withCursor && isCursorResult(result)) records = result.items;
+		else if (Array.isArray(result)) records = result;
+		else if (result !== null && result !== void 0) records = [result];
+		for (const record of records) collectKeysFromRecord(record, op.table, op.options.joins, schemaName, keys);
+	}
+	return keys;
+};
+const collectWriteKeys = (operations) => {
+	const keys = [];
+	for (const op of operations) {
+		if (op.type === "check") continue;
+		const schemaName = op.namespace ?? "";
+		if (op.type === "create") {
+			keys.push({
+				schema: schemaName,
+				table: op.table,
+				externalId: op.generatedExternalId
+			});
+			continue;
+		}
+		const externalId = getExternalId(op.id);
+		if (externalId !== void 0) keys.push({
+			schema: schemaName,
+			table: op.table,
+			externalId
+		});
+	}
+	return keys;
+};
+const stripReadTrackingResults = (operations, results) => {
+	for (const [index, op] of operations.entries()) {
+		if (op.type !== "find" || !op.readTracking) continue;
+		const result = results[index];
+		const stripId = shouldStripId(op.options.select, op.table);
+		if (op.withCursor && isCursorResult(result)) {
+			for (const record of result.items) stripKeysFromRecord(record, op.table, op.options.joins, stripId);
+			continue;
+		}
+		if (Array.isArray(result)) {
+			for (const record of result) stripKeysFromRecord(record, op.table, op.options.joins, stripId);
+			continue;
+		}
+		stripKeysFromRecord(result, op.table, op.options.joins, stripId);
+	}
+};
+
+//#endregion
+export { collectReadKeys, collectReadScopes, collectWriteKeys, stripReadTrackingResults };
+//# sourceMappingURL=read-tracking.js.map

package/dist/sync/read-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tracking.js","names":["scopes: ReadScope[]","keys: ReadKey[]","records: unknown[]"],"sources":["../../src/sync/read-tracking.ts"],"sourcesContent":["import type { Condition } from \"../query/condition-builder\";\nimport { buildCondition } from \"../query/condition-builder\";\nimport type { CursorResult } from \"../query/cursor\";\nimport type { CompiledJoin } from \"../query/orm/orm\";\nimport type { AnySelectClause } from \"../query/simple-query-interface\";\nimport type { MutationOperation, RetrievalOperation } from \"../query/unit-of-work/unit-of-work\";\nimport type { AnySchema, AnyTable } from \"../schema/create\";\nimport { FragnoId } from \"../schema/create\";\n\nexport type ReadKey = {\n  schema: string;\n  table: string;\n  externalId: string;\n};\n\nexport type ReadScope = {\n  schema: string;\n  table: AnyTable;\n  indexName: string;\n  condition?: Condition;\n  joins?: CompiledJoin[];\n};\n\nconst isCursorResult = (value: unknown): value is CursorResult<unknown> => {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  return Array.isArray((value as CursorResult<unknown>).items);\n};\n\nconst getExternalId = (value: unknown): string | undefined => {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value instanceof FragnoId) {\n    return value.externalId;\n  }\n\n  if (value && typeof value === \"object\") {\n    const candidate = (value as { externalId?: unknown }).externalId;\n    if (typeof candidate === \"string\") {\n      return candidate;\n    }\n  }\n\n  return undefined;\n};\n\nconst collectKeysFromRecord = (\n  record: unknown,\n  table: AnyTable,\n  joins: CompiledJoin[] | undefined,\n  schemaName: string,\n  output: ReadKey[],\n): void => {\n  if (!record || typeof record !== \"object\") {\n    return;\n  }\n\n  const idKey = table.getIdColumn().name;\n  const externalId = getExternalId((record as Record<string, unknown>)[idKey]);\n  if (externalId !== undefined) {\n    output.push({ schema: schemaName, table: table.name, externalId });\n  }\n\n  if (!joins || joins.length === 0) {\n    return;\n  }\n\n  for (const join of joins) {\n    const { relation, options } = join;\n    if (options === false) {\n      continue;\n    }\n\n    const relationValue = (record as Record<string, unknown>)[relation.name];\n    if (relationValue === null || relationValue === undefined) {\n      continue;\n    }\n\n    if (Array.isArray(relationValue)) {\n      for (const item of relationValue) {\n        collectKeysFromRecord(item, relation.table, options.join, schemaName, output);\n      }\n      continue;\n    }\n\n    collectKeysFromRecord(relationValue, relation.table, options.join, schemaName, output);\n  }\n};\n\nconst shouldStripId = (select: AnySelectClause | undefined, table: AnyTable): boolean => {\n  if (!select || select === true) {\n    return false;\n  }\n\n  const idKey = table.getIdColumn().name;\n  return !select.includes(idKey);\n};\n\nconst stripKeysFromRecord = (\n  record: unknown,\n  table: AnyTable,\n  joins: CompiledJoin[] | undefined,\n  stripId: boolean,\n): void => {\n  if (!record || typeof record !== \"object\") {\n    return;\n  }\n\n  if (stripId) {\n    const idKey = table.getIdColumn().name;\n    delete (record as Record<string, unknown>)[idKey];\n  }\n\n  if (!joins || joins.length === 0) {\n    return;\n  }\n\n  for (const join of joins) {\n    const { relation, options } = join;\n    if (options === false) {\n      continue;\n    }\n\n    const relationValue = (record as Record<string, unknown>)[relation.name];\n    if (relationValue === null || relationValue === undefined) {\n      continue;\n    }\n\n    const stripRelationId = shouldStripId(options.select, relation.table);\n\n    if (Array.isArray(relationValue)) {\n      for (const item of relationValue) {\n        stripKeysFromRecord(item, relation.table, options.join, stripRelationId);\n      }\n      continue;\n    }\n\n    stripKeysFromRecord(relationValue, relation.table, options.join, stripRelationId);\n  }\n};\n\nexport const collectReadScopes = (\n  operations: ReadonlyArray<RetrievalOperation<AnySchema>>,\n): ReadScope[] => {\n  const scopes: ReadScope[] = [];\n\n  for (const op of operations) {\n    const schemaName = op.namespace ?? \"\";\n\n    if (op.type === \"count\") {\n      const condition = op.options.where\n        ? buildCondition(op.table.columns, op.options.where)\n        : undefined;\n\n      if (condition === false) {\n        continue;\n      }\n\n      scopes.push({\n        schema: schemaName,\n        table: op.table,\n        indexName: op.indexName,\n        condition: condition === true ? undefined : condition,\n      });\n      continue;\n    }\n\n    if (op.type === \"find\") {\n      const condition = op.options.where\n        ? buildCondition(op.table.columns, op.options.where)\n        : undefined;\n\n      if (condition === false) {\n        continue;\n      }\n\n      scopes.push({\n        schema: schemaName,\n        table: op.table,\n        indexName: op.indexName,\n        condition: condition === true ? undefined : condition,\n        joins: op.options.joins,\n      });\n    }\n  }\n\n  return scopes;\n};\n\nexport const collectReadKeys = (\n  operations: ReadonlyArray<RetrievalOperation<AnySchema>>,\n  results: unknown[],\n): ReadKey[] => {\n  const keys: ReadKey[] = [];\n\n  for (const [index, op] of operations.entries()) {\n    if (op.type !== \"find\") {\n      continue;\n    }\n\n    const schemaName = op.namespace ?? \"\";\n    const result = results[index];\n\n    let records: unknown[] = [];\n    if (op.withCursor && isCursorResult(result)) {\n      records = result.items;\n    } else if (Array.isArray(result)) {\n      records = result;\n    } else if (result !== null && result !== undefined) {\n      records = [result];\n    }\n\n    for (const record of records) {\n      collectKeysFromRecord(record, op.table, op.options.joins, schemaName, keys);\n    }\n  }\n\n  return keys;\n};\n\nexport const collectWriteKeys = (\n  operations: ReadonlyArray<MutationOperation<AnySchema>>,\n): ReadKey[] => {\n  const keys: ReadKey[] = [];\n\n  for (const op of operations) {\n    if (op.type === \"check\") {\n      continue;\n    }\n\n    const schemaName = op.namespace ?? \"\";\n\n    if (op.type === \"create\") {\n      keys.push({\n        schema: schemaName,\n        table: op.table,\n        externalId: op.generatedExternalId,\n      });\n      continue;\n    }\n\n    const externalId = getExternalId(op.id);\n    if (externalId !== undefined) {\n      keys.push({\n        schema: schemaName,\n        table: op.table,\n        externalId,\n      });\n    }\n  }\n\n  return keys;\n};\n\nexport const stripReadTrackingResults = (\n  operations: ReadonlyArray<RetrievalOperation<AnySchema>>,\n  results: unknown[],\n): void => {\n  for (const [index, op] of operations.entries()) {\n    if (op.type !== \"find\" || !op.readTracking) {\n      continue;\n    }\n\n    const result = results[index];\n    const stripId = shouldStripId(op.options.select, op.table);\n\n    if (op.withCursor && isCursorResult(result)) {\n      for (const record of result.items) {\n        stripKeysFromRecord(record, op.table, op.options.joins, stripId);\n      }\n      continue;\n    }\n\n    if (Array.isArray(result)) {\n      for (const record of result) {\n        stripKeysFromRecord(record, op.table, op.options.joins, stripId);\n      }\n      continue;\n    }\n\n    stripKeysFromRecord(result, op.table, op.options.joins, stripId);\n  }\n};\n"],"mappings":";;;;AAuBA,MAAM,kBAAkB,UAAmD;AACzE,KAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO;AAGT,QAAO,MAAM,QAAS,MAAgC,MAAM;;AAG9D,MAAM,iBAAiB,UAAuC;AAC5D,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI,iBAAiB,SACnB,QAAO,MAAM;AAGf,KAAI,SAAS,OAAO,UAAU,UAAU;EACtC,MAAM,YAAa,MAAmC;AACtD,MAAI,OAAO,cAAc,SACvB,QAAO;;;AAOb,MAAM,yBACJ,QACA,OACA,OACA,YACA,WACS;AACT,KAAI,CAAC,UAAU,OAAO,WAAW,SAC/B;CAGF,MAAM,QAAQ,MAAM,aAAa,CAAC;CAClC,MAAM,aAAa,cAAe,OAAmC,OAAO;AAC5E,KAAI,eAAe,OACjB,QAAO,KAAK;EAAE,QAAQ;EAAY,OAAO,MAAM;EAAM;EAAY,CAAC;AAGpE,KAAI,CAAC,SAAS,MAAM,WAAW,EAC7B;AAGF,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,EAAE,UAAU,YAAY;AAC9B,MAAI,YAAY,MACd;EAGF,MAAM,gBAAiB,OAAmC,SAAS;AACnE,MAAI,kBAAkB,QAAQ,kBAAkB,OAC9C;AAGF,MAAI,MAAM,QAAQ,cAAc,EAAE;AAChC,QAAK,MAAM,QAAQ,cACjB,uBAAsB,MAAM,SAAS,OAAO,QAAQ,MAAM,YAAY,OAAO;AAE/E;;AAGF,wBAAsB,eAAe,SAAS,OAAO,QAAQ,MAAM,YAAY,OAAO;;;AAI1F,MAAM,iBAAiB,QAAqC,UAA6B;AACvF,KAAI,CAAC,UAAU,WAAW,KACxB,QAAO;CAGT,MAAM,QAAQ,MAAM,aAAa,CAAC;AAClC,QAAO,CAAC,OAAO,SAAS,MAAM;;AAGhC,MAAM,uBACJ,QACA,OACA,OACA,YACS;AACT,KAAI,CAAC,UAAU,OAAO,WAAW,SAC/B;AAGF,KAAI,SAAS;EACX,MAAM,QAAQ,MAAM,aAAa,CAAC;AAClC,SAAQ,OAAmC;;AAG7C,KAAI,CAAC,SAAS,MAAM,WAAW,EAC7B;AAGF,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,EAAE,UAAU,YAAY;AAC9B,MAAI,YAAY,MACd;EAGF,MAAM,gBAAiB,OAAmC,SAAS;AACnE,MAAI,kBAAkB,QAAQ,kBAAkB,OAC9C;EAGF,MAAM,kBAAkB,cAAc,QAAQ,QAAQ,SAAS,MAAM;AAErE,MAAI,MAAM,QAAQ,cAAc,EAAE;AAChC,QAAK,MAAM,QAAQ,cACjB,qBAAoB,MAAM,SAAS,OAAO,QAAQ,MAAM,gBAAgB;AAE1E;;AAGF,sBAAoB,eAAe,SAAS,OAAO,QAAQ,MAAM,gBAAgB;;;AAIrF,MAAa,qBACX,eACgB;CAChB,MAAMA,SAAsB,EAAE;AAE9B,MAAK,MAAM,MAAM,YAAY;EAC3B,MAAM,aAAa,GAAG,aAAa;AAEnC,MAAI,GAAG,SAAS,SAAS;GACvB,MAAM,YAAY,GAAG,QAAQ,QACzB,eAAe,GAAG,MAAM,SAAS,GAAG,QAAQ,MAAM,GAClD;AAEJ,OAAI,cAAc,MAChB;AAGF,UAAO,KAAK;IACV,QAAQ;IACR,OAAO,GAAG;IACV,WAAW,GAAG;IACd,WAAW,cAAc,OAAO,SAAY;IAC7C,CAAC;AACF;;AAGF,MAAI,GAAG,SAAS,QAAQ;GACtB,MAAM,YAAY,GAAG,QAAQ,QACzB,eAAe,GAAG,MAAM,SAAS,GAAG,QAAQ,MAAM,GAClD;AAEJ,OAAI,cAAc,MAChB;AAGF,UAAO,KAAK;IACV,QAAQ;IACR,OAAO,GAAG;IACV,WAAW,GAAG;IACd,WAAW,cAAc,OAAO,SAAY;IAC5C,OAAO,GAAG,QAAQ;IACnB,CAAC;;;AAIN,QAAO;;AAGT,MAAa,mBACX,YACA,YACc;CACd,MAAMC,OAAkB,EAAE;AAE1B,MAAK,MAAM,CAAC,OAAO,OAAO,WAAW,SAAS,EAAE;AAC9C,MAAI,GAAG,SAAS,OACd;EAGF,MAAM,aAAa,GAAG,aAAa;EACnC,MAAM,SAAS,QAAQ;EAEvB,IAAIC,UAAqB,EAAE;AAC3B,MAAI,GAAG,cAAc,eAAe,OAAO,CACzC,WAAU,OAAO;WACR,MAAM,QAAQ,OAAO,CAC9B,WAAU;WACD,WAAW,QAAQ,WAAW,OACvC,WAAU,CAAC,OAAO;AAGpB,OAAK,MAAM,UAAU,QACnB,uBAAsB,QAAQ,GAAG,OAAO,GAAG,QAAQ,OAAO,YAAY,KAAK;;AAI/E,QAAO;;AAGT,MAAa,oBACX,eACc;CACd,MAAMD,OAAkB,EAAE;AAE1B,MAAK,MAAM,MAAM,YAAY;AAC3B,MAAI,GAAG,SAAS,QACd;EAGF,MAAM,aAAa,GAAG,aAAa;AAEnC,MAAI,GAAG,SAAS,UAAU;AACxB,QAAK,KAAK;IACR,QAAQ;IACR,OAAO,GAAG;IACV,YAAY,GAAG;IAChB,CAAC;AACF;;EAGF,MAAM,aAAa,cAAc,GAAG,GAAG;AACvC,MAAI,eAAe,OACjB,MAAK,KAAK;GACR,QAAQ;GACR,OAAO,GAAG;GACV;GACD,CAAC;;AAIN,QAAO;;AAGT,MAAa,4BACX,YACA,YACS;AACT,MAAK,MAAM,CAAC,OAAO,OAAO,WAAW,SAAS,EAAE;AAC9C,MAAI,GAAG,SAAS,UAAU,CAAC,GAAG,aAC5B;EAGF,MAAM,SAAS,QAAQ;EACvB,MAAM,UAAU,cAAc,GAAG,QAAQ,QAAQ,GAAG,MAAM;AAE1D,MAAI,GAAG,cAAc,eAAe,OAAO,EAAE;AAC3C,QAAK,MAAM,UAAU,OAAO,MAC1B,qBAAoB,QAAQ,GAAG,OAAO,GAAG,QAAQ,OAAO,QAAQ;AAElE;;AAGF,MAAI,MAAM,QAAQ,OAAO,EAAE;AACzB,QAAK,MAAM,UAAU,OACnB,qBAAoB,QAAQ,GAAG,OAAO,GAAG,QAAQ,OAAO,QAAQ;AAElE;;AAGF,sBAAoB,QAAQ,GAAG,OAAO,GAAG,QAAQ,OAAO,QAAQ"}

package/dist/sync/submit.js

@@ -0,0 +1,213 @@
+import { ConcurrencyConflictError } from "../query/unit-of-work/execute-unit-of-work.js";
+
+//#region src/sync/submit.ts
+const DEFAULT_MAX_COMMANDS_PER_SUBMIT = 100;
+const DEFAULT_MAX_UNSEEN_MUTATIONS = 1e4;
+const VALID_CONFLICT_RESOLUTION = new Set(["server", "disabled"]);
+const VERSIONSTAMP_REGEX = /^[0-9a-f]{24}$/i;
+const isObject = (value) => value !== null && typeof value === "object";
+const isNonEmptyString = (value) => typeof value === "string" && value.trim().length > 0;
+const normalizeVersionstamp = (value) => value ? value.toLowerCase() : void 0;
+const isValidVersionstamp = (value) => VERSIONSTAMP_REGEX.test(value);
+const buildError = (code, message, statusCode = 400) => ({
+	status: "error",
+	statusCode,
+	body: { error: {
+		code,
+		message
+	} }
+});
+const withEntries = async (runtime, baseVersionstamp) => {
+	const entries = await runtime.listOutboxEntries(baseVersionstamp);
+	return {
+		entries,
+		lastVersionstamp: entries.length > 0 ? entries[entries.length - 1]?.versionstamp : void 0
+	};
+};
+const submitSyncRequest = async (raw, runtime) => {
+	if (!isObject(raw)) return buildError("INVALID_REQUEST", "Request body must be an object.");
+	const requestId = raw["requestId"];
+	if (!isNonEmptyString(requestId)) return buildError("INVALID_REQUEST", "requestId is required.");
+	const adapterIdentity = raw["adapterIdentity"];
+	if (!isNonEmptyString(adapterIdentity)) return buildError("INVALID_REQUEST", "adapterIdentity is required.");
+	const conflictResolutionStrategy = raw["conflictResolutionStrategy"];
+	if (!isNonEmptyString(conflictResolutionStrategy) || !VALID_CONFLICT_RESOLUTION.has(conflictResolutionStrategy)) return buildError("INVALID_REQUEST", "conflictResolutionStrategy must be \"server\" or \"disabled\".");
+	const baseVersionstamp = raw["baseVersionstamp"];
+	if (baseVersionstamp !== void 0 && !isNonEmptyString(baseVersionstamp)) return buildError("INVALID_REQUEST", "baseVersionstamp must be a non-empty string.");
+	const normalizedBaseVersionstamp = baseVersionstamp !== void 0 ? normalizeVersionstamp(baseVersionstamp) : void 0;
+	if (normalizedBaseVersionstamp && !isValidVersionstamp(normalizedBaseVersionstamp)) return buildError("INVALID_VERSIONSTAMP", "baseVersionstamp must be 24 hex characters.");
+	const commands = raw["commands"];
+	if (!Array.isArray(commands)) return buildError("INVALID_REQUEST", "commands must be an array.");
+	if (await runtime.getAdapterIdentity() !== adapterIdentity) return buildError("ADAPTER_IDENTITY_MISMATCH", "adapterIdentity does not match this adapter.", 409);
+	const existing = await runtime.getSyncRequest(requestId);
+	if (existing) {
+		const { entries: entries$1, lastVersionstamp: lastVersionstamp$1 } = await withEntries(runtime, normalizedBaseVersionstamp);
+		return {
+			status: "ok",
+			response: {
+				status: "conflict",
+				requestId,
+				confirmedCommandIds: existing.confirmedCommandIds ?? [],
+				conflictCommandId: existing.conflictCommandId ?? void 0,
+				lastVersionstamp: lastVersionstamp$1 ?? existing.lastVersionstamp ?? void 0,
+				entries: entries$1,
+				reason: "already_handled"
+			}
+		};
+	}
+	const maxCommands = runtime.maxCommandsPerSubmit ?? DEFAULT_MAX_COMMANDS_PER_SUBMIT;
+	const maxUnseen = runtime.maxUnseenMutations ?? DEFAULT_MAX_UNSEEN_MUTATIONS;
+	if (commands.length === 0) {
+		const { entries: entries$1, lastVersionstamp: lastVersionstamp$1 } = await withEntries(runtime, normalizedBaseVersionstamp);
+		const response$1 = {
+			status: "conflict",
+			requestId,
+			confirmedCommandIds: [],
+			entries: entries$1,
+			lastVersionstamp: lastVersionstamp$1,
+			reason: "no_commands"
+		};
+		await runtime.storeSyncRequest({
+			requestId,
+			status: "conflict",
+			confirmedCommandIds: [],
+			baseVersionstamp: normalizedBaseVersionstamp,
+			lastVersionstamp: lastVersionstamp$1
+		});
+		return {
+			status: "ok",
+			response: response$1
+		};
+	}
+	if (commands.length > maxCommands) {
+		const { entries: entries$1, lastVersionstamp: lastVersionstamp$1 } = await withEntries(runtime, normalizedBaseVersionstamp);
+		const response$1 = {
+			status: "conflict",
+			requestId,
+			confirmedCommandIds: [],
+			entries: entries$1,
+			lastVersionstamp: lastVersionstamp$1,
+			reason: "limit_exceeded"
+		};
+		await runtime.storeSyncRequest({
+			requestId,
+			status: "conflict",
+			confirmedCommandIds: [],
+			baseVersionstamp: normalizedBaseVersionstamp,
+			lastVersionstamp: lastVersionstamp$1
+		});
+		return {
+			status: "ok",
+			response: response$1
+		};
+	}
+	if (await runtime.countOutboxMutations(normalizedBaseVersionstamp) > maxUnseen) {
+		const { entries: entries$1, lastVersionstamp: lastVersionstamp$1 } = await withEntries(runtime, normalizedBaseVersionstamp);
+		const response$1 = {
+			status: "conflict",
+			requestId,
+			confirmedCommandIds: [],
+			entries: entries$1,
+			lastVersionstamp: lastVersionstamp$1,
+			reason: "client_far_behind"
+		};
+		await runtime.storeSyncRequest({
+			requestId,
+			status: "conflict",
+			confirmedCommandIds: [],
+			baseVersionstamp: normalizedBaseVersionstamp,
+			lastVersionstamp: lastVersionstamp$1
+		});
+		return {
+			status: "ok",
+			response: response$1
+		};
+	}
+	const confirmedCommandIds = [];
+	let conflictCommandId;
+	let conflictReason;
+	for (const command of commands) {
+		if (!isObject(command)) return buildError("INVALID_COMMAND", "Command entries must be objects.");
+		const commandId = command["id"];
+		const commandName = command["name"];
+		const target = command["target"];
+		if (!isNonEmptyString(commandId) || !isNonEmptyString(commandName) || !isObject(target)) return buildError("INVALID_COMMAND", "Command entries must include id, name, and target.");
+		const fragmentName = target["fragment"];
+		const schemaName = target["schema"];
+		if (!isNonEmptyString(fragmentName) || !isNonEmptyString(schemaName)) return buildError("INVALID_COMMAND", "Command target must include fragment and schema.");
+		const resolved = runtime.resolveCommand(fragmentName, schemaName, commandName);
+		if (!resolved) return buildError("UNKNOWN_COMMAND", "Command target or name was not recognized.");
+		const ctx = runtime.createCommandContext(resolved.command);
+		try {
+			await runtime.executeCommand(resolved.command, command["input"], ctx);
+			confirmedCommandIds.push(commandId);
+		} catch (error) {
+			if (error instanceof ConcurrencyConflictError) {
+				conflictCommandId = commandId;
+				conflictReason = "write_congestion";
+				break;
+			}
+			await runtime.storeSyncRequest({
+				requestId,
+				status: "conflict",
+				confirmedCommandIds,
+				conflictCommandId: commandId,
+				baseVersionstamp: normalizedBaseVersionstamp
+			});
+			return {
+				status: "error",
+				statusCode: 500,
+				body: { error: {
+					code: "SYNC_COMMAND_FAILED",
+					message: error instanceof Error ? error.message : "Sync command failed."
+				} }
+			};
+		}
+	}
+	const { entries, lastVersionstamp } = await withEntries(runtime, normalizedBaseVersionstamp);
+	if (conflictReason) {
+		const response$1 = {
+			status: "conflict",
+			requestId,
+			confirmedCommandIds,
+			conflictCommandId,
+			entries,
+			lastVersionstamp,
+			reason: conflictReason
+		};
+		await runtime.storeSyncRequest({
+			requestId,
+			status: "conflict",
+			confirmedCommandIds,
+			conflictCommandId,
+			baseVersionstamp: normalizedBaseVersionstamp,
+			lastVersionstamp
+		});
+		return {
+			status: "ok",
+			response: response$1
+		};
+	}
+	const response = {
+		status: "applied",
+		requestId,
+		confirmedCommandIds,
+		entries,
+		lastVersionstamp
+	};
+	await runtime.storeSyncRequest({
+		requestId,
+		status: "applied",
+		confirmedCommandIds,
+		baseVersionstamp: normalizedBaseVersionstamp,
+		lastVersionstamp
+	});
+	return {
+		status: "ok",
+		response
+	};
+};
+
+//#endregion
+export { submitSyncRequest };
+//# sourceMappingURL=submit.js.map

package/dist/sync/submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.js","names":["lastVersionstamp","response: SubmitResponse","confirmedCommandIds: string[]","conflictCommandId: string | undefined","conflictReason: SubmitConflictReason | undefined"],"sources":["../../src/sync/submit.ts"],"sourcesContent":["import type { OutboxEntry } from \"../outbox/outbox\";\nimport { ConcurrencyConflictError } from \"../query/unit-of-work/execute-unit-of-work\";\nimport type { SubmitResponse, SubmitConflictReason, SyncCommandDefinition } from \"./types\";\n\nexport const DEFAULT_MAX_COMMANDS_PER_SUBMIT = 100;\nexport const DEFAULT_MAX_UNSEEN_MUTATIONS = 10_000;\n\nexport type SyncRequestRecord = {\n  requestId: string;\n  status: \"applied\" | \"conflict\";\n  confirmedCommandIds: string[];\n  conflictCommandId?: string;\n  baseVersionstamp?: string;\n  lastVersionstamp?: string;\n};\n\nexport type SyncCommandResolution = {\n  command: SyncCommandDefinition;\n  namespace: string | null;\n};\n\nexport type SyncSubmitRuntime = {\n  getAdapterIdentity: () => Promise<string>;\n  listOutboxEntries: (afterVersionstamp?: string) => Promise<OutboxEntry[]>;\n  countOutboxMutations: (afterVersionstamp?: string) => Promise<number>;\n  getSyncRequest: (requestId: string) => Promise<SyncRequestRecord | undefined>;\n  storeSyncRequest: (record: SyncRequestRecord) => Promise<void>;\n  resolveCommand: (\n    fragment: string,\n    schema: string,\n    name: string,\n  ) => SyncCommandResolution | undefined;\n  createCommandContext: (command: SyncCommandDefinition) => unknown;\n  executeCommand: (command: SyncCommandDefinition, input: unknown, ctx: unknown) => Promise<void>;\n  maxCommandsPerSubmit?: number;\n  maxUnseenMutations?: number;\n};\n\nexport type SyncSubmitError = {\n  status: \"error\";\n  statusCode: number;\n  body: {\n    error: {\n      code: string;\n      message: string;\n      detail?: string;\n    };\n  };\n};\n\nexport type SyncSubmitResult =\n  | {\n      status: \"ok\";\n      response: SubmitResponse;\n    }\n  | SyncSubmitError;\n\nconst VALID_CONFLICT_RESOLUTION = new Set([\"server\", \"disabled\"] as const);\nconst VERSIONSTAMP_REGEX = /^[0-9a-f]{24}$/i;\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === \"object\";\n\nconst isNonEmptyString = (value: unknown): value is string =>\n  typeof value === \"string\" && value.trim().length > 0;\n\nconst normalizeVersionstamp = (value: string | undefined): string | undefined =>\n  value ? value.toLowerCase() : undefined;\n\nconst isValidVersionstamp = (value: string): boolean => VERSIONSTAMP_REGEX.test(value);\n\nconst buildError = (code: string, message: string, statusCode = 400): SyncSubmitError => ({\n  status: \"error\",\n  statusCode,\n  body: {\n    error: {\n      code,\n      message,\n    },\n  },\n});\n\nconst withEntries = async (\n  runtime: SyncSubmitRuntime,\n  baseVersionstamp: string | undefined,\n): Promise<{ entries: OutboxEntry[]; lastVersionstamp?: string }> => {\n  const entries = await runtime.listOutboxEntries(baseVersionstamp);\n  const lastVersionstamp =\n    entries.length > 0 ? entries[entries.length - 1]?.versionstamp : undefined;\n  return { entries, lastVersionstamp };\n};\n\nexport const submitSyncRequest = async (\n  raw: unknown,\n  runtime: SyncSubmitRuntime,\n): Promise<SyncSubmitResult> => {\n  if (!isObject(raw)) {\n    return buildError(\"INVALID_REQUEST\", \"Request body must be an object.\");\n  }\n\n  const requestId = raw[\"requestId\"];\n  if (!isNonEmptyString(requestId)) {\n    return buildError(\"INVALID_REQUEST\", \"requestId is required.\");\n  }\n\n  const adapterIdentity = raw[\"adapterIdentity\"];\n  if (!isNonEmptyString(adapterIdentity)) {\n    return buildError(\"INVALID_REQUEST\", \"adapterIdentity is required.\");\n  }\n\n  const conflictResolutionStrategy = raw[\"conflictResolutionStrategy\"];\n  if (\n    !isNonEmptyString(conflictResolutionStrategy) ||\n    !VALID_CONFLICT_RESOLUTION.has(conflictResolutionStrategy as \"server\" | \"disabled\")\n  ) {\n    return buildError(\n      \"INVALID_REQUEST\",\n      'conflictResolutionStrategy must be \"server\" or \"disabled\".',\n    );\n  }\n\n  const baseVersionstamp = raw[\"baseVersionstamp\"];\n  if (baseVersionstamp !== undefined && !isNonEmptyString(baseVersionstamp)) {\n    return buildError(\"INVALID_REQUEST\", \"baseVersionstamp must be a non-empty string.\");\n  }\n\n  const normalizedBaseVersionstamp =\n    baseVersionstamp !== undefined ? normalizeVersionstamp(baseVersionstamp) : undefined;\n  if (normalizedBaseVersionstamp && !isValidVersionstamp(normalizedBaseVersionstamp)) {\n    return buildError(\"INVALID_VERSIONSTAMP\", \"baseVersionstamp must be 24 hex characters.\");\n  }\n\n  const commands = raw[\"commands\"];\n  if (!Array.isArray(commands)) {\n    return buildError(\"INVALID_REQUEST\", \"commands must be an array.\");\n  }\n\n  const expectedAdapterIdentity = await runtime.getAdapterIdentity();\n  if (expectedAdapterIdentity !== adapterIdentity) {\n    return buildError(\n      \"ADAPTER_IDENTITY_MISMATCH\",\n      \"adapterIdentity does not match this adapter.\",\n      409,\n    );\n  }\n\n  const existing = await runtime.getSyncRequest(requestId);\n  if (existing) {\n    const { entries, lastVersionstamp } = await withEntries(runtime, normalizedBaseVersionstamp);\n    const response: SubmitResponse = {\n      status: \"conflict\",\n      requestId,\n      confirmedCommandIds: existing.confirmedCommandIds ?? [],\n      conflictCommandId: existing.conflictCommandId ?? undefined,\n      lastVersionstamp: lastVersionstamp ?? existing.lastVersionstamp ?? undefined,\n      entries,\n      reason: \"already_handled\",\n    };\n    return { status: \"ok\", response };\n  }\n\n  const maxCommands = runtime.maxCommandsPerSubmit ?? DEFAULT_MAX_COMMANDS_PER_SUBMIT;\n  const maxUnseen = runtime.maxUnseenMutations ?? DEFAULT_MAX_UNSEEN_MUTATIONS;\n\n  if (commands.length === 0) {\n    const { entries, lastVersionstamp } = await withEntries(runtime, normalizedBaseVersionstamp);\n    const response: SubmitResponse = {\n      status: \"conflict\",\n      requestId,\n      confirmedCommandIds: [],\n      entries,\n      lastVersionstamp,\n      reason: \"no_commands\",\n    };\n    await runtime.storeSyncRequest({\n      requestId,\n      status: \"conflict\",\n      confirmedCommandIds: [],\n      baseVersionstamp: normalizedBaseVersionstamp,\n      lastVersionstamp,\n    });\n    return { status: \"ok\", response };\n  }\n\n  if (commands.length > maxCommands) {\n    const { entries, lastVersionstamp } = await withEntries(runtime, normalizedBaseVersionstamp);\n    const response: SubmitResponse = {\n      status: \"conflict\",\n      requestId,\n      confirmedCommandIds: [],\n      entries,\n      lastVersionstamp,\n      reason: \"limit_exceeded\",\n    };\n    await runtime.storeSyncRequest({\n      requestId,\n      status: \"conflict\",\n      confirmedCommandIds: [],\n      baseVersionstamp: normalizedBaseVersionstamp,\n      lastVersionstamp,\n    });\n    return { status: \"ok\", response };\n  }\n\n  const unseenCount = await runtime.countOutboxMutations(normalizedBaseVersionstamp);\n  if (unseenCount > maxUnseen) {\n    const { entries, lastVersionstamp } = await withEntries(runtime, normalizedBaseVersionstamp);\n    const response: SubmitResponse = {\n      status: \"conflict\",\n      requestId,\n      confirmedCommandIds: [],\n      entries,\n      lastVersionstamp,\n      reason: \"client_far_behind\",\n    };\n    await runtime.storeSyncRequest({\n      requestId,\n      status: \"conflict\",\n      confirmedCommandIds: [],\n      baseVersionstamp: normalizedBaseVersionstamp,\n      lastVersionstamp,\n    });\n    return { status: \"ok\", response };\n  }\n\n  const confirmedCommandIds: string[] = [];\n  let conflictCommandId: string | undefined;\n  let conflictReason: SubmitConflictReason | undefined;\n\n  for (const command of commands) {\n    if (!isObject(command)) {\n      return buildError(\"INVALID_COMMAND\", \"Command entries must be objects.\");\n    }\n\n    const commandId = command[\"id\"];\n    const commandName = command[\"name\"];\n    const target = command[\"target\"];\n\n    if (!isNonEmptyString(commandId) || !isNonEmptyString(commandName) || !isObject(target)) {\n      return buildError(\"INVALID_COMMAND\", \"Command entries must include id, name, and target.\");\n    }\n\n    const fragmentName = target[\"fragment\"];\n    const schemaName = target[\"schema\"];\n\n    if (!isNonEmptyString(fragmentName) || !isNonEmptyString(schemaName)) {\n      return buildError(\"INVALID_COMMAND\", \"Command target must include fragment and schema.\");\n    }\n\n    const resolved = runtime.resolveCommand(fragmentName, schemaName, commandName);\n    if (!resolved) {\n      return buildError(\"UNKNOWN_COMMAND\", \"Command target or name was not recognized.\");\n    }\n\n    const ctx = runtime.createCommandContext(resolved.command);\n\n    try {\n      await runtime.executeCommand(resolved.command, command[\"input\"], ctx);\n      confirmedCommandIds.push(commandId);\n    } catch (error) {\n      if (error instanceof ConcurrencyConflictError) {\n        conflictCommandId = commandId;\n        conflictReason = \"write_congestion\";\n        break;\n      }\n      await runtime.storeSyncRequest({\n        requestId,\n        status: \"conflict\",\n        confirmedCommandIds,\n        conflictCommandId: commandId,\n        baseVersionstamp: normalizedBaseVersionstamp,\n      });\n      return {\n        status: \"error\",\n        statusCode: 500,\n        body: {\n          error: {\n            code: \"SYNC_COMMAND_FAILED\",\n            message: error instanceof Error ? error.message : \"Sync command failed.\",\n          },\n        },\n      };\n    }\n  }\n\n  const { entries, lastVersionstamp } = await withEntries(runtime, normalizedBaseVersionstamp);\n\n  if (conflictReason) {\n    const response: SubmitResponse = {\n      status: \"conflict\",\n      requestId,\n      confirmedCommandIds,\n      conflictCommandId,\n      entries,\n      lastVersionstamp,\n      reason: conflictReason,\n    };\n\n    await runtime.storeSyncRequest({\n      requestId,\n      status: \"conflict\",\n      confirmedCommandIds,\n      conflictCommandId,\n      baseVersionstamp: normalizedBaseVersionstamp,\n      lastVersionstamp,\n    });\n\n    return { status: \"ok\", response };\n  }\n\n  const response: SubmitResponse = {\n    status: \"applied\",\n    requestId,\n    confirmedCommandIds,\n    entries,\n    lastVersionstamp,\n  };\n\n  await runtime.storeSyncRequest({\n    requestId,\n    status: \"applied\",\n    confirmedCommandIds,\n    baseVersionstamp: normalizedBaseVersionstamp,\n    lastVersionstamp,\n  });\n\n  return { status: \"ok\", response };\n};\n"],"mappings":"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"}

package/dist/sync/types.d.ts

@@ -0,0 +1,63 @@
+import { ExecuteTxOptions, HandlerTxBuilder } from "../query/unit-of-work/execute-unit-of-work.js";
+import { OutboxEntry } from "../outbox/outbox.js";
+import { RequestThisContext } from "@fragno-dev/core";
+
+//#region src/sync/types.d.ts
+type SubmitRequest = {
+  baseVersionstamp?: string;
+  requestId: string;
+  conflictResolutionStrategy: "server" | "disabled";
+  adapterIdentity: string;
+  commands: Array<{
+    id: string;
+    name: string;
+    target: {
+      fragment: string;
+      schema: string;
+    };
+    input: unknown;
+  }>;
+};
+type SubmitConflictReason = "conflict" | "write_congestion" | "client_far_behind" | "no_commands" | "already_handled" | "limit_exceeded";
+type SubmitAppliedResponse = {
+  status: "applied";
+  requestId: string;
+  confirmedCommandIds: string[];
+  lastVersionstamp?: string;
+  entries: OutboxEntry[];
+};
+type SubmitConflictResponse = {
+  status: "conflict";
+  requestId: string;
+  confirmedCommandIds: string[];
+  conflictCommandId?: string;
+  lastVersionstamp?: string;
+  entries: OutboxEntry[];
+  reason: SubmitConflictReason;
+};
+type SubmitResponse = SubmitAppliedResponse | SubmitConflictResponse;
+type SyncCommandTxFactory = (options?: Omit<ExecuteTxOptions, "createUnitOfWork">) => HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, {}>;
+type SyncCommandHandler<TInput = unknown, TContext = unknown> = (args: {
+  input: TInput;
+  tx: SyncCommandTxFactory;
+  ctx: TContext;
+}) => Promise<unknown>;
+type SyncCommandDefinition<TInput = unknown, TContext = unknown> = {
+  name: string;
+  handler: SyncCommandHandler<TInput, TContext>;
+  createServerContext?: (requestContext: RequestThisContext) => TContext;
+};
+type SyncCommandRegistry = {
+  schemaName: string;
+  commands: Map<string, SyncCommandDefinition>;
+  getCommand: (name: string) => SyncCommandDefinition | undefined;
+};
+type SyncCommandTargetRegistration = {
+  fragmentName: string;
+  schemaName: string;
+  namespace: string | null;
+  commands: Map<string, SyncCommandDefinition>;
+};
+//#endregion
+export { SubmitAppliedResponse, SubmitConflictReason, SubmitConflictResponse, SubmitRequest, SubmitResponse, SyncCommandDefinition, SyncCommandHandler, SyncCommandRegistry, SyncCommandTargetRegistration, SyncCommandTxFactory };
+//# sourceMappingURL=types.d.ts.map

package/dist/sync/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/sync/types.ts"],"sourcesContent":[],"mappings":";;;;;KAQY,aAAA;;EAAA,SAAA,EAAA,MAAa;EAgBb,0BAAoB,EAAA,QAAA,GAAA,UAAA;EAQpB,eAAA,EAAA,MAAA;EAQA,QAAA,EA3BA,KA2BA,CAAA;IAUA,EAAA,EAAA,MAAA;IAEA,IAAA,EAAA,MAAA;IACK,MAAA,EAAA;MAAL,QAAA,EAAA,MAAA;MACP,MAAA,EAAA,MAAA;IAAgB,CAAA;IAET,KAAA,EAAA,OAAA;EACH,CAAA,CAAA;CACH;AACC,KAnCK,oBAAA,GAmCL,UAAA,GAAA,kBAAA,GAAA,mBAAA,GAAA,aAAA,GAAA,iBAAA,GAAA,gBAAA;AACD,KA5BM,qBAAA,GA4BN;EAAO,MAAA,EAAA,SAAA;EAED,SAAA,EAAA,MAAA;EAEkB,mBAAA,EAAA,MAAA,EAAA;EAAQ,gBAAA,CAAA,EAAA,MAAA;EAA3B,OAAA,EA3BA,WA2BA,EAAA;CAC8B;AAAuB,KAzBpD,sBAAA,GAyBoD;EAAQ,MAAA,EAAA,UAAA;EAG5D,SAAA,EAAA,MAAA;EAEY,mBAAA,EAAA,MAAA,EAAA;EAAZ,iBAAA,CAAA,EAAA,MAAA;EACoB,gBAAA,CAAA,EAAA,MAAA;EAAqB,OAAA,EAzB1C,WAyB0C,EAAA;EAGzC,MAAA,EA3BF,oBA2BE;;KAxBA,cAAA,GAAiB,wBAAwB;KAEzC,oBAAA,cACA,KAAK,0CACZ;KAEO;SACH;MACH;OACC;MACD;KAEM;;WAED,mBAAmB,QAAQ;yCACG,uBAAuB;;KAGpD,mBAAA;;YAEA,YAAY;gCACQ;;KAGpB,6BAAA;;;;YAIA,YAAY"}

package/dist/util/default-database-adapter.js

@@ -1,11 +1,15 @@
-import { SqlAdapter } from "../adapters/generic-sql/generic-sql-adapter.js";
 import { BetterSQLite3DriverConfig } from "../adapters/generic-sql/driver-config.js";
+import { SqlAdapter } from "../adapters/generic-sql/generic-sql-adapter.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import path from "node:path";
 import { SqliteDialect } from "kysely";
 
 //#region src/util/default-database-adapter.ts
+const isCloudflareWorkers = () => {
+	if (typeof globalThis === "undefined") return false;
+	return globalThis.navigator?.userAgent === "Cloudflare-Workers";
+};
 const createNodeRequire = () => {
 	try {
 		const metaUrl = typeof import.meta !== "undefined" ? import.meta.url : void 0;
@@ -16,6 +20,7 @@ const createNodeRequire = () => {
 	}
 };
 const loadBetterSqlite3 = () => {
+	if (isCloudflareWorkers()) return null;
 	const requireFn = createNodeRequire();
 	if (!requireFn) return null;
 	try {

package/dist/util/default-database-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-database-adapter.js","names":[],"sources":["../../src/util/default-database-adapter.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { SqliteDialect } from \"kysely\";\nimport { SqlAdapter } from \"../adapters/generic-sql/generic-sql-adapter\";\nimport { BetterSQLite3DriverConfig } from \"../adapters/generic-sql/driver-config\";\nimport type { DatabaseAdapter } from \"../adapters/adapters\";\nimport type { AnySchema } from \"../schema/create\";\ntype DatabaseAdapterConfig = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter?: DatabaseAdapter<any>;\n  databaseNamespace?: string | null;\n};\n\ntype BetterSqlite3Constructor = typeof import(\"better-sqlite3\");\n\nconst createNodeRequire = (): NodeRequire | null => {\n  try {\n    const metaUrl = typeof import.meta !== \"undefined\" ? import.meta.url : undefined;\n    if (!metaUrl || typeof metaUrl !== \"string\") {\n      return null;\n    }\n    return createRequire(metaUrl);\n  } catch {\n    return null;\n  }\n};\n\nconst loadBetterSqlite3 = (): BetterSqlite3Constructor | null => {\n  const requireFn = createNodeRequire();\n  if (!requireFn) {\n    return null;\n  }\n  try {\n    const module = requireFn(\"better-sqlite3\");\n    return (module.default ?? module) as BetterSqlite3Constructor;\n  } catch {\n    return null;\n  }\n};\n\nconst betterSqlite3Constructor = loadBetterSqlite3();\n\nconst defaultDataDir = (): string => {\n  const configured = process.env[\"FRAGNO_DATA_DIR\"];\n  if (configured && configured.trim().length > 0) {\n    return configured;\n  }\n  return path.join(process.env[\"HOME\"] ?? process.cwd(), \".fragno\");\n};\n\nconst sanitizeFileSegment = (name: string): string => {\n  const sanitized = name.replace(/[^a-z0-9-]/gi, \"_\");\n  return sanitized.length > 0 ? sanitized : \"fragno\";\n};\n\nconst resolveSqliteDatabasePath = <TSchema extends AnySchema>(\n  options: DatabaseAdapterConfig,\n  schema: TSchema,\n): string => {\n  const baseName =\n    typeof options.databaseNamespace === \"string\" && options.databaseNamespace.length > 0\n      ? options.databaseNamespace\n      : schema.name;\n  const fileName = `${sanitizeFileSegment(baseName)}.sqlite`;\n  return path.join(defaultDataDir(), fileName);\n};\n\nconst createDefaultSqliteAdapter = <TSchema extends AnySchema>(\n  options: DatabaseAdapterConfig,\n  schema: TSchema,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): DatabaseAdapter<any> | null => {\n  if (!betterSqlite3Constructor) {\n    return null;\n  }\n\n  const dbPath = resolveSqliteDatabasePath(options, schema);\n  fs.mkdirSync(path.dirname(dbPath), { recursive: true });\n\n  const dialect = new SqliteDialect({\n    database: new betterSqlite3Constructor(dbPath),\n  });\n  const driverConfig = new BetterSQLite3DriverConfig();\n  return new SqlAdapter({ dialect, driverConfig });\n};\n\nexport const resolveDatabaseAdapter = <TSchema extends AnySchema>(\n  options: DatabaseAdapterConfig,\n  schema: TSchema,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): DatabaseAdapter<any> => {\n  if (options.databaseAdapter) {\n    return options.databaseAdapter;\n  }\n\n  const defaultAdapter = createDefaultSqliteAdapter(options, schema);\n  if (!defaultAdapter) {\n    throw new Error(\n      \"Database fragment requires options.databaseAdapter, or install better-sqlite3 to use the default SQLite adapter.\",\n    );\n  }\n\n  options.databaseAdapter = defaultAdapter;\n  return defaultAdapter;\n};\n"],"mappings":";;;;;;;;AAgBA,MAAM,0BAA8C;AAClD,KAAI;EACF,MAAM,UAAU,OAAO,OAAO,SAAS,cAAc,OAAO,KAAK,MAAM;AACvE,MAAI,CAAC,WAAW,OAAO,YAAY,SACjC,QAAO;AAET,SAAO,cAAc,QAAQ;SACvB;AACN,SAAO;;;AAIX,MAAM,0BAA2D;CAC/D,MAAM,YAAY,mBAAmB;AACrC,KAAI,CAAC,UACH,QAAO;AAET,KAAI;EACF,MAAM,SAAS,UAAU,iBAAiB;AAC1C,SAAQ,OAAO,WAAW;SACpB;AACN,SAAO;;;AAIX,MAAM,2BAA2B,mBAAmB;AAEpD,MAAM,uBAA+B;CACnC,MAAM,aAAa,QAAQ,IAAI;AAC/B,KAAI,cAAc,WAAW,MAAM,CAAC,SAAS,EAC3C,QAAO;AAET,QAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,QAAQ,KAAK,EAAE,UAAU;;AAGnE,MAAM,uBAAuB,SAAyB;CACpD,MAAM,YAAY,KAAK,QAAQ,gBAAgB,IAAI;AACnD,QAAO,UAAU,SAAS,IAAI,YAAY;;AAG5C,MAAM,6BACJ,SACA,WACW;CAKX,MAAM,WAAW,GAAG,oBAHlB,OAAO,QAAQ,sBAAsB,YAAY,QAAQ,kBAAkB,SAAS,IAChF,QAAQ,oBACR,OAAO,KACoC,CAAC;AAClD,QAAO,KAAK,KAAK,gBAAgB,EAAE,SAAS;;AAG9C,MAAM,8BACJ,SACA,WAEgC;AAChC,KAAI,CAAC,yBACH,QAAO;CAGT,MAAM,SAAS,0BAA0B,SAAS,OAAO;AACzD,IAAG,UAAU,KAAK,QAAQ,OAAO,EAAE,EAAE,WAAW,MAAM,CAAC;AAMvD,QAAO,IAAI,WAAW;EAAE,SAJR,IAAI,cAAc,EAChC,UAAU,IAAI,yBAAyB,OAAO,EAC/C,CAAC;EAE+B,cADZ,IAAI,2BAA2B;EACL,CAAC;;AAGlD,MAAa,0BACX,SACA,WAEyB;AACzB,KAAI,QAAQ,gBACV,QAAO,QAAQ;CAGjB,MAAM,iBAAiB,2BAA2B,SAAS,OAAO;AAClE,KAAI,CAAC,eACH,OAAM,IAAI,MACR,mHACD;AAGH,SAAQ,kBAAkB;AAC1B,QAAO"}
+{"version":3,"file":"default-database-adapter.js","names":[],"sources":["../../src/util/default-database-adapter.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nimport { SqliteDialect } from \"kysely\";\n\nimport type { DatabaseAdapter } from \"../adapters/adapters\";\nimport { BetterSQLite3DriverConfig } from \"../adapters/generic-sql/driver-config\";\nimport { SqlAdapter } from \"../adapters/generic-sql/generic-sql-adapter\";\nimport type { AnySchema } from \"../schema/create\";\ntype DatabaseAdapterConfig = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter?: DatabaseAdapter<any>;\n  databaseNamespace?: string | null;\n};\n\ntype BetterSqlite3Constructor = typeof import(\"better-sqlite3\");\n\nconst isCloudflareWorkers = (): boolean => {\n  if (typeof globalThis === \"undefined\") {\n    return false;\n  }\n  const navigatorRef = (globalThis as { navigator?: { userAgent?: string } }).navigator;\n  return navigatorRef?.userAgent === \"Cloudflare-Workers\";\n};\n\nconst createNodeRequire = (): NodeRequire | null => {\n  try {\n    const metaUrl = typeof import.meta !== \"undefined\" ? import.meta.url : undefined;\n    if (!metaUrl || typeof metaUrl !== \"string\") {\n      return null;\n    }\n    return createRequire(metaUrl);\n  } catch {\n    return null;\n  }\n};\n\nconst loadBetterSqlite3 = (): BetterSqlite3Constructor | null => {\n  if (isCloudflareWorkers()) {\n    return null;\n  }\n  const requireFn = createNodeRequire();\n  if (!requireFn) {\n    return null;\n  }\n  try {\n    const module = requireFn(\"better-sqlite3\");\n    return (module.default ?? module) as BetterSqlite3Constructor;\n  } catch {\n    return null;\n  }\n};\n\nconst betterSqlite3Constructor = loadBetterSqlite3();\n\nconst defaultDataDir = (): string => {\n  const configured = process.env[\"FRAGNO_DATA_DIR\"];\n  if (configured && configured.trim().length > 0) {\n    return configured;\n  }\n  return path.join(process.env[\"HOME\"] ?? process.cwd(), \".fragno\");\n};\n\nconst sanitizeFileSegment = (name: string): string => {\n  const sanitized = name.replace(/[^a-z0-9-]/gi, \"_\");\n  return sanitized.length > 0 ? sanitized : \"fragno\";\n};\n\nconst resolveSqliteDatabasePath = <TSchema extends AnySchema>(\n  options: DatabaseAdapterConfig,\n  schema: TSchema,\n): string => {\n  const baseName =\n    typeof options.databaseNamespace === \"string\" && options.databaseNamespace.length > 0\n      ? options.databaseNamespace\n      : schema.name;\n  const fileName = `${sanitizeFileSegment(baseName)}.sqlite`;\n  return path.join(defaultDataDir(), fileName);\n};\n\nconst createDefaultSqliteAdapter = <TSchema extends AnySchema>(\n  options: DatabaseAdapterConfig,\n  schema: TSchema,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): DatabaseAdapter<any> | null => {\n  if (!betterSqlite3Constructor) {\n    return null;\n  }\n\n  const dbPath = resolveSqliteDatabasePath(options, schema);\n  fs.mkdirSync(path.dirname(dbPath), { recursive: true });\n\n  const dialect = new SqliteDialect({\n    database: new betterSqlite3Constructor(dbPath),\n  });\n  const driverConfig = new BetterSQLite3DriverConfig();\n  return new SqlAdapter({ dialect, driverConfig });\n};\n\nexport const resolveDatabaseAdapter = <TSchema extends AnySchema>(\n  options: DatabaseAdapterConfig,\n  schema: TSchema,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): DatabaseAdapter<any> => {\n  if (options.databaseAdapter) {\n    return options.databaseAdapter;\n  }\n\n  const defaultAdapter = createDefaultSqliteAdapter(options, schema);\n  if (!defaultAdapter) {\n    throw new Error(\n      \"Database fragment requires options.databaseAdapter, or install better-sqlite3 to use the default SQLite adapter.\",\n    );\n  }\n\n  options.databaseAdapter = defaultAdapter;\n  return defaultAdapter;\n};\n"],"mappings":";;;;;;;;AAkBA,MAAM,4BAAqC;AACzC,KAAI,OAAO,eAAe,YACxB,QAAO;AAGT,QADsB,WAAsD,WACvD,cAAc;;AAGrC,MAAM,0BAA8C;AAClD,KAAI;EACF,MAAM,UAAU,OAAO,OAAO,SAAS,cAAc,OAAO,KAAK,MAAM;AACvE,MAAI,CAAC,WAAW,OAAO,YAAY,SACjC,QAAO;AAET,SAAO,cAAc,QAAQ;SACvB;AACN,SAAO;;;AAIX,MAAM,0BAA2D;AAC/D,KAAI,qBAAqB,CACvB,QAAO;CAET,MAAM,YAAY,mBAAmB;AACrC,KAAI,CAAC,UACH,QAAO;AAET,KAAI;EACF,MAAM,SAAS,UAAU,iBAAiB;AAC1C,SAAQ,OAAO,WAAW;SACpB;AACN,SAAO;;;AAIX,MAAM,2BAA2B,mBAAmB;AAEpD,MAAM,uBAA+B;CACnC,MAAM,aAAa,QAAQ,IAAI;AAC/B,KAAI,cAAc,WAAW,MAAM,CAAC,SAAS,EAC3C,QAAO;AAET,QAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,QAAQ,KAAK,EAAE,UAAU;;AAGnE,MAAM,uBAAuB,SAAyB;CACpD,MAAM,YAAY,KAAK,QAAQ,gBAAgB,IAAI;AACnD,QAAO,UAAU,SAAS,IAAI,YAAY;;AAG5C,MAAM,6BACJ,SACA,WACW;CAKX,MAAM,WAAW,GAAG,oBAHlB,OAAO,QAAQ,sBAAsB,YAAY,QAAQ,kBAAkB,SAAS,IAChF,QAAQ,oBACR,OAAO,KACoC,CAAC;AAClD,QAAO,KAAK,KAAK,gBAAgB,EAAE,SAAS;;AAG9C,MAAM,8BACJ,SACA,WAEgC;AAChC,KAAI,CAAC,yBACH,QAAO;CAGT,MAAM,SAAS,0BAA0B,SAAS,OAAO;AACzD,IAAG,UAAU,KAAK,QAAQ,OAAO,EAAE,EAAE,WAAW,MAAM,CAAC;AAMvD,QAAO,IAAI,WAAW;EAAE,SAJR,IAAI,cAAc,EAChC,UAAU,IAAI,yBAAyB,OAAO,EAC/C,CAAC;EAE+B,cADZ,IAAI,2BAA2B;EACL,CAAC;;AAGlD,MAAa,0BACX,SACA,WAEyB;AACzB,KAAI,QAAQ,gBACV,QAAO,QAAQ;CAGjB,MAAM,iBAAiB,2BAA2B,SAAS,OAAO;AAClE,KAAI,CAAC,eACH,OAAM,IAAI,MACR,mHACD;AAGH,SAAQ,kBAAkB;AAC1B,QAAO"}

package/dist/with-database.d.ts

@@ -1,14 +1,13 @@
 import { AnySchema } from "./schema/create.js";
 import { DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseServiceContext, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
-import { InternalFragmentInstance } from "./fragments/internal-fragment.js";
 import { HooksMap } from "./hooks/hooks.js";
-import { AnyFragnoInstantiatedFragment, FragmentDefinitionBuilder, FragnoPublicConfig, RequestThisContext } from "@fragno-dev/core";
+import { AnyRouteOrFactory, FragmentDefinitionBuilder, FragnoPublicConfig, RequestThisContext } from "@fragno-dev/core";
 
 //#region src/with-database.d.ts
 
 /**
  * Helper to add database support to a fragment builder.
- * Automatically links the internal fragment and adds ImplicitDatabaseDependencies to the TDeps type.
+ * Registers the schema with the adapter registry and adds ImplicitDatabaseDependencies to the TDeps type.
  *
  * @example
  * ```typescript
@@ -24,9 +23,7 @@ import { AnyFragnoInstantiatedFragment, FragmentDefinitionBuilder, FragnoPublicC
  *   .build();
  * ```
  */
-declare function withDatabase<TSchema extends AnySchema>(schema: TSchema): <TConfig, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext extends RequestThisContext, THandlerThisContext extends RequestThisContext, TRequestStorage, TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment>>(builder: FragmentDefinitionBuilder<TConfig, FragnoPublicConfig, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext, THandlerThisContext, TRequestStorage, TLinkedFragments>) => DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps & ImplicitDatabaseDependencies<TSchema>, TBaseServices, TServices, TServiceDeps, TPrivateServices, HooksMap, DatabaseServiceContext<HooksMap>, DatabaseHandlerContext, TLinkedFragments & {
-  _fragno_internal: InternalFragmentInstance;
-}>;
+declare function withDatabase<TSchema extends AnySchema>(schema: TSchema): <TConfig, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext extends RequestThisContext, THandlerThisContext extends RequestThisContext, TRequestStorage, TInternalRoutes extends readonly AnyRouteOrFactory[]>(builder: FragmentDefinitionBuilder<TConfig, FragnoPublicConfig, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext, THandlerThisContext, TRequestStorage, TInternalRoutes>) => DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps & ImplicitDatabaseDependencies<TSchema>, TBaseServices, TServices, TServiceDeps, TPrivateServices, HooksMap, DatabaseServiceContext<HooksMap>, DatabaseHandlerContext, TInternalRoutes>;
 //#endregion
 export { withDatabase };
 //# sourceMappingURL=with-database.d.ts.map