@agimon-ai/po-db 0.0.0-alpha.61

package/LICENSE

@@ -0,0 +1,149 @@
+License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             Agimon Pty Ltd
+Licensed Work:        Po, the software in the Po source repository and the
+                      packages released from it, in each version released by
+                      the Licensor.
+                      The Licensed Work is (c) 2026 Agimon Pty Ltd.
+                      Material identified as third-party in the "Third-party
+                      components" section at the end of this file or in a
+                      NOTICE file, and any package or directory whose own
+                      license file grants a different license, is not part of
+                      the Licensed Work and remains under its own license.
+Additional Use Grant: You may make production use of the Licensed Work if
+  your use is Eligible Use. "Eligible Use" is production use that falls
+  within at least one of the following:
+
+  (a) Personal Use. Use by an individual for their own personal purposes,
+      and not on behalf of, or for the benefit of, an employer, client, or
+      other Organization. Use by an individual in the course of employment
+      or engagement by an Organization is use by that Organization.
+
+  (b) Small Organization Use. Use by or on behalf of an Organization whose
+      Annual Revenue is less than USD 1,000,000.
+
+  (c) Non-profit, Education and Research Use. Use, regardless of Annual
+      Revenue, by (i) an Organization registered or recognized as a
+      non-profit or charitable organization under the laws of its
+      jurisdiction, for its non-profit purposes; (ii) an accredited school,
+      college, or university, for teaching, learning, or academic research;
+      or (iii) a publicly funded research institution, for its research.
+
+  (d) Service Provider Use. Use by a consultant, contractor, agency, or other
+      service provider, regardless of its own Annual Revenue, solely to
+      build, deploy, host, operate, or support the Licensed Work for a client
+      whose own use would be Eligible Use under (a), (b), or (c). A service
+      provider's use for its own purposes is Eligible Use only if the service
+      provider itself qualifies under (b) or (c).
+
+
+  Hosted services. Offering the Licensed Work to third parties as a hosted
+  or managed service whose primary value is the Licensed Work is Eligible
+  Use only if each such third party's own use would be Eligible Use.
+
+  Definitions. "Organization" means any company, partnership, sole
+  proprietorship, trust, association, government body, or other entity, and
+  includes an individual acting in a business or professional capacity.
+  "Affiliate" means any entity that directly or indirectly controls, is
+  controlled by, or is under common control with an Organization, where
+  "control" means ownership of more than 50% of the voting interests of an
+  entity or the power to direct its management and policies by contract or
+  otherwise. "Annual Revenue" means the total gross revenue of an
+  Organization and all of its Affiliates combined, from all sources and
+  whether or not related to the Licensed Work, for its most recently
+  completed fiscal year, or, if it has not completed a fiscal year, for the
+  twelve months before the use (or since its formation, if shorter),
+  converted into US dollars at the average exchange rate for that period.
+  Proceeds of equity or debt financing are not revenue.
+
+  Threshold. If an Organization stops qualifying under (b), its existing
+  production use remains Eligible Use for 90 days after it stops
+  qualifying, after which it must obtain a commercial license or stop
+  production use. Use that was Eligible Use when it occurred never requires
+  a commercial license after the fact.
+Change Date:          Four years from the date a version of the Licensed Work
+                      is first publicly released by the Licensor.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please visit: https://agimon.ai/licensing
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -0,0 +1,52 @@
+# @agimon-ai/po-db
+
+One shared sqlite database for the Po packages that need one.
+
+Po opens `<po home>/db/po.sqlite` once per process, in a folder only the owner can read, and binds it as the global `po/db` service. Every workspace and session resolves that same connection.
+
+## Rules for consumers
+
+- **One shared connection.** Node's sqlite waits for a locked database synchronously. A second connection in the same process would block the event loop while the first one's transaction holds the write lock, so both stall. Use the `database` you are given; never open `po.sqlite` yourself.
+- **`close()` does nothing.** The `database` you receive is a view of the shared connection. Only the po-db root closes the real one, when the server stops.
+- **No network work inside a transaction.** A transaction holds the write lock for every package in every Po process. Read, call the network, then write in a short transaction or a single statement.
+- **Own a prefix.** Each package picks one table prefix (lowercase words joined by `_`) and creates its schema through `migrate(prefix, migrations)`. Every table, index, view and trigger a migration creates must start with `<prefix>_`; anything else rolls the migration back. The schema version is kept in `<prefix>_migrations`.
+- **No PRAGMA, no ATTACH, no paths.** Connection settings belong to the root.
+
+## Use
+
+Declare the contract your root waits for, so a host without po-db shows a "waits for contract" notice instead of hanging:
+
+```ts
+import { defineRoot } from '@agimon-ai/po-core/extensionFile';
+import { PO_DB_CONTRACT, PO_DB_SERVICE, type PoDb } from '@agimon-ai/po-db';
+
+export default defineRoot(createMyRoot, { inject: [PO_DB_CONTRACT] });
+
+// inside the root, once `po/db` is injected:
+const db = context.get(PO_DB_SERVICE) as PoDb;
+await db.migrate('notes', [
+  { version: 1, statements: ['CREATE TABLE notes_items (id TEXT PRIMARY KEY, body TEXT NOT NULL) STRICT'] },
+]);
+await db.database.run('INSERT INTO notes_items (id, body) VALUES (?, ?)', 'n1', 'hello');
+```
+
+## Testing
+
+```ts
+import { createTestPoDb } from '@agimon-ai/po-db/testing';
+
+const db = await createTestPoDb(); // in memory; pass a file path to share it across processes
+await db.close();
+```
+
+`./testing` runs on Node only.
+
+## Public API
+
+- `@agimon-ai/po-db`: `PO_DB_SERVICE`, `PO_DB_CONTRACT`, `PO_DB_FILE`, `createPoDb`, and the `PoDb`, `PoDbHandle`, `PoDbMigration` types.
+- `@agimon-ai/po-db/testing`: `createTestPoDb`.
+- `@agimon-ai/po-db/extensions/server`: the native server entry, a fixed Po host package.
+
+## Requirements
+
+- Node.js 24 or newer

package/dist/apiContracts.cjs

@@ -0,0 +1,17 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/schemas/apiContracts.ts
+/** This server plugin provides the po/db service only, with no separate HTTP or socket surface. */
+const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This server plugin provides the po/db service only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+//#region src/schemas/apiContracts.d.ts
+/** This server plugin provides the po/db service only, with no separate HTTP or socket surface. */
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -0,0 +1,13 @@
+import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
+//#region src/schemas/apiContracts.ts
+/** This server plugin provides the po/db service only, with no separate HTTP or socket surface. */
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This server plugin provides the po/db service only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/contracts-Bv9-_vyc.mjs

@@ -0,0 +1,15 @@
+import { r as PO_DB_SERVICE } from "./poDb-D6K38Gpu.mjs";
+import { defineServiceContract } from "@agimon-ai/po-core/extensionFile";
+//#region src/schemas/contracts.ts
+/** Bound once at the global level; every workspace and session resolves the same connection. */
+const PO_DB_CONTRACT = defineServiceContract(PO_DB_SERVICE, { scope: "global" });
+/** The shared database, for a caller that injected `po/db`; throws when no global root bound one. */
+function requirePoDb(context) {
+	const db = context.get(PO_DB_SERVICE);
+	if (db === void 0) throw new Error("The Po database is unavailable. Install @agimon-ai/po-db at the global scope.");
+	return db;
+}
+//#endregion
+export { requirePoDb as n, PO_DB_CONTRACT as t };
+
+//# sourceMappingURL=contracts-Bv9-_vyc.mjs.map

package/dist/contracts-Bv9-_vyc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-Bv9-_vyc.mjs","names":[],"sources":["../src/schemas/contracts.ts"],"sourcesContent":["import { defineServiceContract } from '@agimon-ai/po-core/extensionFile';\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport { PO_DB_SERVICE } from '../constants/db';\nimport type { PoDb } from '../services/poDb/type';\n\n/** Bound once at the global level; every workspace and session resolves the same connection. */\nexport const PO_DB_CONTRACT = defineServiceContract<PoDb>(PO_DB_SERVICE, { scope: 'global' });\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/db': PoDb;\n  }\n}\n\n/** The shared database, for a caller that injected `po/db`; throws when no global root bound one. */\nexport function requirePoDb(context: Context): PoDb {\n  const db = context.get(PO_DB_SERVICE) as PoDb | undefined;\n  if (db === undefined)\n    throw new Error('The Po database is unavailable. Install @agimon-ai/po-db at the global scope.');\n  return db;\n}\n"],"mappings":";;;;AAOA,MAAa,iBAAiB,sBAA4B,eAAe,EAAE,OAAO,SAAS,CAAC;;AAS5F,SAAgB,YAAY,SAAwB;CAClD,MAAM,KAAK,QAAQ,IAAI,aAAa;CACpC,IAAI,OAAO,KAAA,GACT,MAAM,IAAI,MAAM,+EAA+E;CACjG,OAAO;AACT"}

