@fragno-dev/db 0.2.1 → 0.3.0

package/dist/naming/sql-naming.d.ts

@@ -0,0 +1,19 @@
+//#region src/naming/sql-naming.d.ts
+type NamespaceScope = "suffix" | "schema";
+interface SqlNamingStrategy {
+  namespaceScope: NamespaceScope;
+  namespaceToSchema: (namespace: string) => string;
+  tableName: (logicalTable: string, namespace: string | null) => string;
+  columnName: (logicalColumn: string, logicalTable: string) => string;
+  indexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;
+  uniqueIndexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;
+  foreignKeyName: (params: {
+    logicalTable: string;
+    logicalReferencedTable: string;
+    referenceName: string;
+    namespace: string | null;
+  }) => string;
+}
+//#endregion
+export { SqlNamingStrategy };
+//# sourceMappingURL=sql-naming.d.ts.map

package/dist/naming/sql-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-naming.d.ts","names":[],"sources":["../../src/naming/sql-naming.ts"],"sourcesContent":[],"mappings":";AAGY,KAAA,cAAA,GAAc,QAAA,GAAA,QAAA;AAET,UAAA,iBAAA,CAAiB;kBAChB"}

package/dist/naming/sql-naming.js

@@ -0,0 +1,116 @@
+import { createHash } from "node:crypto";
+
+//#region src/naming/sql-naming.ts
+const normalizeNamespace = (namespace) => namespace && namespace.length > 0 ? namespace : null;
+const buildNamespaceSuffix = (namespace) => {
+	const sanitized = normalizeNamespace(namespace);
+	return sanitized ? `_${sanitized}` : "";
+};
+const MAX_IDENTIFIER_LENGTH = 63;
+const HASH_LENGTH = 8;
+const withHash = (value) => {
+	return `${value}_${createHash("sha1").update(value).digest("hex").slice(0, 8)}`;
+};
+const truncateWithHash = (value) => {
+	if (value.length <= MAX_IDENTIFIER_LENGTH) return value;
+	const hash = createHash("sha1").update(value).digest("hex").slice(0, HASH_LENGTH);
+	return `${value.slice(0, MAX_IDENTIFIER_LENGTH - HASH_LENGTH)}${hash}`;
+};
+const buildIndexName = (prefix, logicalIndex, logicalTable, namespace) => {
+	return `${prefix}_${withHash(`${logicalTable}_${logicalIndex}${buildNamespaceSuffix(namespace)}`)}`;
+};
+const suffixNamingStrategy = {
+	namespaceScope: "suffix",
+	namespaceToSchema: (namespace) => namespace,
+	tableName: (logicalTable, namespace) => {
+		const sanitized = normalizeNamespace(namespace);
+		return truncateWithHash(sanitized ? `${logicalTable}_${sanitized}` : logicalTable);
+	},
+	columnName: (logicalColumn) => logicalColumn,
+	indexName: (logicalIndex, logicalTable, namespace) => truncateWithHash(buildIndexName("idx", logicalIndex, logicalTable, namespace)),
+	uniqueIndexName: (logicalIndex, logicalTable, namespace) => truncateWithHash(buildIndexName("uidx", logicalIndex, logicalTable, namespace)),
+	foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName, namespace }) => {
+		return truncateWithHash(`fk_${withHash(`${logicalTable}_${logicalReferencedTable}_${referenceName}${buildNamespaceSuffix(namespace)}`)}`);
+	}
+};
+const schemaNamingStrategy = {
+	namespaceScope: "schema",
+	namespaceToSchema: (namespace) => namespace,
+	tableName: (logicalTable) => truncateWithHash(logicalTable),
+	columnName: (logicalColumn) => logicalColumn,
+	indexName: (logicalIndex) => truncateWithHash(logicalIndex),
+	uniqueIndexName: (logicalIndex) => truncateWithHash(logicalIndex),
+	foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName }) => truncateWithHash(`fk_${logicalTable}_${logicalReferencedTable}_${referenceName}`)
+};
+var NamingResolver = class {
+	#namespace;
+	#strategy;
+	#tableNameMap = {};
+	#columnNameMaps = /* @__PURE__ */ new Map();
+	constructor(schema, namespace, strategy) {
+		this.#namespace = namespace;
+		this.#strategy = strategy;
+		for (const table of Object.values(schema.tables)) {
+			const physicalTable = this.getTableName(table.name);
+			this.#tableNameMap[physicalTable] = table.name;
+			const columnMap = {};
+			for (const column of Object.values(table.columns)) {
+				const physicalColumn = this.getColumnName(table.name, column.name);
+				columnMap[physicalColumn] = column.name;
+			}
+			this.#columnNameMaps.set(table.name, columnMap);
+		}
+	}
+	get namespace() {
+		return this.#namespace;
+	}
+	get strategy() {
+		return this.#strategy;
+	}
+	getSchemaName() {
+		if (this.#strategy.namespaceScope !== "schema") return null;
+		if (!this.#namespace || this.#namespace.length === 0) return null;
+		return this.#strategy.namespaceToSchema(this.#namespace);
+	}
+	getTableName(logicalTable) {
+		return this.#strategy.tableName(logicalTable, this.#namespace);
+	}
+	getColumnName(logicalTable, logicalColumn) {
+		return this.#strategy.columnName(logicalColumn, logicalTable);
+	}
+	getIndexName(logicalIndex, logicalTable) {
+		return this.#strategy.indexName(logicalIndex, logicalTable, this.#namespace);
+	}
+	getUniqueIndexName(logicalIndex, logicalTable) {
+		return this.#strategy.uniqueIndexName(logicalIndex, logicalTable, this.#namespace);
+	}
+	getForeignKeyName(params) {
+		return this.#strategy.foreignKeyName({
+			...params,
+			namespace: this.#namespace
+		});
+	}
+	getTableNameMap() {
+		return { ...this.#tableNameMap };
+	}
+	getColumnNameMap(table) {
+		const tableName = typeof table === "string" ? table : table.name;
+		const map = this.#columnNameMaps.get(tableName);
+		return map ? { ...map } : {};
+	}
+};
+const createNamingResolver = (schema, namespace, strategy) => new NamingResolver(schema, namespace, strategy);
+/**
+* Sanitizes a namespace for use in SQL identifiers and TypeScript exports.
+* Converts dashes to underscores to ensure compatibility with SQL identifiers.
+*
+* @example
+* sanitizeNamespace("my-fragment") // => "my_fragment"
+*/
+function sanitizeNamespace(namespace) {
+	return namespace.replace(/-/g, "_");
+}
+
+//#endregion
+export { createNamingResolver, sanitizeNamespace, schemaNamingStrategy, suffixNamingStrategy };
+//# sourceMappingURL=sql-naming.js.map

package/dist/naming/sql-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-naming.js","names":["suffixNamingStrategy: SqlNamingStrategy","schemaNamingStrategy: SqlNamingStrategy","#namespace","#strategy","#tableNameMap","#columnNameMaps","columnMap: Record<string, string>"],"sources":["../../src/naming/sql-naming.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { AnySchema, AnyTable } from \"../schema/create\";\n\nexport type NamespaceScope = \"suffix\" | \"schema\";\n\nexport interface SqlNamingStrategy {\n  namespaceScope: NamespaceScope;\n  namespaceToSchema: (namespace: string) => string;\n\n  tableName: (logicalTable: string, namespace: string | null) => string;\n  columnName: (logicalColumn: string, logicalTable: string) => string;\n\n  indexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;\n  uniqueIndexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;\n  foreignKeyName: (params: {\n    logicalTable: string;\n    logicalReferencedTable: string;\n    referenceName: string;\n    namespace: string | null;\n  }) => string;\n}\n\nconst normalizeNamespace = (namespace: string | null) =>\n  namespace && namespace.length > 0 ? namespace : null;\n\nconst buildNamespaceSuffix = (namespace: string | null) => {\n  const sanitized = normalizeNamespace(namespace);\n  return sanitized ? `_${sanitized}` : \"\";\n};\n\nconst MAX_IDENTIFIER_LENGTH = 63;\nconst HASH_LENGTH = 8;\n\nconst withHash = (value: string) => {\n  const hash = createHash(\"sha1\").update(value).digest(\"hex\").slice(0, 8);\n  return `${value}_${hash}`;\n};\n\nconst truncateWithHash = (value: string) => {\n  if (value.length <= MAX_IDENTIFIER_LENGTH) {\n    return value;\n  }\n  const hash = createHash(\"sha1\").update(value).digest(\"hex\").slice(0, HASH_LENGTH);\n  return `${value.slice(0, MAX_IDENTIFIER_LENGTH - HASH_LENGTH)}${hash}`;\n};\n\nconst buildIndexName = (\n  prefix: \"idx\" | \"uidx\",\n  logicalIndex: string,\n  logicalTable: string,\n  namespace: string | null,\n) => {\n  const base = `${logicalTable}_${logicalIndex}${buildNamespaceSuffix(namespace)}`;\n  return `${prefix}_${withHash(base)}`;\n};\n\nexport const suffixNamingStrategy: SqlNamingStrategy = {\n  namespaceScope: \"suffix\",\n  namespaceToSchema: (namespace) => namespace,\n  tableName: (logicalTable, namespace) => {\n    const sanitized = normalizeNamespace(namespace);\n    return truncateWithHash(sanitized ? `${logicalTable}_${sanitized}` : logicalTable);\n  },\n  columnName: (logicalColumn) => logicalColumn,\n  indexName: (logicalIndex, logicalTable, namespace) =>\n    truncateWithHash(buildIndexName(\"idx\", logicalIndex, logicalTable, namespace)),\n  uniqueIndexName: (logicalIndex, logicalTable, namespace) =>\n    truncateWithHash(buildIndexName(\"uidx\", logicalIndex, logicalTable, namespace)),\n  foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName, namespace }) => {\n    const base = `${logicalTable}_${logicalReferencedTable}_${referenceName}${buildNamespaceSuffix(namespace)}`;\n    return truncateWithHash(`fk_${withHash(base)}`);\n  },\n};\n\nexport const schemaNamingStrategy: SqlNamingStrategy = {\n  namespaceScope: \"schema\",\n  namespaceToSchema: (namespace) => namespace,\n  tableName: (logicalTable) => truncateWithHash(logicalTable),\n  columnName: (logicalColumn) => logicalColumn,\n  indexName: (logicalIndex) => truncateWithHash(logicalIndex),\n  uniqueIndexName: (logicalIndex) => truncateWithHash(logicalIndex),\n  foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName }) =>\n    truncateWithHash(`fk_${logicalTable}_${logicalReferencedTable}_${referenceName}`),\n};\n\nexport class NamingResolver {\n  readonly #namespace: string | null;\n  readonly #strategy: SqlNamingStrategy;\n  readonly #tableNameMap: Record<string, string> = {};\n  readonly #columnNameMaps = new Map<string, Record<string, string>>();\n\n  constructor(schema: AnySchema, namespace: string | null, strategy: SqlNamingStrategy) {\n    this.#namespace = namespace;\n    this.#strategy = strategy;\n\n    for (const table of Object.values(schema.tables)) {\n      const physicalTable = this.getTableName(table.name);\n      this.#tableNameMap[physicalTable] = table.name;\n\n      const columnMap: Record<string, string> = {};\n      for (const column of Object.values(table.columns)) {\n        const physicalColumn = this.getColumnName(table.name, column.name);\n        columnMap[physicalColumn] = column.name;\n      }\n      this.#columnNameMaps.set(table.name, columnMap);\n    }\n  }\n\n  get namespace(): string | null {\n    return this.#namespace;\n  }\n\n  get strategy(): SqlNamingStrategy {\n    return this.#strategy;\n  }\n\n  getSchemaName(): string | null {\n    if (this.#strategy.namespaceScope !== \"schema\") {\n      return null;\n    }\n    if (!this.#namespace || this.#namespace.length === 0) {\n      return null;\n    }\n    return this.#strategy.namespaceToSchema(this.#namespace);\n  }\n\n  getTableName(logicalTable: string): string {\n    return this.#strategy.tableName(logicalTable, this.#namespace);\n  }\n\n  getColumnName(logicalTable: string, logicalColumn: string): string {\n    return this.#strategy.columnName(logicalColumn, logicalTable);\n  }\n\n  getIndexName(logicalIndex: string, logicalTable: string): string {\n    return this.#strategy.indexName(logicalIndex, logicalTable, this.#namespace);\n  }\n\n  getUniqueIndexName(logicalIndex: string, logicalTable: string): string {\n    return this.#strategy.uniqueIndexName(logicalIndex, logicalTable, this.#namespace);\n  }\n\n  getForeignKeyName(params: {\n    logicalTable: string;\n    logicalReferencedTable: string;\n    referenceName: string;\n  }): string {\n    return this.#strategy.foreignKeyName({\n      ...params,\n      namespace: this.#namespace,\n    });\n  }\n\n  getTableNameMap(): Record<string, string> {\n    return { ...this.#tableNameMap };\n  }\n\n  getColumnNameMap(table: AnyTable | string): Record<string, string> {\n    const tableName = typeof table === \"string\" ? table : table.name;\n    const map = this.#columnNameMaps.get(tableName);\n    return map ? { ...map } : {};\n  }\n}\n\nexport const createNamingResolver = (\n  schema: AnySchema,\n  namespace: string | null,\n  strategy: SqlNamingStrategy,\n): NamingResolver => new NamingResolver(schema, namespace, strategy);\n\n/**\n * Sanitizes a namespace for use in SQL identifiers and TypeScript exports.\n * Converts dashes to underscores to ensure compatibility with SQL identifiers.\n *\n * @example\n * sanitizeNamespace(\"my-fragment\") // => \"my_fragment\"\n */\nexport function sanitizeNamespace(namespace: string): string {\n  return namespace.replace(/-/g, \"_\");\n}\n"],"mappings":"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"}

package/dist/node_modules/.pnpm/{rou3@0.7.10 → rou3@0.7.12}/node_modules/rou3/dist/index.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.mjs
+//#region ../../node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.mjs
 const NullProtoObj = /* @__PURE__ */ (() => {
 	const e = function() {};
 	return e.prototype = Object.create(null), Object.freeze(e.prototype), e;
@@ -19,7 +19,7 @@ function splitPath(path) {
 function getMatchParams(segments, paramsMap) {
 	const params = new NullProtoObj();
 	for (const [index, name] of paramsMap) {
-		const segment = index < 0 ? segments.slice(-1 * index).join("/") : segments[index];
+		const segment = index < 0 ? segments.slice(-(index + 1)).join("/") : segments[index];
 		if (typeof name === "string") params[name] = segment;
 		else {
 			const match = segment.match(name);
@@ -34,18 +34,19 @@ function getMatchParams(segments, paramsMap) {
 function addRoute(ctx, method = "", path, data) {
 	method = method.toUpperCase();
 	if (path.charCodeAt(0) !== 47) path = `/${path}`;
+	path = path.replace(/\\:/g, "%3A");
 	const segments = splitPath(path);
 	let node = ctx.root;
 	let _unnamedParamIndex = 0;
 	const paramsMap = [];
 	const paramsRegexp = [];
 	for (let i = 0; i < segments.length; i++) {
-		const segment = segments[i];
+		let segment = segments[i];
 		if (segment.startsWith("**")) {
 			if (!node.wildcard) node.wildcard = { key: "**" };
 			node = node.wildcard;
 			paramsMap.push([
-				-i,
+				-(i + 1),
 				segment.split(":")[1] || "_",
 				segment.length === 2
 			]);
@@ -75,6 +76,8 @@ function addRoute(ctx, method = "", path, data) {
 			]);
 			continue;
 		}
+		if (segment === "\\*") segment = segments[i] = "*";
+		else if (segment === "\\*\\*") segment = segments[i] = "**";
 		const child = node.static?.[segment];
 		if (child) node = child;
 		else {
@@ -92,7 +95,7 @@ function addRoute(ctx, method = "", path, data) {
 		paramsRegexp,
 		paramsMap: hasParams ? paramsMap : void 0
 	});
-	if (!hasParams) ctx.static[path] = node;
+	if (!hasParams) ctx.static["/" + segments.join("/")] = node;
 }
 function getParamRegexp(segment) {
 	const regex = segment.replace(/:(\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\./g, "\\.");

package/dist/node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.mjs"],"sourcesContent":["const NullProtoObj = /* @__PURE__ */ (() => {\n\tconst e = function() {};\n\treturn e.prototype = Object.create(null), Object.freeze(e.prototype), e;\n})();\n\n/**\n* Create a new router context.\n*/\nfunction createRouter() {\n\treturn {\n\t\troot: { key: \"\" },\n\t\tstatic: new NullProtoObj()\n\t};\n}\n\nfunction splitPath(path) {\n\tconst [_, ...s] = path.split(\"/\");\n\treturn s[s.length - 1] === \"\" ? s.slice(0, -1) : s;\n}\nfunction getMatchParams(segments, paramsMap) {\n\tconst params = new NullProtoObj();\n\tfor (const [index, name] of paramsMap) {\n\t\tconst segment = index < 0 ? segments.slice(-(index + 1)).join(\"/\") : segments[index];\n\t\tif (typeof name === \"string\") params[name] = segment;\n\t\telse {\n\t\t\tconst match = segment.match(name);\n\t\t\tif (match) for (const key in match.groups) params[key] = match.groups[key];\n\t\t}\n\t}\n\treturn params;\n}\n\n/**\n* Add a route to the router context.\n*/\nfunction addRoute(ctx, method = \"\", path, data) {\n\tmethod = method.toUpperCase();\n\tif (path.charCodeAt(0) !== 47) path = `/${path}`;\n\tpath = path.replace(/\\\\:/g, \"%3A\");\n\tconst segments = splitPath(path);\n\tlet node = ctx.root;\n\tlet _unnamedParamIndex = 0;\n\tconst paramsMap = [];\n\tconst paramsRegexp = [];\n\tfor (let i = 0; i < segments.length; i++) {\n\t\tlet segment = segments[i];\n\t\tif (segment.startsWith(\"**\")) {\n\t\t\tif (!node.wildcard) node.wildcard = { key: \"**\" };\n\t\t\tnode = node.wildcard;\n\t\t\tparamsMap.push([\n\t\t\t\t-(i + 1),\n\t\t\t\tsegment.split(\":\")[1] || \"_\",\n\t\t\t\tsegment.length === 2\n\t\t\t]);\n\t\t\tbreak;\n\t\t}\n\t\tif (segment === \"*\" || segment.includes(\":\")) {\n\t\t\tif (!node.param) node.param = { key: \"*\" };\n\t\t\tnode = node.param;\n\t\t\tif (segment === \"*\") paramsMap.push([\n\t\t\t\ti,\n\t\t\t\t`_${_unnamedParamIndex++}`,\n\t\t\t\ttrue\n\t\t\t]);\n\t\t\telse if (segment.includes(\":\", 1)) {\n\t\t\t\tconst regexp = getParamRegexp(segment);\n\t\t\t\tparamsRegexp[i] = regexp;\n\t\t\t\tnode.hasRegexParam = true;\n\t\t\t\tparamsMap.push([\n\t\t\t\t\ti,\n\t\t\t\t\tregexp,\n\t\t\t\t\tfalse\n\t\t\t\t]);\n\t\t\t} else paramsMap.push([\n\t\t\t\ti,\n\t\t\t\tsegment.slice(1),\n\t\t\t\tfalse\n\t\t\t]);\n\t\t\tcontinue;\n\t\t}\n\t\tif (segment === \"\\\\*\") segment = segments[i] = \"*\";\n\t\telse if (segment === \"\\\\*\\\\*\") segment = segments[i] = \"**\";\n\t\tconst child = node.static?.[segment];\n\t\tif (child) node = child;\n\t\telse {\n\t\t\tconst staticNode = { key: segment };\n\t\t\tif (!node.static) node.static = new NullProtoObj();\n\t\t\tnode.static[segment] = staticNode;\n\t\t\tnode = staticNode;\n\t\t}\n\t}\n\tconst hasParams = paramsMap.length > 0;\n\tif (!node.methods) node.methods = new NullProtoObj();\n\tnode.methods[method] ??= [];\n\tnode.methods[method].push({\n\t\tdata: data || null,\n\t\tparamsRegexp,\n\t\tparamsMap: hasParams ? paramsMap : void 0\n\t});\n\tif (!hasParams) ctx.static[\"/\" + segments.join(\"/\")] = node;\n}\nfunction getParamRegexp(segment) {\n\tconst regex = segment.replace(/:(\\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\\./g, \"\\\\.\");\n\treturn /* @__PURE__ */ new RegExp(`^${regex}$`);\n}\n\n/**\n* Find a route by path.\n*/\nfunction findRoute(ctx, method = \"\", path, opts) {\n\tif (path.charCodeAt(path.length - 1) === 47) path = path.slice(0, -1);\n\tconst staticNode = ctx.static[path];\n\tif (staticNode && staticNode.methods) {\n\t\tconst staticMatch = staticNode.methods[method] || staticNode.methods[\"\"];\n\t\tif (staticMatch !== void 0) return staticMatch[0];\n\t}\n\tconst segments = splitPath(path);\n\tconst match = _lookupTree(ctx, ctx.root, method, segments, 0)?.[0];\n\tif (match === void 0) return;\n\tif (opts?.params === false) return match;\n\treturn {\n\t\tdata: match.data,\n\t\tparams: match.paramsMap ? getMatchParams(segments, match.paramsMap) : void 0\n\t};\n}\nfunction _lookupTree(ctx, node, method, segments, index) {\n\tif (index === segments.length) {\n\t\tif (node.methods) {\n\t\t\tconst match = node.methods[method] || node.methods[\"\"];\n\t\t\tif (match) return match;\n\t\t}\n\t\tif (node.param && node.param.methods) {\n\t\t\tconst match = node.param.methods[method] || node.param.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) return match;\n\t\t\t}\n\t\t}\n\t\tif (node.wildcard && node.wildcard.methods) {\n\t\t\tconst match = node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) return match;\n\t\t\t}\n\t\t}\n\t\treturn;\n\t}\n\tconst segment = segments[index];\n\tif (node.static) {\n\t\tconst staticChild = node.static[segment];\n\t\tif (staticChild) {\n\t\t\tconst match = _lookupTree(ctx, staticChild, method, segments, index + 1);\n\t\t\tif (match) return match;\n\t\t}\n\t}\n\tif (node.param) {\n\t\tconst match = _lookupTree(ctx, node.param, method, segments, index + 1);\n\t\tif (match) {\n\t\t\tif (node.param.hasRegexParam) {\n\t\t\t\tconst exactMatch = match.find((m) => m.paramsRegexp[index]?.test(segment)) || match.find((m) => !m.paramsRegexp[index]);\n\t\t\t\treturn exactMatch ? [exactMatch] : void 0;\n\t\t\t}\n\t\t\treturn match;\n\t\t}\n\t}\n\tif (node.wildcard && node.wildcard.methods) return node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n}\n\n/**\n* Remove a route from the router context.\n*/\nfunction removeRoute(ctx, method, path) {\n\tconst segments = splitPath(path);\n\treturn _remove(ctx.root, method || \"\", segments, 0);\n}\nfunction _remove(node, method, segments, index) {\n\tif (index === segments.length) {\n\t\tif (node.methods && method in node.methods) {\n\t\t\tdelete node.methods[method];\n\t\t\tif (Object.keys(node.methods).length === 0) node.methods = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tconst segment = segments[index];\n\tif (segment === \"*\") {\n\t\tif (node.param) {\n\t\t\t_remove(node.param, method, segments, index + 1);\n\t\t\tif (_isEmptyNode(node.param)) node.param = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tif (segment.startsWith(\"**\")) {\n\t\tif (node.wildcard) {\n\t\t\t_remove(node.wildcard, method, segments, index + 1);\n\t\t\tif (_isEmptyNode(node.wildcard)) node.wildcard = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tconst childNode = node.static?.[segment];\n\tif (childNode) {\n\t\t_remove(childNode, method, segments, index + 1);\n\t\tif (_isEmptyNode(childNode)) {\n\t\t\tdelete node.static[segment];\n\t\t\tif (Object.keys(node.static).length === 0) node.static = void 0;\n\t\t}\n\t}\n}\nfunction _isEmptyNode(node) {\n\treturn node.methods === void 0 && node.static === void 0 && node.param === void 0 && node.wildcard === void 0;\n}\n\n/**\n* Find all route patterns that match the given path.\n*/\nfunction findAllRoutes(ctx, method = \"\", path, opts) {\n\tif (path.charCodeAt(path.length - 1) === 47) path = path.slice(0, -1);\n\tconst segments = splitPath(path);\n\tconst matches = _findAll(ctx, ctx.root, method, segments, 0);\n\tif (opts?.params === false) return matches;\n\treturn matches.map((m) => {\n\t\treturn {\n\t\t\tdata: m.data,\n\t\t\tparams: m.paramsMap ? getMatchParams(segments, m.paramsMap) : void 0\n\t\t};\n\t});\n}\nfunction _findAll(ctx, node, method, segments, index, matches = []) {\n\tconst segment = segments[index];\n\tif (node.wildcard && node.wildcard.methods) {\n\t\tconst match = node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n\t\tif (match) matches.push(...match);\n\t}\n\tif (node.param) {\n\t\t_findAll(ctx, node.param, method, segments, index + 1, matches);\n\t\tif (index === segments.length && node.param.methods) {\n\t\t\tconst match = node.param.methods[method] || node.param.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) matches.push(...match);\n\t\t\t}\n\t\t}\n\t}\n\tconst staticChild = node.static?.[segment];\n\tif (staticChild) _findAll(ctx, staticChild, method, segments, index + 1, matches);\n\tif (index === segments.length && node.methods) {\n\t\tconst match = node.methods[method] || node.methods[\"\"];\n\t\tif (match) matches.push(...match);\n\t}\n\treturn matches;\n}\n\nfunction routeToRegExp(route = \"/\") {\n\tconst reSegments = [];\n\tlet idCtr = 0;\n\tfor (const segment of route.split(\"/\")) {\n\t\tif (!segment) continue;\n\t\tif (segment === \"*\") reSegments.push(`(?<_${idCtr++}>[^/]*)`);\n\t\telse if (segment.startsWith(\"**\")) reSegments.push(segment === \"**\" ? \"?(?<_>.*)\" : `?(?<${segment.slice(3)}>.+)`);\n\t\telse if (segment.includes(\":\")) reSegments.push(segment.replace(/:(\\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\\./g, \"\\\\.\"));\n\t\telse reSegments.push(segment);\n\t}\n\treturn /* @__PURE__ */ new RegExp(`^/${reSegments.join(\"/\")}/?$`);\n}\n\nexport { NullProtoObj, addRoute, createRouter, findAllRoutes, findRoute, removeRoute, routeToRegExp };"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/outbox/outbox-builder.js

@@ -0,0 +1,156 @@
+import { FragnoId, FragnoReference } from "../schema/create.js";
+import { internalSchema } from "../fragments/internal-fragment.schema.js";
+import { encodeVersionstamp, versionstampToHex } from "./outbox.js";
+
+//#region src/outbox/outbox-builder.ts
+const INTERNAL_TABLE_NAMES = new Set(Object.keys(internalSchema.tables));
+function buildOutboxPlan(operations) {
+	const drafts = [];
+	const lookups = [];
+	for (const op of operations) {
+		if (op.type === "check") continue;
+		if (isInternalMutation(op)) continue;
+		const table = getTable(op.schema, op.table);
+		const schemaName = op.namespace ?? "";
+		const namespace = op.namespace ? op.namespace : void 0;
+		const mutationIndex = drafts.length;
+		if (op.type === "create") {
+			drafts.push({
+				op: "create",
+				schema: schemaName,
+				namespace,
+				table: op.table,
+				externalId: op.generatedExternalId,
+				values: encodeOutboxValues({
+					table,
+					values: op.values,
+					mutationIndex,
+					namespace,
+					lookups
+				})
+			});
+			continue;
+		}
+		if (op.type === "update") {
+			drafts.push({
+				op: "update",
+				schema: schemaName,
+				namespace,
+				table: op.table,
+				externalId: getExternalId(op.id),
+				set: encodeOutboxValues({
+					table,
+					values: op.set,
+					mutationIndex,
+					namespace,
+					lookups
+				}),
+				checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : void 0
+			});
+			continue;
+		}
+		if (op.type === "delete") drafts.push({
+			op: "delete",
+			schema: schemaName,
+			namespace,
+			table: op.table,
+			externalId: getExternalId(op.id),
+			checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : void 0
+		});
+	}
+	return {
+		drafts,
+		lookups
+	};
+}
+function finalizeOutboxPayload(plan, transactionVersion) {
+	return {
+		version: 1,
+		mutations: plan.drafts.map((draft, index) => {
+			const versionstamp = versionstampToHex(encodeVersionstamp(transactionVersion, index));
+			return {
+				...draft,
+				versionstamp
+			};
+		})
+	};
+}
+function encodeOutboxValues(options) {
+	const { table, values, mutationIndex, namespace, lookups } = options;
+	const output = {};
+	for (const [key, value] of Object.entries(values)) {
+		if (value === void 0) continue;
+		if (table.columns[key]?.role === "reference") {
+			output[key] = resolveReferenceValue({
+				value,
+				mutationIndex,
+				columnName: key,
+				table,
+				namespace,
+				lookups
+			});
+			continue;
+		}
+		if (value instanceof FragnoId) {
+			output[key] = value.externalId;
+			continue;
+		}
+		output[key] = value;
+	}
+	return output;
+}
+function resolveReferenceValue(options) {
+	const { value, mutationIndex, columnName, table, namespace, lookups } = options;
+	if (value === null) return null;
+	if (value instanceof FragnoId) return value.externalId;
+	if (typeof value === "string") return value;
+	if (value instanceof FragnoReference) return createReferencePlaceholder({
+		internalId: value.internalId,
+		mutationIndex,
+		columnName,
+		table,
+		namespace,
+		lookups
+	});
+	if (typeof value === "bigint" || typeof value === "number") return createReferencePlaceholder({
+		internalId: value,
+		mutationIndex,
+		columnName,
+		table,
+		namespace,
+		lookups
+	});
+	return value;
+}
+function createReferencePlaceholder(options) {
+	const { internalId, mutationIndex, columnName, table, namespace, lookups } = options;
+	const key = `${mutationIndex}.${columnName}`;
+	const referencedTable = resolveReferencedTable(table, columnName);
+	lookups.push({
+		key,
+		internalId,
+		table: referencedTable,
+		namespace
+	});
+	return { __fragno_ref: key };
+}
+function resolveReferencedTable(table, columnName) {
+	for (const relation of Object.values(table.relations)) if (relation.on.some(([localColumn]) => localColumn === columnName)) return relation.table;
+	throw new Error(`Reference column ${columnName} not found in table ${table.name}`);
+}
+function getExternalId(id) {
+	return typeof id === "string" ? id : id.externalId;
+}
+function isInternalMutation(op) {
+	if (op.schema === internalSchema) return true;
+	return op.namespace === "" && INTERNAL_TABLE_NAMES.has(op.table);
+}
+function getTable(schema, tableName) {
+	const table = schema.tables[tableName];
+	if (!table) throw new Error(`Invalid table name ${tableName}.`);
+	return table;
+}
+
+//#endregion
+export { buildOutboxPlan, finalizeOutboxPayload };
+//# sourceMappingURL=outbox-builder.js.map

package/dist/outbox/outbox-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-builder.js","names":["drafts: OutboxMutationDraft[]","lookups: OutboxRefLookup[]","output: Record<string, unknown>"],"sources":["../../src/outbox/outbox-builder.ts"],"sourcesContent":["import type { MutationOperation } from \"../query/unit-of-work/unit-of-work\";\nimport type { AnySchema, AnyTable } from \"../schema/create\";\nimport { FragnoId, FragnoReference } from \"../schema/create\";\nimport { internalSchema } from \"../fragments/internal-fragment.schema\";\nimport type { OutboxRefLookup, OutboxPayload, OutboxMutation } from \"./outbox\";\nimport { encodeVersionstamp, versionstampToHex } from \"./outbox\";\n\nconst INTERNAL_TABLE_NAMES = new Set(Object.keys(internalSchema.tables));\n\ntype OutboxMutationDraft = OutboxMutation extends infer T\n  ? T extends OutboxMutation\n    ? Omit<T, \"versionstamp\"> & { versionstamp?: string }\n    : never\n  : never;\n\nexport type OutboxPlan = {\n  drafts: OutboxMutationDraft[];\n  lookups: OutboxRefLookup[];\n};\n\nexport function buildOutboxPlan(operations: MutationOperation<AnySchema>[]): OutboxPlan {\n  const drafts: OutboxMutationDraft[] = [];\n  const lookups: OutboxRefLookup[] = [];\n\n  for (const op of operations) {\n    if (op.type === \"check\") {\n      continue;\n    }\n\n    if (isInternalMutation(op)) {\n      continue;\n    }\n\n    const table = getTable(op.schema, op.table);\n    const schemaName = op.namespace ?? \"\";\n    const namespace = op.namespace ? op.namespace : undefined;\n    const mutationIndex = drafts.length;\n\n    if (op.type === \"create\") {\n      drafts.push({\n        op: \"create\",\n        schema: schemaName,\n        namespace,\n        table: op.table,\n        externalId: op.generatedExternalId,\n        values: encodeOutboxValues({\n          table,\n          values: op.values,\n          mutationIndex,\n          namespace,\n          lookups,\n        }),\n      });\n      continue;\n    }\n\n    if (op.type === \"update\") {\n      drafts.push({\n        op: \"update\",\n        schema: schemaName,\n        namespace,\n        table: op.table,\n        externalId: getExternalId(op.id),\n        set: encodeOutboxValues({\n          table,\n          values: op.set,\n          mutationIndex,\n          namespace,\n          lookups,\n        }),\n        checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : undefined,\n      });\n      continue;\n    }\n\n    if (op.type === \"delete\") {\n      drafts.push({\n        op: \"delete\",\n        schema: schemaName,\n        namespace,\n        table: op.table,\n        externalId: getExternalId(op.id),\n        checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : undefined,\n      });\n    }\n  }\n\n  return { drafts, lookups };\n}\n\nexport function finalizeOutboxPayload(plan: OutboxPlan, transactionVersion: bigint): OutboxPayload {\n  const mutations: OutboxMutation[] = plan.drafts.map((draft, index) => {\n    const versionstamp = versionstampToHex(encodeVersionstamp(transactionVersion, index));\n    return { ...draft, versionstamp } as OutboxMutation;\n  });\n\n  return {\n    version: 1,\n    mutations,\n  };\n}\n\nfunction encodeOutboxValues(options: {\n  table: AnyTable;\n  values: Record<string, unknown>;\n  mutationIndex: number;\n  namespace?: string;\n  lookups: OutboxRefLookup[];\n}): Record<string, unknown> {\n  const { table, values, mutationIndex, namespace, lookups } = options;\n  const output: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(values)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    const column = table.columns[key];\n\n    if (column?.role === \"reference\") {\n      const resolved = resolveReferenceValue({\n        value,\n        mutationIndex,\n        columnName: key,\n        table,\n        namespace,\n        lookups,\n      });\n      output[key] = resolved;\n      continue;\n    }\n\n    if (value instanceof FragnoId) {\n      output[key] = value.externalId;\n      continue;\n    }\n\n    output[key] = value;\n  }\n\n  return output;\n}\n\nfunction resolveReferenceValue(options: {\n  value: unknown;\n  mutationIndex: number;\n  columnName: string;\n  table: AnyTable;\n  namespace?: string;\n  lookups: OutboxRefLookup[];\n}): unknown {\n  const { value, mutationIndex, columnName, table, namespace, lookups } = options;\n\n  if (value === null) {\n    return null;\n  }\n\n  if (value instanceof FragnoId) {\n    return value.externalId;\n  }\n\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value instanceof FragnoReference) {\n    return createReferencePlaceholder({\n      internalId: value.internalId,\n      mutationIndex,\n      columnName,\n      table,\n      namespace,\n      lookups,\n    });\n  }\n\n  if (typeof value === \"bigint\" || typeof value === \"number\") {\n    return createReferencePlaceholder({\n      internalId: value,\n      mutationIndex,\n      columnName,\n      table,\n      namespace,\n      lookups,\n    });\n  }\n\n  return value;\n}\n\nfunction createReferencePlaceholder(options: {\n  internalId: bigint | number;\n  mutationIndex: number;\n  columnName: string;\n  table: AnyTable;\n  namespace?: string;\n  lookups: OutboxRefLookup[];\n}): { __fragno_ref: string } {\n  const { internalId, mutationIndex, columnName, table, namespace, lookups } = options;\n  const key = `${mutationIndex}.${columnName}`;\n  const referencedTable = resolveReferencedTable(table, columnName);\n\n  lookups.push({\n    key,\n    internalId,\n    table: referencedTable,\n    namespace,\n  });\n\n  return { __fragno_ref: key };\n}\n\nfunction resolveReferencedTable(table: AnyTable, columnName: string): AnyTable {\n  for (const relation of Object.values(table.relations)) {\n    if (relation.on.some(([localColumn]) => localColumn === columnName)) {\n      return relation.table;\n    }\n  }\n\n  throw new Error(`Reference column ${columnName} not found in table ${table.name}`);\n}\n\nfunction getExternalId(id: FragnoId | string): string {\n  return typeof id === \"string\" ? id : id.externalId;\n}\n\nfunction isInternalMutation(op: MutationOperation<AnySchema>): boolean {\n  if (op.schema === internalSchema) {\n    return true;\n  }\n\n  return op.namespace === \"\" && INTERNAL_TABLE_NAMES.has(op.table);\n}\n\nfunction getTable(schema: AnySchema, tableName: string): AnyTable {\n  const table = schema.tables[tableName];\n  if (!table) {\n    throw new Error(`Invalid table name ${tableName}.`);\n  }\n  return table;\n}\n"],"mappings":"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"}

package/dist/outbox/outbox.d.ts

@@ -0,0 +1,52 @@
+import { FragnoId } from "../schema/create.js";
+
+//#region src/outbox/outbox.d.ts
+type OutboxConfig = {
+  enabled: boolean;
+};
+type OutboxPayload = {
+  version: 1;
+  mutations: OutboxMutation[];
+};
+type OutboxMutation = {
+  op: "create";
+  schema: string;
+  namespace?: string;
+  table: string;
+  externalId: string;
+  versionstamp: string;
+  values: Record<string, unknown>;
+} | {
+  op: "update";
+  schema: string;
+  namespace?: string;
+  table: string;
+  externalId: string;
+  versionstamp: string;
+  set: Record<string, unknown>;
+  checkVersion?: number;
+} | {
+  op: "delete";
+  schema: string;
+  namespace?: string;
+  table: string;
+  externalId: string;
+  versionstamp: string;
+  checkVersion?: number;
+};
+type OutboxRefMap = Record<string, string>;
+type OutboxPayloadSerialized = {
+  json: unknown;
+  meta?: Record<string, unknown>;
+};
+type OutboxEntry = {
+  id: FragnoId;
+  versionstamp: string;
+  uowId: string;
+  payload: OutboxPayloadSerialized;
+  refMap?: OutboxRefMap;
+  createdAt: Date;
+};
+//#endregion
+export { OutboxConfig, OutboxEntry, OutboxMutation, OutboxPayload, OutboxRefMap };
+//# sourceMappingURL=outbox.d.ts.map

package/dist/outbox/outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.d.ts","names":[],"sources":["../../src/outbox/outbox.ts"],"sourcesContent":[],"mappings":";;;KAEY,YAAA;;AAAZ,CAAA;AAcY,KALA,aAAA,GAKc;EA8Bd,OAAA,EAAA,CAAA;EAEA,SAAA,EAnCC,cAmCD,EAAuB;AAKnC,CAAA;AACM,KAtCM,cAAA,GAsCN;EAGK,EAAA,EAAA,QAAA;EACA,MAAA,EAAA,MAAA;EACE,SAAA,CAAA,EAAA,MAAA;EAAI,KAAA,EAAA,MAAA;;;UAnCH;;;;;;;;OASH;;;;;;;;;;;KAaC,YAAA,GAAe;KAEf,uBAAA;;SAEH;;KAGG,WAAA;MACN;;;WAGK;WACA;aACE"}

package/dist/outbox/outbox.js

@@ -0,0 +1,37 @@
+//#region src/outbox/outbox.ts
+function encodeVersionstamp(transactionVersion, userVersion) {
+	if (userVersion < 0 || userVersion > 65535) throw new Error(`Invalid outbox user version: ${userVersion}`);
+	const txBytes = bigintToBytes(transactionVersion, 10);
+	const userBytes = new Uint8Array(2);
+	userBytes[0] = userVersion >> 8 & 255;
+	userBytes[1] = userVersion & 255;
+	const combined = new Uint8Array(12);
+	combined.set(txBytes, 0);
+	combined.set(userBytes, 10);
+	return combined;
+}
+function versionstampToHex(bytes) {
+	let hex = "";
+	for (const byte of bytes) hex += byte.toString(16).padStart(2, "0");
+	return hex;
+}
+function parseOutboxVersionValue(value) {
+	if (typeof value === "bigint") return value;
+	if (typeof value === "number") return BigInt(value);
+	if (typeof value === "string") return BigInt(value);
+	throw new Error(`Invalid outbox version value: ${String(value)}`);
+}
+function bigintToBytes(value, length) {
+	const bytes = new Uint8Array(length);
+	let remaining = value;
+	for (let i = length - 1; i >= 0; i -= 1) {
+		bytes[i] = Number(remaining & 255n);
+		remaining >>= 8n;
+	}
+	if (remaining !== 0n) throw new Error(`Outbox version ${value} exceeds ${length * 8} bits`);
+	return bytes;
+}
+
+//#endregion
+export { encodeVersionstamp, parseOutboxVersionValue, versionstampToHex };
+//# sourceMappingURL=outbox.js.map

package/dist/outbox/outbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.js","names":[],"sources":["../../src/outbox/outbox.ts"],"sourcesContent":["import type { AnyTable, FragnoId } from \"../schema/create\";\n\nexport type OutboxConfig = {\n  enabled: boolean;\n};\n\nexport type OutboxVersionstampStrategy =\n  | \"update-returning\"\n  | \"insert-on-conflict-returning\"\n  | \"insert-on-duplicate-last-insert-id\";\n\nexport type OutboxPayload = {\n  version: 1;\n  mutations: OutboxMutation[];\n};\n\nexport type OutboxMutation =\n  | {\n      op: \"create\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      values: Record<string, unknown>;\n    }\n  | {\n      op: \"update\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      set: Record<string, unknown>;\n      checkVersion?: number;\n    }\n  | {\n      op: \"delete\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      checkVersion?: number;\n    };\n\nexport type OutboxRefMap = Record<string, string>;\n\nexport type OutboxPayloadSerialized = {\n  json: unknown;\n  meta?: Record<string, unknown>;\n};\n\nexport type OutboxEntry = {\n  id: FragnoId;\n  versionstamp: string;\n  uowId: string;\n  payload: OutboxPayloadSerialized;\n  refMap?: OutboxRefMap;\n  createdAt: Date;\n};\n\nexport type OutboxRefLookup = {\n  key: string;\n  internalId: bigint | number;\n  table: AnyTable;\n  namespace?: string;\n};\n\nexport function encodeVersionstamp(transactionVersion: bigint, userVersion: number): Uint8Array {\n  if (userVersion < 0 || userVersion > 0xffff) {\n    throw new Error(`Invalid outbox user version: ${userVersion}`);\n  }\n\n  const txBytes = bigintToBytes(transactionVersion, 10);\n  const userBytes = new Uint8Array(2);\n  userBytes[0] = (userVersion >> 8) & 0xff;\n  userBytes[1] = userVersion & 0xff;\n\n  const combined = new Uint8Array(12);\n  combined.set(txBytes, 0);\n  combined.set(userBytes, 10);\n\n  return combined;\n}\n\nexport function versionstampToHex(bytes: Uint8Array): string {\n  let hex = \"\";\n  for (const byte of bytes) {\n    hex += byte.toString(16).padStart(2, \"0\");\n  }\n  return hex;\n}\n\nexport function hexToVersionstamp(hex: string): Uint8Array {\n  if (hex.length % 2 !== 0) {\n    throw new Error(`Invalid versionstamp hex length: ${hex.length}`);\n  }\n\n  const bytes = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < hex.length; i += 2) {\n    bytes[i / 2] = Number.parseInt(hex.slice(i, i + 2), 16);\n  }\n  return bytes;\n}\n\nexport function parseOutboxVersionValue(value: unknown): bigint {\n  if (typeof value === \"bigint\") {\n    return value;\n  }\n\n  if (typeof value === \"number\") {\n    return BigInt(value);\n  }\n\n  if (typeof value === \"string\") {\n    return BigInt(value);\n  }\n\n  throw new Error(`Invalid outbox version value: ${String(value)}`);\n}\n\nfunction bigintToBytes(value: bigint, length: number): Uint8Array {\n  const bytes = new Uint8Array(length);\n  let remaining = value;\n\n  for (let i = length - 1; i >= 0; i -= 1) {\n    bytes[i] = Number(remaining & 0xffn);\n    remaining >>= 8n;\n  }\n\n  if (remaining !== 0n) {\n    throw new Error(`Outbox version ${value} exceeds ${length * 8} bits`);\n  }\n\n  return bytes;\n}\n"],"mappings":";AAqEA,SAAgB,mBAAmB,oBAA4B,aAAiC;AAC9F,KAAI,cAAc,KAAK,cAAc,MACnC,OAAM,IAAI,MAAM,gCAAgC,cAAc;CAGhE,MAAM,UAAU,cAAc,oBAAoB,GAAG;CACrD,MAAM,YAAY,IAAI,WAAW,EAAE;AACnC,WAAU,KAAM,eAAe,IAAK;AACpC,WAAU,KAAK,cAAc;CAE7B,MAAM,WAAW,IAAI,WAAW,GAAG;AACnC,UAAS,IAAI,SAAS,EAAE;AACxB,UAAS,IAAI,WAAW,GAAG;AAE3B,QAAO;;AAGT,SAAgB,kBAAkB,OAA2B;CAC3D,IAAI,MAAM;AACV,MAAK,MAAM,QAAQ,MACjB,QAAO,KAAK,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI;AAE3C,QAAO;;AAeT,SAAgB,wBAAwB,OAAwB;AAC9D,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAGtB,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAGtB,OAAM,IAAI,MAAM,iCAAiC,OAAO,MAAM,GAAG;;AAGnE,SAAS,cAAc,OAAe,QAA4B;CAChE,MAAM,QAAQ,IAAI,WAAW,OAAO;CACpC,IAAI,YAAY;AAEhB,MAAK,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AACvC,QAAM,KAAK,OAAO,YAAY,KAAM;AACpC,gBAAc;;AAGhB,KAAI,cAAc,GAChB,OAAM,IAAI,MAAM,kBAAkB,MAAM,WAAW,SAAS,EAAE,OAAO;AAGvE,QAAO"}

package/dist/packages/fragno/dist/api/fragment-definition-builder.js

@@ -269,8 +269,9 @@ var FragmentDefinitionBuilder = class FragmentDefinitionBuilder$1 {
 	}
 	/**
 	* Register a linked fragment that will be automatically instantiated.
-	* Linked fragments are service-only (no routes) and share the same config/options as the parent.
-	* All services from the linked fragment will be available as private services.
+	* Linked fragments share the same config/options as the parent and their services
+	* are exposed as private services. Routes are not exposed by default, but the
+	* instantiator may mount internal linked fragment routes under an internal prefix.
 	*/
 	withLinkedFragment(name, callback) {
 		const newLinkedFragments = {

package/dist/packages/fragno/dist/api/fragment-definition-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"fragment-definition-builder.js","names":["FragmentDefinitionBuilder","#name","#dependencies","#baseServices","#namedServices","#privateServices","#serviceDependencies","#createRequestStorage","#createThisContext","#getExternalStorage","#linkedFragments"],"sources":["../../../../../../fragno/dist/api/fragment-definition-builder.js"],"sourcesContent":["//#region src/api/fragment-definition-builder.ts\n/**\n* Builder class for creating fragment definitions.\n* This provides a fluent API for defining fragments with type safety.\n*/\nvar FragmentDefinitionBuilder = class FragmentDefinitionBuilder {\n\t#name;\n\t#dependencies;\n\t#baseServices;\n\t#namedServices;\n\t#privateServices;\n\t#serviceDependencies;\n\t#createRequestStorage;\n\t#createThisContext;\n\t#getExternalStorage;\n\t#linkedFragments;\n\tconstructor(name, state) {\n\t\tthis.#name = name;\n\t\tif (state) {\n\t\t\tthis.#dependencies = state.dependencies;\n\t\t\tthis.#baseServices = state.baseServices;\n\t\t\tthis.#namedServices = state.namedServices;\n\t\t\tthis.#privateServices = state.privateServices;\n\t\t\tthis.#serviceDependencies = state.serviceDependencies;\n\t\t\tthis.#createRequestStorage = state.createRequestStorage;\n\t\t\tthis.#createThisContext = state.createThisContext;\n\t\t\tthis.#getExternalStorage = state.getExternalStorage;\n\t\t\tthis.#linkedFragments = state.linkedFragments;\n\t\t}\n\t}\n\tget name() {\n\t\treturn this.#name;\n\t}\n\t/**\n\t* Define dependencies for this fragment.\n\t* Dependencies are available to services and handlers.\n\t*\n\t* **IMPORTANT**: This method resets all services, storage, and context configurations.\n\t* Always call `withDependencies` early in the builder chain, before defining services\n\t* or request storage/context.\n\t*\n\t* @example\n\t* ```typescript\n\t* // ✅ GOOD: Dependencies set first\n\t* defineFragment(\"my-fragment\")\n\t*   .withDependencies(() => ({ apiKey: \"...\" }))\n\t*   .withRequestStorage(({ deps }) => ({ userId: deps.apiKey }))\n\t*   .providesService(\"myService\", ...)\n\t*\n\t* // ❌ BAD: Dependencies set late (erases storage setup)\n\t* defineFragment(\"my-fragment\")\n\t*   .withRequestStorage(() => ({ userId: \"...\" }))  // This gets erased!\n\t*   .withDependencies(() => ({ apiKey: \"...\" }))\n\t* ```\n\t*/\n\twithDependencies(fn) {\n\t\tif (this.#baseServices || this.#namedServices || this.#privateServices || this.#createRequestStorage || this.#createThisContext || this.#getExternalStorage) console.warn(`[Fragno] Warning: withDependencies() on fragment \"${this.#name}\" is resetting previously configured services, request storage, or request context. To avoid this, call withDependencies() earlier in the builder chain, before configuring services or storage.`);\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: fn,\n\t\t\tbaseServices: void 0,\n\t\t\tnamedServices: void 0,\n\t\t\tprivateServices: void 0,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: void 0,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: void 0,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Define base (unnamed) services for this fragment.\n\t* Base services are accessible directly on the fragment instance.\n\t*/\n\tprovidesBaseService(fn) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: fn,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Provide a named service that other fragments or users can use.\n\t* Named services are accessible as fragment.serviceName.method()\n\t*/\n\tprovidesService(serviceName, fn) {\n\t\tconst newNamedServices = {\n\t\t\t...this.#namedServices,\n\t\t\t[serviceName]: fn\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: newNamedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Provide a private service that is only accessible to the fragment author.\n\t* Private services are NOT exposed on the fragment instance, but can be used\n\t* when defining other services (baseServices, namedServices, and other privateServices).\n\t* Private services are instantiated in order, so earlier private services are available\n\t* to later ones.\n\t*/\n\tprovidesPrivateService(serviceName, fn) {\n\t\tconst newPrivateServices = {\n\t\t\t...this.#privateServices,\n\t\t\t[serviceName]: fn\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: newPrivateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Declare that this fragment uses a required service provided by the runtime.\n\t*/\n\tusesService(serviceName) {\n\t\tconst newServiceDependencies = {\n\t\t\t...this.#serviceDependencies,\n\t\t\t[serviceName]: {\n\t\t\t\tname: serviceName,\n\t\t\t\trequired: true\n\t\t\t}\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: newServiceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Declare that this fragment uses an optional service provided by the runtime.\n\t*/\n\tusesOptionalService(serviceName) {\n\t\tconst newServiceDependencies = {\n\t\t\t...this.#serviceDependencies,\n\t\t\t[serviceName]: {\n\t\t\t\tname: serviceName,\n\t\t\t\trequired: false\n\t\t\t}\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: newServiceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Define the type and initial data stored in AsyncLocalStorage for per-request isolation.\n\t* This should be called before withThisContext if you need to store request-specific data.\n\t*\n\t* @param initializer Function that returns the initial storage data for each request\n\t*\n\t* @example\n\t* ```typescript\n\t* .withRequestStorage(({ config, options, deps }) => ({\n\t*   counter: 0,\n\t*   userId: deps.currentUserId\n\t* }))\n\t* .withThisContext(({ storage }) => ({\n\t*   serviceContext: {\n\t*     get counter() { return storage.getStore()!.counter; }\n\t*   },\n\t*   handlerContext: {\n\t*     get counter() { return storage.getStore()!.counter; }\n\t*   }\n\t* }))\n\t* ```\n\t*/\n\twithRequestStorage(initializer) {\n\t\tconst preservedExternalStorage = this.#getExternalStorage ? this.#getExternalStorage : void 0;\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: initializer,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: preservedExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Use an externally-provided RequestContextStorage instance.\n\t* This allows multiple fragments to share the same storage instance.\n\t* Useful when fragments need to coordinate (e.g., database fragments sharing adapter storage).\n\t* Note: You must still call withRequestStorage to provide the initial storage data.\n\t*\n\t* @example\n\t* ```typescript\n\t* .withExternalRequestStorage(({ options }) =>\n\t*   options.databaseAdapter.contextStorage\n\t* )\n\t* .withRequestStorage(({ options }) => ({\n\t*   uow: options.databaseAdapter.db.createUnitOfWork()\n\t* }))\n\t* ```\n\t*/\n\twithExternalRequestStorage(getStorage) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: void 0,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: getStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Set the this contexts for services and handlers in this fragment.\n\t* Both contexts should contain only methods or getters that read from storage.\n\t* This ensures proper per-request isolation via AsyncLocalStorage.\n\t*\n\t* @example\n\t* ```ts\n\t* .withThisContext(({ storage }) => ({\n\t*   serviceContext: {\n\t*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n\t*   },\n\t*   handlerContext: {\n\t*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n\t*   }\n\t* }))\n\t* ```\n\t*/\n\twithThisContext(fn) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: fn,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Register a linked fragment that will be automatically instantiated.\n\t* Linked fragments are service-only (no routes) and share the same config/options as the parent.\n\t* All services from the linked fragment will be available as private services.\n\t*/\n\twithLinkedFragment(name, callback) {\n\t\tconst newLinkedFragments = {\n\t\t\t...this.#linkedFragments,\n\t\t\t[name]: callback\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: newLinkedFragments\n\t\t});\n\t}\n\t/**\n\t* Extend this builder with a transformation function.\n\t* This enables fluent API extensions like `.extend(withDatabase(schema))`.\n\t*/\n\textend(transformer) {\n\t\treturn transformer(this);\n\t}\n\t/**\n\t* Build the final fragment definition\n\t*/\n\tbuild() {\n\t\treturn {\n\t\t\tname: this.#name,\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t};\n\t}\n};\n/**\n* Create a new fragment definition builder\n*/\nfunction defineFragment(name) {\n\treturn new FragmentDefinitionBuilder(name);\n}\n\n//#endregion\nexport { FragmentDefinitionBuilder, defineFragment };\n//# sourceMappingURL=fragment-definition-builder.js.map"],"mappings":"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"}
+{"version":3,"file":"fragment-definition-builder.js","names":["FragmentDefinitionBuilder","#name","#dependencies","#baseServices","#namedServices","#privateServices","#serviceDependencies","#createRequestStorage","#createThisContext","#getExternalStorage","#linkedFragments"],"sources":["../../../../../../fragno/dist/api/fragment-definition-builder.js"],"sourcesContent":["//#region src/api/fragment-definition-builder.ts\n/**\n* Builder class for creating fragment definitions.\n* This provides a fluent API for defining fragments with type safety.\n*/\nvar FragmentDefinitionBuilder = class FragmentDefinitionBuilder {\n\t#name;\n\t#dependencies;\n\t#baseServices;\n\t#namedServices;\n\t#privateServices;\n\t#serviceDependencies;\n\t#createRequestStorage;\n\t#createThisContext;\n\t#getExternalStorage;\n\t#linkedFragments;\n\tconstructor(name, state) {\n\t\tthis.#name = name;\n\t\tif (state) {\n\t\t\tthis.#dependencies = state.dependencies;\n\t\t\tthis.#baseServices = state.baseServices;\n\t\t\tthis.#namedServices = state.namedServices;\n\t\t\tthis.#privateServices = state.privateServices;\n\t\t\tthis.#serviceDependencies = state.serviceDependencies;\n\t\t\tthis.#createRequestStorage = state.createRequestStorage;\n\t\t\tthis.#createThisContext = state.createThisContext;\n\t\t\tthis.#getExternalStorage = state.getExternalStorage;\n\t\t\tthis.#linkedFragments = state.linkedFragments;\n\t\t}\n\t}\n\tget name() {\n\t\treturn this.#name;\n\t}\n\t/**\n\t* Define dependencies for this fragment.\n\t* Dependencies are available to services and handlers.\n\t*\n\t* **IMPORTANT**: This method resets all services, storage, and context configurations.\n\t* Always call `withDependencies` early in the builder chain, before defining services\n\t* or request storage/context.\n\t*\n\t* @example\n\t* ```typescript\n\t* // ✅ GOOD: Dependencies set first\n\t* defineFragment(\"my-fragment\")\n\t*   .withDependencies(() => ({ apiKey: \"...\" }))\n\t*   .withRequestStorage(({ deps }) => ({ userId: deps.apiKey }))\n\t*   .providesService(\"myService\", ...)\n\t*\n\t* // ❌ BAD: Dependencies set late (erases storage setup)\n\t* defineFragment(\"my-fragment\")\n\t*   .withRequestStorage(() => ({ userId: \"...\" }))  // This gets erased!\n\t*   .withDependencies(() => ({ apiKey: \"...\" }))\n\t* ```\n\t*/\n\twithDependencies(fn) {\n\t\tif (this.#baseServices || this.#namedServices || this.#privateServices || this.#createRequestStorage || this.#createThisContext || this.#getExternalStorage) console.warn(`[Fragno] Warning: withDependencies() on fragment \"${this.#name}\" is resetting previously configured services, request storage, or request context. To avoid this, call withDependencies() earlier in the builder chain, before configuring services or storage.`);\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: fn,\n\t\t\tbaseServices: void 0,\n\t\t\tnamedServices: void 0,\n\t\t\tprivateServices: void 0,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: void 0,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: void 0,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Define base (unnamed) services for this fragment.\n\t* Base services are accessible directly on the fragment instance.\n\t*/\n\tprovidesBaseService(fn) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: fn,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Provide a named service that other fragments or users can use.\n\t* Named services are accessible as fragment.serviceName.method()\n\t*/\n\tprovidesService(serviceName, fn) {\n\t\tconst newNamedServices = {\n\t\t\t...this.#namedServices,\n\t\t\t[serviceName]: fn\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: newNamedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Provide a private service that is only accessible to the fragment author.\n\t* Private services are NOT exposed on the fragment instance, but can be used\n\t* when defining other services (baseServices, namedServices, and other privateServices).\n\t* Private services are instantiated in order, so earlier private services are available\n\t* to later ones.\n\t*/\n\tprovidesPrivateService(serviceName, fn) {\n\t\tconst newPrivateServices = {\n\t\t\t...this.#privateServices,\n\t\t\t[serviceName]: fn\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: newPrivateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Declare that this fragment uses a required service provided by the runtime.\n\t*/\n\tusesService(serviceName) {\n\t\tconst newServiceDependencies = {\n\t\t\t...this.#serviceDependencies,\n\t\t\t[serviceName]: {\n\t\t\t\tname: serviceName,\n\t\t\t\trequired: true\n\t\t\t}\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: newServiceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Declare that this fragment uses an optional service provided by the runtime.\n\t*/\n\tusesOptionalService(serviceName) {\n\t\tconst newServiceDependencies = {\n\t\t\t...this.#serviceDependencies,\n\t\t\t[serviceName]: {\n\t\t\t\tname: serviceName,\n\t\t\t\trequired: false\n\t\t\t}\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: newServiceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Define the type and initial data stored in AsyncLocalStorage for per-request isolation.\n\t* This should be called before withThisContext if you need to store request-specific data.\n\t*\n\t* @param initializer Function that returns the initial storage data for each request\n\t*\n\t* @example\n\t* ```typescript\n\t* .withRequestStorage(({ config, options, deps }) => ({\n\t*   counter: 0,\n\t*   userId: deps.currentUserId\n\t* }))\n\t* .withThisContext(({ storage }) => ({\n\t*   serviceContext: {\n\t*     get counter() { return storage.getStore()!.counter; }\n\t*   },\n\t*   handlerContext: {\n\t*     get counter() { return storage.getStore()!.counter; }\n\t*   }\n\t* }))\n\t* ```\n\t*/\n\twithRequestStorage(initializer) {\n\t\tconst preservedExternalStorage = this.#getExternalStorage ? this.#getExternalStorage : void 0;\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: initializer,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: preservedExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Use an externally-provided RequestContextStorage instance.\n\t* This allows multiple fragments to share the same storage instance.\n\t* Useful when fragments need to coordinate (e.g., database fragments sharing adapter storage).\n\t* Note: You must still call withRequestStorage to provide the initial storage data.\n\t*\n\t* @example\n\t* ```typescript\n\t* .withExternalRequestStorage(({ options }) =>\n\t*   options.databaseAdapter.contextStorage\n\t* )\n\t* .withRequestStorage(({ options }) => ({\n\t*   uow: options.databaseAdapter.db.createUnitOfWork()\n\t* }))\n\t* ```\n\t*/\n\twithExternalRequestStorage(getStorage) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: void 0,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: getStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Set the this contexts for services and handlers in this fragment.\n\t* Both contexts should contain only methods or getters that read from storage.\n\t* This ensures proper per-request isolation via AsyncLocalStorage.\n\t*\n\t* @example\n\t* ```ts\n\t* .withThisContext(({ storage }) => ({\n\t*   serviceContext: {\n\t*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n\t*   },\n\t*   handlerContext: {\n\t*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n\t*   }\n\t* }))\n\t* ```\n\t*/\n\twithThisContext(fn) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: fn,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Register a linked fragment that will be automatically instantiated.\n\t* Linked fragments share the same config/options as the parent and their services\n\t* are exposed as private services. Routes are not exposed by default, but the\n\t* instantiator may mount internal linked fragment routes under an internal prefix.\n\t*/\n\twithLinkedFragment(name, callback) {\n\t\tconst newLinkedFragments = {\n\t\t\t...this.#linkedFragments,\n\t\t\t[name]: callback\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: newLinkedFragments\n\t\t});\n\t}\n\t/**\n\t* Extend this builder with a transformation function.\n\t* This enables fluent API extensions like `.extend(withDatabase(schema))`.\n\t*/\n\textend(transformer) {\n\t\treturn transformer(this);\n\t}\n\t/**\n\t* Build the final fragment definition\n\t*/\n\tbuild() {\n\t\treturn {\n\t\t\tname: this.#name,\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t};\n\t}\n};\n/**\n* Create a new fragment definition builder\n*/\nfunction defineFragment(name) {\n\treturn new FragmentDefinitionBuilder(name);\n}\n\n//#endregion\nexport { FragmentDefinitionBuilder, defineFragment };\n//# sourceMappingURL=fragment-definition-builder.js.map"],"mappings":"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"}