package/dist/contracts-C9sToxiM.cjs

@@ -0,0 +1,25 @@
+const require_poDb = require("./poDb-BKBXJbTa.cjs");
+//#region src/schemas/contracts.ts
+/** Bound once at the global level; every workspace and session resolves the same connection. */
+const PO_DB_CONTRACT = (0, require("@agimon-ai/po-core/extensionFile").defineServiceContract)(require_poDb.PO_DB_SERVICE, { scope: "global" });
+/** The shared database, for a caller that injected `po/db`; throws when no global root bound one. */
+function requirePoDb(context) {
+	const db = context.get(require_poDb.PO_DB_SERVICE);
+	if (db === void 0) throw new Error("The Po database is unavailable. Install @agimon-ai/po-db at the global scope.");
+	return db;
+}
+//#endregion
+Object.defineProperty(exports, "PO_DB_CONTRACT", {
+	enumerable: true,
+	get: function() {
+		return PO_DB_CONTRACT;
+	}
+});
+Object.defineProperty(exports, "requirePoDb", {
+	enumerable: true,
+	get: function() {
+		return requirePoDb;
+	}
+});
+
+//# sourceMappingURL=contracts-C9sToxiM.cjs.map

package/dist/contracts-C9sToxiM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-C9sToxiM.cjs","names":["defineServiceContract","PO_DB_SERVICE"],"sources":["../src/schemas/contracts.ts"],"sourcesContent":["import { defineServiceContract } from '@agimon-ai/po-core/extensionFile';\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport { PO_DB_SERVICE } from '../constants/db';\nimport type { PoDb } from '../services/poDb/type';\n\n/** Bound once at the global level; every workspace and session resolves the same connection. */\nexport const PO_DB_CONTRACT = defineServiceContract<PoDb>(PO_DB_SERVICE, { scope: 'global' });\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/db': PoDb;\n  }\n}\n\n/** The shared database, for a caller that injected `po/db`; throws when no global root bound one. */\nexport function requirePoDb(context: Context): PoDb {\n  const db = context.get(PO_DB_SERVICE) as PoDb | undefined;\n  if (db === undefined)\n    throw new Error('The Po database is unavailable. Install @agimon-ai/po-db at the global scope.');\n  return db;\n}\n"],"mappings":";;;AAOA,MAAa,kBAAA,6CAAiBA,CAAAA,CAAAA,sBAAAA,CAA4BC,aAAAA,eAAe,EAAE,OAAO,SAAS,CAAC;;AAS5F,SAAgB,YAAY,SAAwB;CAClD,MAAM,KAAK,QAAQ,IAAIA,aAAAA,aAAa;CACpC,IAAI,OAAO,KAAA,GACT,MAAM,IAAI,MAAM,+EAA+E;CACjG,OAAO;AACT"}

package/dist/extensions/server.cjs

@@ -0,0 +1,113 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+const require_poDb = require("../poDb-BKBXJbTa.cjs");
+const require_contracts = require("../contracts-C9sToxiM.cjs");
+let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
+let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+let _agimon_ai_po_core_piSettings = require("@agimon-ai/po-core/piSettings");
+let _agimon_ai_po_core_platform = require("@agimon-ai/po-core/platform");
+//#region src/extensions/(backend)/_lib/root.server.ts
+/**
+* The process's one Po database, `<po home>/db/po.sqlite`, bound as `po/db` at the global level.
+*
+* Only a global host with a home directory opens it. Workspaces and sessions resolve the global
+* binding through the server scope, so the process keeps a single connection: a second
+* connection would block the event loop while it waits on the first one's write lock.
+*/
+async function createPoDbGlobalRoot(plugin) {
+	const host = plugin.host;
+	const homeDirectory = host.context.homeDirectory;
+	if (host.scope !== "global" || homeDirectory === void 0) return { value: void 0 };
+	let handle;
+	const provider = plugin.context.inject([
+		_agimon_ai_po_core_serverPlugin.PO_SERVER_SCOPE_SERVICE,
+		_agimon_ai_po_core_platform.PO_FS_SERVICE,
+		_agimon_ai_po_core_platform.PO_SQLITE_SERVICE
+	], async (injected) => {
+		if (handle === void 0) {
+			const directory = node_path.default.join((0, _agimon_ai_po_core_piSettings.poHomeDirectory)(homeDirectory, host.context.environment ?? {}), require_poDb.PO_DB_FILE[0]);
+			(0, _agimon_ai_po_core_platform.getOrThrow)(await (0, _agimon_ai_po_core_platform.requirePoFs)(injected).createDir(directory, { recursive: true }, _agimon_ai_po_core_platform.BACKGROUND_CONTEXT));
+			await _agimon_ai_po_core_platform.nodeHost.setMode(directory, 448);
+			const database = await (0, _agimon_ai_po_core_platform.requirePoSqlite)(injected).open(node_path.default.join(directory, require_poDb.PO_DB_FILE[1]), _agimon_ai_po_core_platform.BACKGROUND_CONTEXT);
+			handle = require_poDb.createPoDb({ database });
+		}
+		return (0, _agimon_ai_po_core_serverPlugin.requirePoServerScope)(injected).provide(require_contracts.PO_DB_CONTRACT, handle);
+	});
+	await provider.await();
+	return {
+		value: handle,
+		onDispose: async () => {
+			await provider.dispose();
+			await handle?.close();
+		}
+	};
+}
+//#endregion
+//#region src/extensions/(backend)/root.server.ts
+var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)(createPoDbGlobalRoot);
+//#endregion
+//#region generated/server.ts
+const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
+	name: "@agimon-ai/po-db",
+	providerOverrides: (0, _agimon_ai_po_core_serverPlugin.composeServerProviderOverrides)(root_server_default),
+	injects: (0, _agimon_ai_po_core_extensionFile.composeRootInjects)({
+		global: [root_server_default],
+		workspace: [root_server_default],
+		session: [root_server_default]
+	}),
+	global: async (context) => {
+		const scopeGlobal = await context.scopeRoot("global", root_server_default, context);
+		return {
+			...(0, _agimon_ai_po_core_extensionFile.composeRootHooks)(scopeGlobal),
+			services: [...scopeGlobal.services ?? []]
+		};
+	},
+	workspace: async (context) => {
+		const scopeGlobal = await context.scopeRoot("global", root_server_default, context);
+		return {
+			...(0, _agimon_ai_po_core_extensionFile.composeRootHooks)(scopeGlobal),
+			services: [...scopeGlobal.services ?? []]
+		};
+	},
+	session: async (context) => {
+		const scopeGlobal = await context.scopeRoot("global", root_server_default, context);
+		return {
+			...(0, _agimon_ai_po_core_extensionFile.composeRootHooks)(scopeGlobal),
+			services: [...scopeGlobal.services ?? []],
+			get activities() {
+				return [...scopeGlobal.activities ?? []];
+			}
+		};
+	}
+});
+//#endregion
+exports.default = serverPlugin;
+exports.serverPlugin = serverPlugin;
+
+//# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["PO_SERVER_SCOPE_SERVICE","PO_FS_SERVICE","PO_SQLITE_SERVICE","path","poHomeDirectory","PO_DB_FILE","requirePoFs","BACKGROUND_CONTEXT","nodeHost","requirePoSqlite","createPoDb","requirePoServerScope","PO_DB_CONTRACT","defineRoot","defineServerPlugin","composeServerProviderOverrides","rootGlobal","composeRootInjects","composeRootHooks"],"sources":["../../src/extensions/(backend)/_lib/root.server.ts","../../src/extensions/(backend)/root.server.ts","../../generated/server.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { RootDeclaration } from '@agimon-ai/po-core/extensionFile';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\nimport {\n  BACKGROUND_CONTEXT,\n  getOrThrow,\n  nodeHost,\n  PO_FS_SERVICE,\n  PO_SQLITE_SERVICE,\n  requirePoFs,\n  requirePoSqlite,\n} from '@agimon-ai/po-core/platform';\nimport {\n  PO_SERVER_SCOPE_SERVICE,\n  requirePoServerScope,\n  type PoServerPluginContext,\n} from '@agimon-ai/po-core/serverPlugin';\n\nimport { PO_DB_DIRECTORY_MODE, PO_DB_FILE } from '../../../constants/db';\nimport { PO_DB_CONTRACT } from '../../../schemas/contracts';\nimport { createPoDb } from '../../../services/poDb';\nimport type { PoDbHandle } from '../../../services/poDb/type';\n\n/**\n * The process's one Po database, `<po home>/db/po.sqlite`, bound as `po/db` at the global level.\n *\n * Only a global host with a home directory opens it. Workspaces and sessions resolve the global\n * binding through the server scope, so the process keeps a single connection: a second\n * connection would block the event loop while it waits on the first one's write lock.\n */\nexport async function createPoDbGlobalRoot(\n  plugin: PoServerPluginContext,\n): Promise<RootDeclaration<PoDbHandle | undefined, PoServerPluginContext>> {\n  const host = plugin.host;\n  const homeDirectory = host.context.homeDirectory;\n  if (host.scope !== 'global' || homeDirectory === undefined) return { value: undefined };\n  let handle: PoDbHandle | undefined;\n  const provider = plugin.context.inject(\n    [PO_SERVER_SCOPE_SERVICE, PO_FS_SERVICE, PO_SQLITE_SERVICE],\n    async (injected) => {\n      // The handle owns its file for the life of the mount; a re-run of this fiber only publishes it again.\n      if (handle === undefined) {\n        const directory = path.join(poHomeDirectory(homeDirectory, host.context.environment ?? {}), PO_DB_FILE[0]);\n        getOrThrow(await requirePoFs(injected).createDir(directory, { recursive: true }, BACKGROUND_CONTEXT));\n        await nodeHost.setMode(directory, PO_DB_DIRECTORY_MODE);\n        const database = await requirePoSqlite(injected).open(path.join(directory, PO_DB_FILE[1]), BACKGROUND_CONTEXT);\n        handle = createPoDb({ database });\n      }\n      return requirePoServerScope(injected).provide(PO_DB_CONTRACT, handle);\n    },\n  );\n  await provider.await();\n  return {\n    value: handle,\n    onDispose: async () => {\n      await provider.dispose();\n      await handle?.close();\n    },\n  };\n}\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\n\nimport { createPoDbGlobalRoot } from './_lib/root.server';\n\nexport default defineRoot(createPoDbGlobalRoot);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverPlugin';\nimport { composeRootHooks, composeRootInjects } from '@agimon-ai/po-core/extensionFile';\n\nimport rootGlobal from '../src/extensions/(backend)/root.server';\n\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-db',\n  providerOverrides: composeServerProviderOverrides(rootGlobal),\n  injects: composeRootInjects({ global: [rootGlobal], workspace: [rootGlobal], session: [rootGlobal] }),\n  global: async (context) => {\n    const scopeGlobal = await context.scopeRoot('global', rootGlobal, context);\n    return {\n      ...composeRootHooks(scopeGlobal),\n      services: [...(scopeGlobal.services ?? [])],\n    };\n  },\n  workspace: async (context) => {\n    const scopeGlobal = await context.scopeRoot('global', rootGlobal, context);\n    return {\n      ...composeRootHooks(scopeGlobal),\n      services: [...(scopeGlobal.services ?? [])],\n    };\n  },\n  session: async (context) => {\n    const scopeGlobal = await context.scopeRoot('global', rootGlobal, context);\n    return {\n      ...composeRootHooks(scopeGlobal),\n      services: [...(scopeGlobal.services ?? [])],\n      get activities(): PoServerSessionPlugin['activities'] { return [...(scopeGlobal.activities ?? [])]; },\n    };\n  },\n});\n\nexport default serverPlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,eAAsB,qBACpB,QACyE;CACzE,MAAM,OAAO,OAAO;CACpB,MAAM,gBAAgB,KAAK,QAAQ;CACnC,IAAI,KAAK,UAAU,YAAY,kBAAkB,KAAA,GAAW,OAAO,EAAE,OAAO,KAAA,EAAU;CACtF,IAAI;CACJ,MAAM,WAAW,OAAO,QAAQ,OAC9B;EAACA,gCAAAA;EAAyBC,4BAAAA;EAAeC,4BAAAA;CAAiB,GAC1D,OAAO,aAAa;EAElB,IAAI,WAAW,KAAA,GAAW;GACxB,MAAM,YAAYC,UAAAA,QAAK,MAAA,GAAKC,8BAAAA,gBAAAA,CAAgB,eAAe,KAAK,QAAQ,eAAe,CAAC,CAAC,GAAGC,aAAAA,WAAW,EAAE;GACzG,CAAA,GAAA,4BAAA,WAAA,CAAW,OAAA,GAAMC,4BAAAA,YAAAA,CAAY,QAAQ,CAAC,CAAC,UAAU,WAAW,EAAE,WAAW,KAAK,GAAGC,4BAAAA,kBAAkB,CAAC;GACpG,MAAMC,4BAAAA,SAAS,QAAQ,WAAA,GAA+B;GACtD,MAAM,WAAW,OAAA,GAAMC,4BAAAA,gBAAAA,CAAgB,QAAQ,CAAC,CAAC,KAAKN,UAAAA,QAAK,KAAK,WAAWE,aAAAA,WAAW,EAAE,GAAGE,4BAAAA,kBAAkB;GAC7G,SAASG,aAAAA,WAAW,EAAE,SAAS,CAAC;EAClC;EACA,QAAA,GAAOC,gCAAAA,qBAAAA,CAAqB,QAAQ,CAAC,CAAC,QAAQC,kBAAAA,gBAAgB,MAAM;CACtE,CACF;CACA,MAAM,SAAS,MAAM;CACrB,OAAO;EACL,OAAO;EACP,WAAW,YAAY;GACrB,MAAM,SAAS,QAAQ;GACvB,MAAM,QAAQ,MAAM;EACtB;CACF;AACF;;;ACxDA,IAAA,uBAAA,GAAeC,iCAAAA,WAAAA,CAAW,oBAAoB;;;ACG9C,MAAa,gBAAA,GAAeC,gCAAAA,mBAAAA,CAAmB;CAC7C,MAAM;CACN,oBAAA,GAAmBC,gCAAAA,+BAAAA,CAA+BC,mBAAU;CAC5D,UAAA,GAASC,iCAAAA,mBAAAA,CAAmB;EAAE,QAAQ,CAACD,mBAAU;EAAG,WAAW,CAACA,mBAAU;EAAG,SAAS,CAACA,mBAAU;CAAE,CAAC;CACpG,QAAQ,OAAO,YAAY;EACzB,MAAM,cAAc,MAAM,QAAQ,UAAU,UAAUA,qBAAY,OAAO;EACzE,OAAO;GACL,IAAA,GAAGE,iCAAAA,iBAAAA,CAAiB,WAAW;GAC/B,UAAU,CAAC,GAAI,YAAY,YAAY,CAAC,CAAE;EAC5C;CACF;CACA,WAAW,OAAO,YAAY;EAC5B,MAAM,cAAc,MAAM,QAAQ,UAAU,UAAUF,qBAAY,OAAO;EACzE,OAAO;GACL,IAAA,GAAGE,iCAAAA,iBAAAA,CAAiB,WAAW;GAC/B,UAAU,CAAC,GAAI,YAAY,YAAY,CAAC,CAAE;EAC5C;CACF;CACA,SAAS,OAAO,YAAY;EAC1B,MAAM,cAAc,MAAM,QAAQ,UAAU,UAAUF,qBAAY,OAAO;EACzE,OAAO;GACL,IAAA,GAAGE,iCAAAA,iBAAAA,CAAiB,WAAW;GAC/B,UAAU,CAAC,GAAI,YAAY,YAAY,CAAC,CAAE;GAC1C,IAAI,aAAkD;IAAE,OAAO,CAAC,GAAI,YAAY,cAAc,CAAC,CAAE;GAAG;EACtG;CACF;AACF,CAAC"}

package/dist/extensions/server.d.mts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const serverPlugin: import("@agimon-ai/po-core/serverPlugin").PoServerPlugin;
+//#endregion
+export { serverPlugin as default };
+//# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAOa,wDAAY"}

package/dist/extensions/server.mjs

@@ -0,0 +1,85 @@
+import { n as PO_DB_FILE, t as createPoDb } from "../poDb-D6K38Gpu.mjs";
+import { t as PO_DB_CONTRACT } from "../contracts-Bv9-_vyc.mjs";
+import { composeRootHooks, composeRootInjects, defineRoot } from "@agimon-ai/po-core/extensionFile";
+import { PO_SERVER_SCOPE_SERVICE, composeServerProviderOverrides, defineServerPlugin, requirePoServerScope } from "@agimon-ai/po-core/serverPlugin";
+import path from "node:path";
+import { poHomeDirectory } from "@agimon-ai/po-core/piSettings";
+import { BACKGROUND_CONTEXT, PO_FS_SERVICE, PO_SQLITE_SERVICE, getOrThrow, nodeHost, requirePoFs, requirePoSqlite } from "@agimon-ai/po-core/platform";
+//#region src/extensions/(backend)/_lib/root.server.ts
+/**
+* The process's one Po database, `<po home>/db/po.sqlite`, bound as `po/db` at the global level.
+*
+* Only a global host with a home directory opens it. Workspaces and sessions resolve the global
+* binding through the server scope, so the process keeps a single connection: a second
+* connection would block the event loop while it waits on the first one's write lock.
+*/
+async function createPoDbGlobalRoot(plugin) {
+	const host = plugin.host;
+	const homeDirectory = host.context.homeDirectory;
+	if (host.scope !== "global" || homeDirectory === void 0) return { value: void 0 };
+	let handle;
+	const provider = plugin.context.inject([
+		PO_SERVER_SCOPE_SERVICE,
+		PO_FS_SERVICE,
+		PO_SQLITE_SERVICE
+	], async (injected) => {
+		if (handle === void 0) {
+			const directory = path.join(poHomeDirectory(homeDirectory, host.context.environment ?? {}), PO_DB_FILE[0]);
+			getOrThrow(await requirePoFs(injected).createDir(directory, { recursive: true }, BACKGROUND_CONTEXT));
+			await nodeHost.setMode(directory, 448);
+			const database = await requirePoSqlite(injected).open(path.join(directory, PO_DB_FILE[1]), BACKGROUND_CONTEXT);
+			handle = createPoDb({ database });
+		}
+		return requirePoServerScope(injected).provide(PO_DB_CONTRACT, handle);
+	});
+	await provider.await();
+	return {
+		value: handle,
+		onDispose: async () => {
+			await provider.dispose();
+			await handle?.close();
+		}
+	};
+}
+//#endregion
+//#region src/extensions/(backend)/root.server.ts
+var root_server_default = defineRoot(createPoDbGlobalRoot);
+//#endregion
+//#region generated/server.ts
+const serverPlugin = defineServerPlugin({
+	name: "@agimon-ai/po-db",
+	providerOverrides: composeServerProviderOverrides(root_server_default),
+	injects: composeRootInjects({
+		global: [root_server_default],
+		workspace: [root_server_default],
+		session: [root_server_default]
+	}),
+	global: async (context) => {
+		const scopeGlobal = await context.scopeRoot("global", root_server_default, context);
+		return {
+			...composeRootHooks(scopeGlobal),
+			services: [...scopeGlobal.services ?? []]
+		};
+	},
+	workspace: async (context) => {
+		const scopeGlobal = await context.scopeRoot("global", root_server_default, context);
+		return {
+			...composeRootHooks(scopeGlobal),
+			services: [...scopeGlobal.services ?? []]
+		};
+	},
+	session: async (context) => {
+		const scopeGlobal = await context.scopeRoot("global", root_server_default, context);
+		return {
+			...composeRootHooks(scopeGlobal),
+			services: [...scopeGlobal.services ?? []],
+			get activities() {
+				return [...scopeGlobal.activities ?? []];
+			}
+		};
+	}
+});
+//#endregion
+export { serverPlugin as default, serverPlugin };
+
+//# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":["rootGlobal"],"sources":["../../src/extensions/(backend)/_lib/root.server.ts","../../src/extensions/(backend)/root.server.ts","../../generated/server.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { RootDeclaration } from '@agimon-ai/po-core/extensionFile';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\nimport {\n  BACKGROUND_CONTEXT,\n  getOrThrow,\n  nodeHost,\n  PO_FS_SERVICE,\n  PO_SQLITE_SERVICE,\n  requirePoFs,\n  requirePoSqlite,\n} from '@agimon-ai/po-core/platform';\nimport {\n  PO_SERVER_SCOPE_SERVICE,\n  requirePoServerScope,\n  type PoServerPluginContext,\n} from '@agimon-ai/po-core/serverPlugin';\n\nimport { PO_DB_DIRECTORY_MODE, PO_DB_FILE } from '../../../constants/db';\nimport { PO_DB_CONTRACT } from '../../../schemas/contracts';\nimport { createPoDb } from '../../../services/poDb';\nimport type { PoDbHandle } from '../../../services/poDb/type';\n\n/**\n * The process's one Po database, `<po home>/db/po.sqlite`, bound as `po/db` at the global level.\n *\n * Only a global host with a home directory opens it. Workspaces and sessions resolve the global\n * binding through the server scope, so the process keeps a single connection: a second\n * connection would block the event loop while it waits on the first one's write lock.\n */\nexport async function createPoDbGlobalRoot(\n  plugin: PoServerPluginContext,\n): Promise<RootDeclaration<PoDbHandle | undefined, PoServerPluginContext>> {\n  const host = plugin.host;\n  const homeDirectory = host.context.homeDirectory;\n  if (host.scope !== 'global' || homeDirectory === undefined) return { value: undefined };\n  let handle: PoDbHandle | undefined;\n  const provider = plugin.context.inject(\n    [PO_SERVER_SCOPE_SERVICE, PO_FS_SERVICE, PO_SQLITE_SERVICE],\n    async (injected) => {\n      // The handle owns its file for the life of the mount; a re-run of this fiber only publishes it again.\n      if (handle === undefined) {\n        const directory = path.join(poHomeDirectory(homeDirectory, host.context.environment ?? {}), PO_DB_FILE[0]);\n        getOrThrow(await requirePoFs(injected).createDir(directory, { recursive: true }, BACKGROUND_CONTEXT));\n        await nodeHost.setMode(directory, PO_DB_DIRECTORY_MODE);\n        const database = await requirePoSqlite(injected).open(path.join(directory, PO_DB_FILE[1]), BACKGROUND_CONTEXT);\n        handle = createPoDb({ database });\n      }\n      return requirePoServerScope(injected).provide(PO_DB_CONTRACT, handle);\n    },\n  );\n  await provider.await();\n  return {\n    value: handle,\n    onDispose: async () => {\n      await provider.dispose();\n      await handle?.close();\n    },\n  };\n}\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\n\nimport { createPoDbGlobalRoot } from './_lib/root.server';\n\nexport default defineRoot(createPoDbGlobalRoot);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverPlugin';\nimport { composeRootHooks, composeRootInjects } from '@agimon-ai/po-core/extensionFile';\n\nimport rootGlobal from '../src/extensions/(backend)/root.server';\n\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-db',\n  providerOverrides: composeServerProviderOverrides(rootGlobal),\n  injects: composeRootInjects({ global: [rootGlobal], workspace: [rootGlobal], session: [rootGlobal] }),\n  global: async (context) => {\n    const scopeGlobal = await context.scopeRoot('global', rootGlobal, context);\n    return {\n      ...composeRootHooks(scopeGlobal),\n      services: [...(scopeGlobal.services ?? [])],\n    };\n  },\n  workspace: async (context) => {\n    const scopeGlobal = await context.scopeRoot('global', rootGlobal, context);\n    return {\n      ...composeRootHooks(scopeGlobal),\n      services: [...(scopeGlobal.services ?? [])],\n    };\n  },\n  session: async (context) => {\n    const scopeGlobal = await context.scopeRoot('global', rootGlobal, context);\n    return {\n      ...composeRootHooks(scopeGlobal),\n      services: [...(scopeGlobal.services ?? [])],\n      get activities(): PoServerSessionPlugin['activities'] { return [...(scopeGlobal.activities ?? [])]; },\n    };\n  },\n});\n\nexport default serverPlugin;\n"],"mappings":";;;;;;;;;;;;;;;AA+BA,eAAsB,qBACpB,QACyE;CACzE,MAAM,OAAO,OAAO;CACpB,MAAM,gBAAgB,KAAK,QAAQ;CACnC,IAAI,KAAK,UAAU,YAAY,kBAAkB,KAAA,GAAW,OAAO,EAAE,OAAO,KAAA,EAAU;CACtF,IAAI;CACJ,MAAM,WAAW,OAAO,QAAQ,OAC9B;EAAC;EAAyB;EAAe;CAAiB,GAC1D,OAAO,aAAa;EAElB,IAAI,WAAW,KAAA,GAAW;GACxB,MAAM,YAAY,KAAK,KAAK,gBAAgB,eAAe,KAAK,QAAQ,eAAe,CAAC,CAAC,GAAG,WAAW,EAAE;GACzG,WAAW,MAAM,YAAY,QAAQ,CAAC,CAAC,UAAU,WAAW,EAAE,WAAW,KAAK,GAAG,kBAAkB,CAAC;GACpG,MAAM,SAAS,QAAQ,WAAA,GAA+B;GACtD,MAAM,WAAW,MAAM,gBAAgB,QAAQ,CAAC,CAAC,KAAK,KAAK,KAAK,WAAW,WAAW,EAAE,GAAG,kBAAkB;GAC7G,SAAS,WAAW,EAAE,SAAS,CAAC;EAClC;EACA,OAAO,qBAAqB,QAAQ,CAAC,CAAC,QAAQ,gBAAgB,MAAM;CACtE,CACF;CACA,MAAM,SAAS,MAAM;CACrB,OAAO;EACL,OAAO;EACP,WAAW,YAAY;GACrB,MAAM,SAAS,QAAQ;GACvB,MAAM,QAAQ,MAAM;EACtB;CACF;AACF;;;ACxDA,IAAA,sBAAe,WAAW,oBAAoB;;;ACG9C,MAAa,eAAe,mBAAmB;CAC7C,MAAM;CACN,mBAAmB,+BAA+BA,mBAAU;CAC5D,SAAS,mBAAmB;EAAE,QAAQ,CAACA,mBAAU;EAAG,WAAW,CAACA,mBAAU;EAAG,SAAS,CAACA,mBAAU;CAAE,CAAC;CACpG,QAAQ,OAAO,YAAY;EACzB,MAAM,cAAc,MAAM,QAAQ,UAAU,UAAUA,qBAAY,OAAO;EACzE,OAAO;GACL,GAAG,iBAAiB,WAAW;GAC/B,UAAU,CAAC,GAAI,YAAY,YAAY,CAAC,CAAE;EAC5C;CACF;CACA,WAAW,OAAO,YAAY;EAC5B,MAAM,cAAc,MAAM,QAAQ,UAAU,UAAUA,qBAAY,OAAO;EACzE,OAAO;GACL,GAAG,iBAAiB,WAAW;GAC/B,UAAU,CAAC,GAAI,YAAY,YAAY,CAAC,CAAE;EAC5C;CACF;CACA,SAAS,OAAO,YAAY;EAC1B,MAAM,cAAc,MAAM,QAAQ,UAAU,UAAUA,qBAAY,OAAO;EACzE,OAAO;GACL,GAAG,iBAAiB,WAAW;GAC/B,UAAU,CAAC,GAAI,YAAY,YAAY,CAAC,CAAE;GAC1C,IAAI,aAAkD;IAAE,OAAO,CAAC,GAAI,YAAY,cAAc,CAAC,CAAE;GAAG;EACtG;CACF;AACF,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_poDb = require("./poDb-BKBXJbTa.cjs");
+const require_contracts = require("./contracts-C9sToxiM.cjs");
+exports.PO_DB_CONTRACT = require_contracts.PO_DB_CONTRACT;
+exports.PO_DB_FILE = require_poDb.PO_DB_FILE;
+exports.PO_DB_SERVICE = require_poDb.PO_DB_SERVICE;
+exports.createPoDb = require_poDb.createPoDb;
+exports.requirePoDb = require_contracts.requirePoDb;

package/dist/index.d.mts

@@ -0,0 +1,23 @@
+import { i as PoDbMigration, n as PoDb, r as PoDbHandle, t as CreatePoDbOptions } from "./type-DK6mNMz9.mjs";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/constants/db.d.ts
+export declare const PO_DB_SERVICE = "po/db";
+/** The database file, as path segments under the Po home. */
+export declare const PO_DB_FILE: readonly ['db', 'po.sqlite'];
+//#endregion
+//#region src/schemas/contracts.d.ts
+/** Bound once at the global level; every workspace and session resolves the same connection. */
+export declare const PO_DB_CONTRACT: import("@agimon-ai/po-core/serverPlugin").PoServiceContract<PoDb>;
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'po/db': PoDb;
+  }
+}
+/** The shared database, for a caller that injected `po/db`; throws when no global root bound one. */
+export declare function requirePoDb(context: Context): PoDb;
+//#endregion
+//#region src/services/poDb/index.d.ts
+export declare function createPoDb(options: CreatePoDbOptions): PoDbHandle;
+//#endregion
+export type { CreatePoDbOptions, PoDb, PoDbHandle, PoDbMigration };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/constants/db.ts","../src/schemas/contracts.ts","../src/services/poDb/index.ts"],"mappings":";;;qBAAa;;qBAEA;;;;qBCKA,0DAAc,kBAAA;;YAGf;IACR,SAAS;;;;wBAKG,YAAY,SAAS,UAAU;;;wBCyD/B,WAAW,SAAS,oBAAoB"}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { n as PO_DB_FILE, r as PO_DB_SERVICE, t as createPoDb } from "./poDb-D6K38Gpu.mjs";
+import { n as requirePoDb, t as PO_DB_CONTRACT } from "./contracts-Bv9-_vyc.mjs";
+export { PO_DB_CONTRACT, PO_DB_FILE, PO_DB_SERVICE, createPoDb, requirePoDb };

package/dist/poDb-BKBXJbTa.cjs

@@ -0,0 +1,93 @@
+let _earendil_works_chord_sqlite = require("@earendil-works/chord/sqlite");
+//#region src/constants/db.ts
+const PO_DB_SERVICE = "po/db";
+/** The database file, as path segments under the Po home. */
+const PO_DB_FILE = ["db", "po.sqlite"];
+/** A table prefix: lowercase words joined by single underscores, never sqlite's own namespace. */
+const PO_DB_PREFIX_PATTERN = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/u;
+//#endregion
+//#region src/services/poDb/index.ts
+/** sqlite names its own automatic indexes `sqlite_autoindex_*`; nobody owns those. */
+const SQLITE_INTERNAL = "sqlite_";
+function assertPrefix(prefix) {
+	if (prefix.length > 48 || !PO_DB_PREFIX_PATTERN.test(prefix) || prefix === "sqlite" || prefix.startsWith(SQLITE_INTERNAL)) throw new Error(`Invalid po-db table prefix ${JSON.stringify(prefix)}.`);
+}
+async function schemaNames(executor) {
+	const rows = await executor.all("SELECT type, name FROM sqlite_master");
+	return new Set(rows.map((row) => `${row.type}\0${row.name}`));
+}
+/**
+* A view of the shared connection that cannot close it.
+*
+* Consumers such as the calendar store call `close()` on the database they were given. One
+* connection serves every package in the process, so only the owning handle may end it.
+*/
+function sharedView(database) {
+	return {
+		exec: (sql) => database.exec(sql),
+		run: (sql, ...params) => database.run(sql, ...params),
+		get: (sql, ...params) => database.get(sql, ...params),
+		all: (sql, ...params) => database.all(sql, ...params),
+		transaction: (callback) => database.transaction(callback),
+		close: async () => void 0
+	};
+}
+/**
+* Runs chord's migrator with every transaction it opens checking the schema it leaves.
+*
+* The check runs inside the migration's own transaction, so a migration that creates an
+* object outside its prefix rolls back with everything else it did.
+*/
+function prefixGuarded(database, prefix) {
+	const owned = `${prefix}_`;
+	return {
+		...sharedView(database),
+		transaction: (callback) => database.transaction(async (transaction) => {
+			const before = await schemaNames(transaction);
+			const result = await callback(transaction);
+			for (const entry of await schemaNames(transaction)) {
+				if (before.has(entry)) continue;
+				const [type, name = ""] = entry.split("\0");
+				if (name.startsWith(owned) || name.startsWith(SQLITE_INTERNAL)) continue;
+				throw new Error(`po-db migration for ${JSON.stringify(prefix)} created ${type} ${JSON.stringify(name)} outside its prefix.`);
+			}
+			return result;
+		})
+	};
+}
+function createPoDb(options) {
+	const { database } = options;
+	let closing;
+	return {
+		database: sharedView(database),
+		async migrate(prefix, migrations) {
+			assertPrefix(prefix);
+			await (0, _earendil_works_chord_sqlite.applySqliteMigrations)(prefixGuarded(database, prefix), migrations, { table: `${prefix}_migrations` });
+		},
+		close() {
+			closing ??= database.close();
+			return closing;
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "PO_DB_FILE", {
+	enumerable: true,
+	get: function() {
+		return PO_DB_FILE;
+	}
+});
+Object.defineProperty(exports, "PO_DB_SERVICE", {
+	enumerable: true,
+	get: function() {
+		return PO_DB_SERVICE;
+	}
+});
+Object.defineProperty(exports, "createPoDb", {
+	enumerable: true,
+	get: function() {
+		return createPoDb;
+	}
+});
+
+//# sourceMappingURL=poDb-BKBXJbTa.cjs.map

package/dist/poDb-BKBXJbTa.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"poDb-BKBXJbTa.cjs","names":["applySqliteMigrations"],"sources":["../src/constants/db.ts","../src/services/poDb/index.ts"],"sourcesContent":["export const PO_DB_SERVICE = 'po/db';\n/** The database file, as path segments under the Po home. */\nexport const PO_DB_FILE = ['db', 'po.sqlite'] as const;\n/** Owner-only: the folder holds every package's rows, secrets included. */\nexport const PO_DB_DIRECTORY_MODE = 0o700;\n/** A table prefix: lowercase words joined by single underscores, never sqlite's own namespace. */\nexport const PO_DB_PREFIX_PATTERN = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/u;\nexport const PO_DB_PREFIX_MAX_LENGTH = 48;\n","import { applySqliteMigrations, type SqliteDatabase, type SqliteExecutor } from '@earendil-works/chord/sqlite';\n\nimport { PO_DB_PREFIX_MAX_LENGTH, PO_DB_PREFIX_PATTERN } from '../../constants/db';\nimport type { CreatePoDbOptions, PoDbHandle, PoDbMigration } from './type';\n\ninterface SchemaObject {\n  readonly type: string;\n  readonly name: string;\n}\n\n/** sqlite names its own automatic indexes `sqlite_autoindex_*`; nobody owns those. */\nconst SQLITE_INTERNAL = 'sqlite_';\n\nfunction assertPrefix(prefix: string): void {\n  if (\n    prefix.length > PO_DB_PREFIX_MAX_LENGTH ||\n    !PO_DB_PREFIX_PATTERN.test(prefix) ||\n    prefix === 'sqlite' ||\n    prefix.startsWith(SQLITE_INTERNAL)\n  ) {\n    throw new Error(`Invalid po-db table prefix ${JSON.stringify(prefix)}.`);\n  }\n}\n\nasync function schemaNames(executor: SqliteExecutor): Promise<Set<string>> {\n  const rows = await executor.all<SchemaObject>('SELECT type, name FROM sqlite_master');\n  return new Set(rows.map((row) => `${row.type}\\0${row.name}`));\n}\n\n/**\n * A view of the shared connection that cannot close it.\n *\n * Consumers such as the calendar store call `close()` on the database they were given. One\n * connection serves every package in the process, so only the owning handle may end it.\n */\nfunction sharedView(database: SqliteDatabase): SqliteDatabase {\n  return {\n    exec: (sql) => database.exec(sql),\n    run: (sql, ...params) => database.run(sql, ...params),\n    get: (sql, ...params) => database.get(sql, ...params),\n    all: (sql, ...params) => database.all(sql, ...params),\n    transaction: (callback) => database.transaction(callback),\n    close: async () => undefined,\n  };\n}\n\n/**\n * Runs chord's migrator with every transaction it opens checking the schema it leaves.\n *\n * The check runs inside the migration's own transaction, so a migration that creates an\n * object outside its prefix rolls back with everything else it did.\n */\nfunction prefixGuarded(database: SqliteDatabase, prefix: string): SqliteDatabase {\n  const owned = `${prefix}_`;\n  return {\n    ...sharedView(database),\n    transaction: (callback) =>\n      database.transaction(async (transaction) => {\n        const before = await schemaNames(transaction);\n        const result = await callback(transaction);\n        for (const entry of await schemaNames(transaction)) {\n          if (before.has(entry)) continue;\n          const [type, name = ''] = entry.split('\\0');\n          if (name.startsWith(owned) || name.startsWith(SQLITE_INTERNAL)) continue;\n          throw new Error(\n            `po-db migration for ${JSON.stringify(prefix)} created ${type} ${JSON.stringify(name)} outside its prefix.`,\n          );\n        }\n        return result;\n      }),\n  };\n}\n\nexport function createPoDb(options: CreatePoDbOptions): PoDbHandle {\n  const { database } = options;\n  let closing: Promise<void> | undefined;\n  return {\n    database: sharedView(database),\n    async migrate(prefix: string, migrations: readonly PoDbMigration[]): Promise<void> {\n      assertPrefix(prefix);\n      await applySqliteMigrations(prefixGuarded(database, prefix), migrations, { table: `${prefix}_migrations` });\n    },\n    close(): Promise<void> {\n      closing ??= database.close();\n      return closing;\n    },\n  };\n}\n"],"mappings":";;AAAA,MAAa,gBAAgB;;AAE7B,MAAa,aAAa,CAAC,MAAM,WAAW;;AAI5C,MAAa,uBAAuB;;;;ACKpC,MAAM,kBAAkB;AAExB,SAAS,aAAa,QAAsB;CAC1C,IACE,OAAO,SAAA,MACP,CAAC,qBAAqB,KAAK,MAAM,KACjC,WAAW,YACX,OAAO,WAAW,eAAe,GAEjC,MAAM,IAAI,MAAM,8BAA8B,KAAK,UAAU,MAAM,EAAE,EAAE;AAE3E;AAEA,eAAe,YAAY,UAAgD;CACzE,MAAM,OAAO,MAAM,SAAS,IAAkB,sCAAsC;CACpF,OAAO,IAAI,IAAI,KAAK,KAAK,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC;AAC9D;;;;;;;AAQA,SAAS,WAAW,UAA0C;CAC5D,OAAO;EACL,OAAO,QAAQ,SAAS,KAAK,GAAG;EAChC,MAAM,KAAK,GAAG,WAAW,SAAS,IAAI,KAAK,GAAG,MAAM;EACpD,MAAM,KAAK,GAAG,WAAW,SAAS,IAAI,KAAK,GAAG,MAAM;EACpD,MAAM,KAAK,GAAG,WAAW,SAAS,IAAI,KAAK,GAAG,MAAM;EACpD,cAAc,aAAa,SAAS,YAAY,QAAQ;EACxD,OAAO,YAAY,KAAA;CACrB;AACF;;;;;;;AAQA,SAAS,cAAc,UAA0B,QAAgC;CAC/E,MAAM,QAAQ,GAAG,OAAO;CACxB,OAAO;EACL,GAAG,WAAW,QAAQ;EACtB,cAAc,aACZ,SAAS,YAAY,OAAO,gBAAgB;GAC1C,MAAM,SAAS,MAAM,YAAY,WAAW;GAC5C,MAAM,SAAS,MAAM,SAAS,WAAW;GACzC,KAAK,MAAM,SAAS,MAAM,YAAY,WAAW,GAAG;IAClD,IAAI,OAAO,IAAI,KAAK,GAAG;IACvB,MAAM,CAAC,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI;IAC1C,IAAI,KAAK,WAAW,KAAK,KAAK,KAAK,WAAW,eAAe,GAAG;IAChE,MAAM,IAAI,MACR,uBAAuB,KAAK,UAAU,MAAM,EAAE,WAAW,KAAK,GAAG,KAAK,UAAU,IAAI,EAAE,qBACxF;GACF;GACA,OAAO;EACT,CAAC;CACL;AACF;AAEA,SAAgB,WAAW,SAAwC;CACjE,MAAM,EAAE,aAAa;CACrB,IAAI;CACJ,OAAO;EACL,UAAU,WAAW,QAAQ;EAC7B,MAAM,QAAQ,QAAgB,YAAqD;GACjF,aAAa,MAAM;GACnB,OAAA,GAAMA,6BAAAA,sBAAAA,CAAsB,cAAc,UAAU,MAAM,GAAG,YAAY,EAAE,OAAO,GAAG,OAAO,aAAa,CAAC;EAC5G;EACA,QAAuB;GACrB,YAAY,SAAS,MAAM;GAC3B,OAAO;EACT;CACF;AACF"}

package/dist/poDb-D6K38Gpu.mjs

@@ -0,0 +1,76 @@
+import { applySqliteMigrations } from "@earendil-works/chord/sqlite";
+//#region src/constants/db.ts
+const PO_DB_SERVICE = "po/db";
+/** The database file, as path segments under the Po home. */
+const PO_DB_FILE = ["db", "po.sqlite"];
+/** A table prefix: lowercase words joined by single underscores, never sqlite's own namespace. */
+const PO_DB_PREFIX_PATTERN = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/u;
+//#endregion
+//#region src/services/poDb/index.ts
+/** sqlite names its own automatic indexes `sqlite_autoindex_*`; nobody owns those. */
+const SQLITE_INTERNAL = "sqlite_";
+function assertPrefix(prefix) {
+	if (prefix.length > 48 || !PO_DB_PREFIX_PATTERN.test(prefix) || prefix === "sqlite" || prefix.startsWith(SQLITE_INTERNAL)) throw new Error(`Invalid po-db table prefix ${JSON.stringify(prefix)}.`);
+}
+async function schemaNames(executor) {
+	const rows = await executor.all("SELECT type, name FROM sqlite_master");
+	return new Set(rows.map((row) => `${row.type}\0${row.name}`));
+}
+/**
+* A view of the shared connection that cannot close it.
+*
+* Consumers such as the calendar store call `close()` on the database they were given. One
+* connection serves every package in the process, so only the owning handle may end it.
+*/
+function sharedView(database) {
+	return {
+		exec: (sql) => database.exec(sql),
+		run: (sql, ...params) => database.run(sql, ...params),
+		get: (sql, ...params) => database.get(sql, ...params),
+		all: (sql, ...params) => database.all(sql, ...params),
+		transaction: (callback) => database.transaction(callback),
+		close: async () => void 0
+	};
+}
+/**
+* Runs chord's migrator with every transaction it opens checking the schema it leaves.
+*
+* The check runs inside the migration's own transaction, so a migration that creates an
+* object outside its prefix rolls back with everything else it did.
+*/
+function prefixGuarded(database, prefix) {
+	const owned = `${prefix}_`;
+	return {
+		...sharedView(database),
+		transaction: (callback) => database.transaction(async (transaction) => {
+			const before = await schemaNames(transaction);
+			const result = await callback(transaction);
+			for (const entry of await schemaNames(transaction)) {
+				if (before.has(entry)) continue;
+				const [type, name = ""] = entry.split("\0");
+				if (name.startsWith(owned) || name.startsWith(SQLITE_INTERNAL)) continue;
+				throw new Error(`po-db migration for ${JSON.stringify(prefix)} created ${type} ${JSON.stringify(name)} outside its prefix.`);
+			}
+			return result;
+		})
+	};
+}
+function createPoDb(options) {
+	const { database } = options;
+	let closing;
+	return {
+		database: sharedView(database),
+		async migrate(prefix, migrations) {
+			assertPrefix(prefix);
+			await applySqliteMigrations(prefixGuarded(database, prefix), migrations, { table: `${prefix}_migrations` });
+		},
+		close() {
+			closing ??= database.close();
+			return closing;
+		}
+	};
+}
+//#endregion
+export { PO_DB_FILE as n, PO_DB_SERVICE as r, createPoDb as t };
+
+//# sourceMappingURL=poDb-D6K38Gpu.mjs.map

package/dist/poDb-D6K38Gpu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"poDb-D6K38Gpu.mjs","names":[],"sources":["../src/constants/db.ts","../src/services/poDb/index.ts"],"sourcesContent":["export const PO_DB_SERVICE = 'po/db';\n/** The database file, as path segments under the Po home. */\nexport const PO_DB_FILE = ['db', 'po.sqlite'] as const;\n/** Owner-only: the folder holds every package's rows, secrets included. */\nexport const PO_DB_DIRECTORY_MODE = 0o700;\n/** A table prefix: lowercase words joined by single underscores, never sqlite's own namespace. */\nexport const PO_DB_PREFIX_PATTERN = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/u;\nexport const PO_DB_PREFIX_MAX_LENGTH = 48;\n","import { applySqliteMigrations, type SqliteDatabase, type SqliteExecutor } from '@earendil-works/chord/sqlite';\n\nimport { PO_DB_PREFIX_MAX_LENGTH, PO_DB_PREFIX_PATTERN } from '../../constants/db';\nimport type { CreatePoDbOptions, PoDbHandle, PoDbMigration } from './type';\n\ninterface SchemaObject {\n  readonly type: string;\n  readonly name: string;\n}\n\n/** sqlite names its own automatic indexes `sqlite_autoindex_*`; nobody owns those. */\nconst SQLITE_INTERNAL = 'sqlite_';\n\nfunction assertPrefix(prefix: string): void {\n  if (\n    prefix.length > PO_DB_PREFIX_MAX_LENGTH ||\n    !PO_DB_PREFIX_PATTERN.test(prefix) ||\n    prefix === 'sqlite' ||\n    prefix.startsWith(SQLITE_INTERNAL)\n  ) {\n    throw new Error(`Invalid po-db table prefix ${JSON.stringify(prefix)}.`);\n  }\n}\n\nasync function schemaNames(executor: SqliteExecutor): Promise<Set<string>> {\n  const rows = await executor.all<SchemaObject>('SELECT type, name FROM sqlite_master');\n  return new Set(rows.map((row) => `${row.type}\\0${row.name}`));\n}\n\n/**\n * A view of the shared connection that cannot close it.\n *\n * Consumers such as the calendar store call `close()` on the database they were given. One\n * connection serves every package in the process, so only the owning handle may end it.\n */\nfunction sharedView(database: SqliteDatabase): SqliteDatabase {\n  return {\n    exec: (sql) => database.exec(sql),\n    run: (sql, ...params) => database.run(sql, ...params),\n    get: (sql, ...params) => database.get(sql, ...params),\n    all: (sql, ...params) => database.all(sql, ...params),\n    transaction: (callback) => database.transaction(callback),\n    close: async () => undefined,\n  };\n}\n\n/**\n * Runs chord's migrator with every transaction it opens checking the schema it leaves.\n *\n * The check runs inside the migration's own transaction, so a migration that creates an\n * object outside its prefix rolls back with everything else it did.\n */\nfunction prefixGuarded(database: SqliteDatabase, prefix: string): SqliteDatabase {\n  const owned = `${prefix}_`;\n  return {\n    ...sharedView(database),\n    transaction: (callback) =>\n      database.transaction(async (transaction) => {\n        const before = await schemaNames(transaction);\n        const result = await callback(transaction);\n        for (const entry of await schemaNames(transaction)) {\n          if (before.has(entry)) continue;\n          const [type, name = ''] = entry.split('\\0');\n          if (name.startsWith(owned) || name.startsWith(SQLITE_INTERNAL)) continue;\n          throw new Error(\n            `po-db migration for ${JSON.stringify(prefix)} created ${type} ${JSON.stringify(name)} outside its prefix.`,\n          );\n        }\n        return result;\n      }),\n  };\n}\n\nexport function createPoDb(options: CreatePoDbOptions): PoDbHandle {\n  const { database } = options;\n  let closing: Promise<void> | undefined;\n  return {\n    database: sharedView(database),\n    async migrate(prefix: string, migrations: readonly PoDbMigration[]): Promise<void> {\n      assertPrefix(prefix);\n      await applySqliteMigrations(prefixGuarded(database, prefix), migrations, { table: `${prefix}_migrations` });\n    },\n    close(): Promise<void> {\n      closing ??= database.close();\n      return closing;\n    },\n  };\n}\n"],"mappings":";;AAAA,MAAa,gBAAgB;;AAE7B,MAAa,aAAa,CAAC,MAAM,WAAW;;AAI5C,MAAa,uBAAuB;;;;ACKpC,MAAM,kBAAkB;AAExB,SAAS,aAAa,QAAsB;CAC1C,IACE,OAAO,SAAA,MACP,CAAC,qBAAqB,KAAK,MAAM,KACjC,WAAW,YACX,OAAO,WAAW,eAAe,GAEjC,MAAM,IAAI,MAAM,8BAA8B,KAAK,UAAU,MAAM,EAAE,EAAE;AAE3E;AAEA,eAAe,YAAY,UAAgD;CACzE,MAAM,OAAO,MAAM,SAAS,IAAkB,sCAAsC;CACpF,OAAO,IAAI,IAAI,KAAK,KAAK,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC;AAC9D;;;;;;;AAQA,SAAS,WAAW,UAA0C;CAC5D,OAAO;EACL,OAAO,QAAQ,SAAS,KAAK,GAAG;EAChC,MAAM,KAAK,GAAG,WAAW,SAAS,IAAI,KAAK,GAAG,MAAM;EACpD,MAAM,KAAK,GAAG,WAAW,SAAS,IAAI,KAAK,GAAG,MAAM;EACpD,MAAM,KAAK,GAAG,WAAW,SAAS,IAAI,KAAK,GAAG,MAAM;EACpD,cAAc,aAAa,SAAS,YAAY,QAAQ;EACxD,OAAO,YAAY,KAAA;CACrB;AACF;;;;;;;AAQA,SAAS,cAAc,UAA0B,QAAgC;CAC/E,MAAM,QAAQ,GAAG,OAAO;CACxB,OAAO;EACL,GAAG,WAAW,QAAQ;EACtB,cAAc,aACZ,SAAS,YAAY,OAAO,gBAAgB;GAC1C,MAAM,SAAS,MAAM,YAAY,WAAW;GAC5C,MAAM,SAAS,MAAM,SAAS,WAAW;GACzC,KAAK,MAAM,SAAS,MAAM,YAAY,WAAW,GAAG;IAClD,IAAI,OAAO,IAAI,KAAK,GAAG;IACvB,MAAM,CAAC,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI;IAC1C,IAAI,KAAK,WAAW,KAAK,KAAK,KAAK,WAAW,eAAe,GAAG;IAChE,MAAM,IAAI,MACR,uBAAuB,KAAK,UAAU,MAAM,EAAE,WAAW,KAAK,GAAG,KAAK,UAAU,IAAI,EAAE,qBACxF;GACF;GACA,OAAO;EACT,CAAC;CACL;AACF;AAEA,SAAgB,WAAW,SAAwC;CACjE,MAAM,EAAE,aAAa;CACrB,IAAI;CACJ,OAAO;EACL,UAAU,WAAW,QAAQ;EAC7B,MAAM,QAAQ,QAAgB,YAAqD;GACjF,aAAa,MAAM;GACnB,MAAM,sBAAsB,cAAc,UAAU,MAAM,GAAG,YAAY,EAAE,OAAO,GAAG,OAAO,aAAa,CAAC;EAC5G;EACA,QAAuB;GACrB,YAAY,SAAS,MAAM;GAC3B,OAAO;EACT;CACF;AACF"}

package/dist/testing.cjs

@@ -0,0 +1,16 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_poDb = require("./poDb-BKBXJbTa.cjs");
+let _earendil_works_chord_sqlite_node = require("@earendil-works/chord/sqlite/node");
+//#region src/services/testPoDb/index.ts
+/**
+* A po-db on its own Node connection, for tests: in memory by default, or at `file`, which
+* lets several processes share one database the way two Po processes share `po.sqlite`.
+* Node only.
+*/
+async function createTestPoDb(file = ":memory:") {
+	return require_poDb.createPoDb({ database: await (0, _earendil_works_chord_sqlite_node.openNodeSqliteDatabase)(file) });
+}
+//#endregion
+exports.createTestPoDb = createTestPoDb;
+
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.cjs","names":["createPoDb","openNodeSqliteDatabase"],"sources":["../src/services/testPoDb/index.ts"],"sourcesContent":["import { openNodeSqliteDatabase } from '@earendil-works/chord/sqlite/node';\n\nimport { createPoDb } from '../poDb';\nimport type { PoDbHandle } from '../poDb/type';\n\n/**\n * A po-db on its own Node connection, for tests: in memory by default, or at `file`, which\n * lets several processes share one database the way two Po processes share `po.sqlite`.\n * Node only.\n */\nexport async function createTestPoDb(file = ':memory:'): Promise<PoDbHandle> {\n  return createPoDb({ database: await openNodeSqliteDatabase(file) });\n}\n"],"mappings":";;;;;;;;;AAUA,eAAsB,eAAe,OAAO,YAAiC;CAC3E,OAAOA,aAAAA,WAAW,EAAE,UAAU,OAAA,GAAMC,kCAAAA,uBAAAA,CAAuB,IAAI,EAAE,CAAC;AACpE"}

package/dist/testing.d.mts

@@ -0,0 +1,10 @@
+import { r as PoDbHandle } from "./type-DK6mNMz9.mjs";
+//#region src/services/testPoDb/index.d.ts
+/**
+ * A po-db on its own Node connection, for tests: in memory by default, or at `file`, which
+ * lets several processes share one database the way two Po processes share `po.sqlite`.
+ * Node only.
+ */
+export declare function createTestPoDb(file?: string): Promise<PoDbHandle>;
+//#endregion
+//# sourceMappingURL=testing.d.mts.map

package/dist/testing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.mts","names":[],"sources":["../src/services/testPoDb/index.ts"],"mappings":";;;;;;;wBAUsB,eAAe,gBAAoB,QAAQ"}

package/dist/testing.mjs

@@ -0,0 +1,15 @@
+import { t as createPoDb } from "./poDb-D6K38Gpu.mjs";
+import { openNodeSqliteDatabase } from "@earendil-works/chord/sqlite/node";
+//#region src/services/testPoDb/index.ts
+/**
+* A po-db on its own Node connection, for tests: in memory by default, or at `file`, which
+* lets several processes share one database the way two Po processes share `po.sqlite`.
+* Node only.
+*/
+async function createTestPoDb(file = ":memory:") {
+	return createPoDb({ database: await openNodeSqliteDatabase(file) });
+}
+//#endregion
+export { createTestPoDb };
+
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.mjs","names":[],"sources":["../src/services/testPoDb/index.ts"],"sourcesContent":["import { openNodeSqliteDatabase } from '@earendil-works/chord/sqlite/node';\n\nimport { createPoDb } from '../poDb';\nimport type { PoDbHandle } from '../poDb/type';\n\n/**\n * A po-db on its own Node connection, for tests: in memory by default, or at `file`, which\n * lets several processes share one database the way two Po processes share `po.sqlite`.\n * Node only.\n */\nexport async function createTestPoDb(file = ':memory:'): Promise<PoDbHandle> {\n  return createPoDb({ database: await openNodeSqliteDatabase(file) });\n}\n"],"mappings":";;;;;;;;AAUA,eAAsB,eAAe,OAAO,YAAiC;CAC3E,OAAO,WAAW,EAAE,UAAU,MAAM,uBAAuB,IAAI,EAAE,CAAC;AACpE"}

package/dist/type-DK6mNMz9.d.mts

@@ -0,0 +1,30 @@
+import { SqliteDatabase } from "@earendil-works/chord/sqlite";
+//#region src/services/poDb/type.d.ts
+/** One schema step a package owns: applied once, in version order, inside one transaction. */
+interface PoDbMigration {
+  readonly version: number;
+  readonly statements: readonly string[];
+}
+/**
+ * The process's shared Po database.
+ *
+ * Every package that keeps rows here owns one table prefix: its tables, indexes, views and
+ * triggers all start with `<prefix>_`, and its schema version lives in `<prefix>_migrations`.
+ */
+interface PoDb {
+  /** The process's shared connection. `close()` is a no-op; no PRAGMA, no ATTACH, no paths. */
+  readonly database: SqliteDatabase;
+  /** Applies migrations in `<prefix>_migrations`; every new table and index must start with `<prefix>_`. */
+  migrate(prefix: string, migrations: readonly PoDbMigration[]): Promise<void>;
+}
+/** The owner's view: only the root that opened the connection closes it. */
+interface PoDbHandle extends PoDb {
+  close(): Promise<void>;
+}
+interface CreatePoDbOptions {
+  /** The connection the handle owns. Its `close` runs once, from the handle. */
+  readonly database: SqliteDatabase;
+}
+//#endregion
+export { PoDbMigration as i, PoDb as n, PoDbHandle as r, CreatePoDbOptions as t };
+//# sourceMappingURL=type-DK6mNMz9.d.mts.map

package/dist/type-DK6mNMz9.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-DK6mNMz9.d.mts","names":[],"sources":["../src/services/poDb/type.ts"],"mappings":";;;UAGiB;WACN;WACA;;;;;;;;UASM;;WAEN,UAAU;;EAEnB,QAAQ,gBAAgB,qBAAqB,kBAAkB;;;UAIhD,mBAAmB;EAClC,SAAS;;UAGM;;WAEN,UAAU"}

package/llms.txt

@@ -0,0 +1,7 @@
+# @agimon-ai/po-db
+
+One shared sqlite database, `<po home>/db/po.sqlite`, bound as the global `po/db` service for the Po packages that keep rows.
+
+## Resources
+
+- [Package README](./README.md): the shared connection, the table prefix rule, migrations, and the test helper.

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@agimon-ai/po-db",
+  "version": "0.0.0-alpha.61",
+  "description": "One shared sqlite database for the Po packages that need one",
+  "keywords": [
+    "ai",
+    "coding-agent",
+    "database",
+    "developer-tools",
+    "po",
+    "sqlite",
+    "typescript"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/po/issues"
+  },
+  "license": "BUSL-1.1",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/po.git",
+    "directory": "packages/foundations/po-db"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./apiContracts": {
+      "types": "./dist/apiContracts.d.mts",
+      "import": "./dist/apiContracts.mjs",
+      "require": "./dist/apiContracts.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.mts",
+      "import": "./dist/testing.mjs",
+      "require": "./dist/testing.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agimon-ai/po-core": "0.0.0-alpha.61",
+    "@deepseek-ai/cordis": "4.0.5",
+    "@earendil-works/chord": "1.4.0"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.61",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.61",
+    "@types/node": "26.6.5",
+    "@vitest/coverage-v8": "5.0.4",
+    "tsdown": "0.23.1",
+    "typescript": "7.0.2",
+    "vitest": "5.0.4"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "global",
+      "workspace",
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsrs --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}