@effect-agent/storage-sqlite 0.1.0-beta.6 → 0.1.0-beta.61

package/dist/SqliteStorageError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStorageError.mjs","names":[],"sources":["../src/SqliteStorageError.ts"],"sourcesContent":["import { CanonicalSequence, ProducerEpoch } from \"@effect-agent/thread/Records\";\nimport { Schema } from \"effect\";\n\n/** The SQLite file uses a private-development format this adapter cannot read. */\nexport class SqliteStorageCompatibilityError extends Schema.TaggedError<SqliteStorageCompatibilityError>()(\n  \"SqliteStorageCompatibilityError\",\n  {\n    actualVersion: Schema.Int,\n    message: Schema.String,\n    supportedVersion: Schema.Int,\n  },\n) {}\n\n/** Stored bytes failed the current Schema and cannot be used as recovery truth. */\nexport class SqliteStorageCorruptionError extends Schema.TaggedError<SqliteStorageCorruptionError>()(\n  \"SqliteStorageCorruptionError\",\n  {\n    message: Schema.String,\n    rowKey: Schema.String,\n    table: Schema.String,\n  },\n) {}\n\n/** SQLite infrastructure failed while opening or operating the store. */\nexport class SqliteStorageError extends Schema.TaggedError<SqliteStorageError>()(\n  \"SqliteStorageError\",\n  {\n    cause: Schema.optionalKey(Schema.Defect()),\n    message: Schema.String,\n    operation: Schema.String,\n  },\n) {}\n\n/**\n * SQLite infrastructure failed while operating the Submission Ledger. Surfaces at the\n * SubmissionLedger port as the typed `LedgerError` with this error preserved as its cause,\n * so the adapter-level tag is never erased.\n */\nexport class SqliteLedgerError extends Schema.TaggedError<SqliteLedgerError>()(\n  \"SqliteLedgerError\",\n  {\n    cause: Schema.optionalKey(Schema.Defect()),\n    message: Schema.String,\n    operation: Schema.String,\n  },\n) {}\n\n/**\n * A canonical batch retry conflicts with existing append state. Tail conflicts carry the\n * actual committed tail as a diagnostic resume hint.\n */\nexport class SqliteAppendConflict extends Schema.TaggedError<SqliteAppendConflict>()(\n  \"SqliteAppendConflict\",\n  {\n    message: Schema.String,\n    reason: Schema.Literals([\"batch-digest\", \"record-identity\", \"tail\"]),\n    actualTailSequence: Schema.optionalKey(CanonicalSequence),\n    actualTailDigest: Schema.optionalKey(Schema.String),\n  },\n) {}\n\n/**\n * A producer epoch does not match the Thread's current writer registration. Appends\n * require the exact registered epoch, so both older and newer unregistered epochs are fenced;\n * a newer epoch takes over by materializing first.\n */\nexport class SqliteFenceRejected extends Schema.TaggedError<SqliteFenceRejected>()(\n  \"SqliteFenceRejected\",\n  {\n    actualEpoch: ProducerEpoch,\n    message: Schema.String,\n    producerEpoch: ProducerEpoch,\n  },\n) {}\n\n/**\n * A write transaction could not acquire the SQLite write lock within the configured busy\n * timeout (SQLITE_BUSY / SQLITE_LOCKED). Another transiently coexisting owner is writing;\n * the operation did not mutate canonical state and is safe to retry.\n */\nexport class SqliteWriteContention extends Schema.TaggedError<SqliteWriteContention>()(\n  \"SqliteWriteContention\",\n  {\n    cause: Schema.optionalKey(Schema.Defect()),\n    message: Schema.String,\n    operation: Schema.String,\n  },\n) {}\n\n/** A checkpoint conflicts with a previously stored checkpoint at the same offset. */\nexport class SqliteCheckpointConflict extends Schema.TaggedError<SqliteCheckpointConflict>()(\n  \"SqliteCheckpointConflict\",\n  {\n    message: Schema.String,\n  },\n) {}\n\nexport const SqliteStorageFailpointLocation = Schema.Literals([\n  \"upgrade:before-mutation\",\n  \"upgrade:after-mutation\",\n  \"upgrade:before-version\",\n  \"upgrade:after-version\",\n  \"materialize:before\",\n  \"materialize:after\",\n  \"append:before\",\n  \"append:after-batch-insert\",\n  \"append:after-record-insert\",\n  \"append:after-tail-update\",\n  \"append:after\",\n  \"export:after-thread-read\",\n  \"save-checkpoint:before\",\n  \"save-checkpoint:after\",\n  \"ledger:admit:before\",\n  \"ledger:admit:after\",\n  \"ledger:mark-ready:before\",\n  \"ledger:mark-ready:after\",\n  \"ledger:claim:before\",\n  \"ledger:claim:after\",\n  \"ledger:mark-input-applied:before\",\n  \"ledger:mark-input-applied:after\",\n  \"ledger:renew:before\",\n  \"ledger:renew:after\",\n  \"ledger:reserve-settlement:before\",\n  \"ledger:reserve-settlement:after\",\n  \"ledger:finalize-settlement:before\",\n  \"ledger:finalize-settlement:after\",\n  \"ledger:request-abort:before\",\n  \"ledger:request-abort:after\",\n  \"ledger:release:before\",\n  \"ledger:release:after\",\n  \"ledger:claim-joining:before\",\n  \"ledger:claim-joining:after\",\n  \"ledger:mark-joined:before\",\n  \"ledger:mark-joined:after\",\n  \"ledger:revert-joining:before\",\n  \"ledger:revert-joining:after\",\n  \"ledger:suspend:before\",\n  \"ledger:suspend:after\",\n  \"ledger:approval-decision:before\",\n  \"ledger:approval-decision:after\",\n  \"ledger:mark-unknown:before\",\n  \"ledger:mark-unknown:after\",\n  \"ledger:unknown-resolution:before\",\n  \"ledger:unknown-resolution:after\",\n  \"ledger:child-reservation:before\",\n  \"ledger:child-reservation:after\",\n  \"ledger:child-attach:before\",\n  \"ledger:child-attach:after\",\n  \"ledger:child-release-pending:before\",\n  \"ledger:child-release-pending:after\",\n  \"ledger:child-release:before\",\n  \"ledger:child-release:after\",\n  \"ledger:child-settled:before\",\n  \"ledger:child-settled:after\",\n]);\n\nexport type SqliteStorageFailpointLocation = typeof SqliteStorageFailpointLocation.Type;\n\n/** Deterministic test-only fault or pause injected at a SQLite operation boundary. */\nexport class SqliteStorageFailpointError extends Schema.TaggedError<SqliteStorageFailpointError>()(\n  \"SqliteStorageFailpointError\",\n  {\n    location: SqliteStorageFailpointLocation,\n  },\n) {\n  override get message() {\n    return `Injected SQLite storage failure at ${this.location}.`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAIA,IAAa,kCAAb,cAAqD,OAAO,YAA6C,CAAC,CACxG,mCACA;CACE,eAAe,OAAO;CACtB,SAAS,OAAO;CAChB,kBAAkB,OAAO;AAC3B,CACF,CAAC,CAAC,CAAC;;AAGH,IAAa,+BAAb,cAAkD,OAAO,YAA0C,CAAC,CAClG,gCACA;CACE,SAAS,OAAO;CAChB,QAAQ,OAAO;CACf,OAAO,OAAO;AAChB,CACF,CAAC,CAAC,CAAC;;AAGH,IAAa,qBAAb,cAAwC,OAAO,YAAgC,CAAC,CAC9E,sBACA;CACE,OAAO,OAAO,YAAY,OAAO,OAAO,CAAC;CACzC,SAAS,OAAO;CAChB,WAAW,OAAO;AACpB,CACF,CAAC,CAAC,CAAC;;;;;;AAOH,IAAa,oBAAb,cAAuC,OAAO,YAA+B,CAAC,CAC5E,qBACA;CACE,OAAO,OAAO,YAAY,OAAO,OAAO,CAAC;CACzC,SAAS,OAAO;CAChB,WAAW,OAAO;AACpB,CACF,CAAC,CAAC,CAAC;;;;;AAMH,IAAa,uBAAb,cAA0C,OAAO,YAAkC,CAAC,CAClF,wBACA;CACE,SAAS,OAAO;CAChB,QAAQ,OAAO,SAAS;EAAC;EAAgB;EAAmB;CAAM,CAAC;CACnE,oBAAoB,OAAO,YAAY,iBAAiB;CACxD,kBAAkB,OAAO,YAAY,OAAO,MAAM;AACpD,CACF,CAAC,CAAC,CAAC;;;;;;AAOH,IAAa,sBAAb,cAAyC,OAAO,YAAiC,CAAC,CAChF,uBACA;CACE,aAAa;CACb,SAAS,OAAO;CAChB,eAAe;AACjB,CACF,CAAC,CAAC,CAAC;;;;;;AAOH,IAAa,wBAAb,cAA2C,OAAO,YAAmC,CAAC,CACpF,yBACA;CACE,OAAO,OAAO,YAAY,OAAO,OAAO,CAAC;CACzC,SAAS,OAAO;CAChB,WAAW,OAAO;AACpB,CACF,CAAC,CAAC,CAAC;;AAGH,IAAa,2BAAb,cAA8C,OAAO,YAAsC,CAAC,CAC1F,4BACA,EACE,SAAS,OAAO,OAClB,CACF,CAAC,CAAC,CAAC;AAEH,MAAa,iCAAiC,OAAO,SAAS;CAC5D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAKD,IAAa,8BAAb,cAAiD,OAAO,YAAyC,CAAC,CAChG,+BACA,EACE,UAAU,+BACZ,CACF,CAAC,CAAC;CACA,IAAa,UAAU;EACrB,OAAO,sCAAsC,KAAK,SAAS;CAC7D;AACF"}

package/dist/SqliteStorageFailpoint.d.mts

@@ -0,0 +1,17 @@
+import { l as SqliteStorageFailpointError, u as SqliteStorageFailpointLocation } from "./SqliteStorageError-CzKmwCLl.mjs";
+import { Context, Effect, Layer } from "effect";
+declare namespace SqliteStorageFailpoint_d_exports {
+  export { SqliteStorageFailpoint, SqliteStorageFailpointHandler };
+}
+type SqliteStorageFailpointHandler = (location: SqliteStorageFailpointLocation) => Effect.Effect<void, SqliteStorageFailpointError>;
+declare const SqliteStorageFailpoint_base: Context.ServiceClass<SqliteStorageFailpoint, "@effect-agent/storage-sqlite/SqliteStorageFailpoint", {
+  readonly hit: SqliteStorageFailpointHandler;
+}>;
+/** Explicit fault-injection authority used at SQLite operation boundaries. */
+declare class SqliteStorageFailpoint extends SqliteStorageFailpoint_base {
+  /** Production default: no fault injection. */
+  static readonly layer: Layer.Layer<SqliteStorageFailpoint, never, never>;
+}
+//#endregion
+export { SqliteStorageFailpoint, SqliteStorageFailpointHandler, SqliteStorageFailpoint_d_exports as t };
+//# sourceMappingURL=SqliteStorageFailpoint.d.mts.map

package/dist/SqliteStorageFailpoint.mjs

@@ -0,0 +1,14 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Context, Effect, Layer } from "effect";
+//#region src/SqliteStorageFailpoint.ts
+var SqliteStorageFailpoint_exports = /* @__PURE__ */ __exportAll({ SqliteStorageFailpoint: () => SqliteStorageFailpoint });
+const noFailpoint = () => Effect.void;
+/** Explicit fault-injection authority used at SQLite operation boundaries. */
+var SqliteStorageFailpoint = class extends Context.Service()("@effect-agent/storage-sqlite/SqliteStorageFailpoint") {
+	/** Production default: no fault injection. */
+	static layer = Layer.succeed(this)({ hit: noFailpoint });
+};
+//#endregion
+export { SqliteStorageFailpoint, SqliteStorageFailpoint_exports as t };
+
+//# sourceMappingURL=SqliteStorageFailpoint.mjs.map

package/dist/SqliteStorageFailpoint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStorageFailpoint.mjs","names":[],"sources":["../src/SqliteStorageFailpoint.ts"],"sourcesContent":["import { Context, Effect, Layer } from \"effect\";\n\nimport type {\n  SqliteStorageFailpointError,\n  SqliteStorageFailpointLocation,\n} from \"./SqliteStorageError.ts\";\n\nexport type SqliteStorageFailpointHandler = (\n  location: SqliteStorageFailpointLocation,\n) => Effect.Effect<void, SqliteStorageFailpointError>;\n\nconst noFailpoint: SqliteStorageFailpointHandler = () => Effect.void;\n\n/** Explicit fault-injection authority used at SQLite operation boundaries. */\nexport class SqliteStorageFailpoint extends Context.Service<\n  SqliteStorageFailpoint,\n  {\n    readonly hit: SqliteStorageFailpointHandler;\n  }\n>()(\"@effect-agent/storage-sqlite/SqliteStorageFailpoint\") {\n  /** Production default: no fault injection. */\n  static readonly layer = Layer.succeed(this)({ hit: noFailpoint });\n}\n"],"mappings":";;;;AAWA,MAAM,oBAAmD,OAAO;;AAGhE,IAAa,yBAAb,cAA4C,QAAQ,QAKlD,CAAC,CAAC,qDAAqD,CAAC,CAAC;;CAEzD,OAAgB,QAAQ,MAAM,QAAQ,IAAI,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC;AAClE"}

package/dist/SqliteStorageFailpointTesting.d.mts

@@ -0,0 +1,15 @@
+import { SqliteStorageFailpoint, SqliteStorageFailpointHandler } from "./SqliteStorageFailpoint.mjs";
+import { Context, Effect, Layer } from "effect";
+//#region src/SqliteStorageFailpointTesting.d.ts
+declare const SqliteStorageFailpointTestControl_base: Context.ServiceClass<SqliteStorageFailpointTestControl, "@effect-agent/storage-sqlite/SqliteStorageFailpointTestControl", {
+  readonly clear: Effect.Effect<void>;
+  readonly setHandler: (handler: SqliteStorageFailpointHandler) => Effect.Effect<void>;
+}>;
+/** Test-only control for replacing the active SQLite failpoint handler. */
+declare class SqliteStorageFailpointTestControl extends SqliteStorageFailpointTestControl_base {
+  /** Reusable test Layer with a control service backed by the same handler Ref. */
+  static readonly layer: Layer.Layer<SqliteStorageFailpoint | SqliteStorageFailpointTestControl, never, never>;
+}
+//#endregion
+export { SqliteStorageFailpointTestControl };
+//# sourceMappingURL=SqliteStorageFailpointTesting.d.mts.map

package/dist/SqliteStorageFailpointTesting.mjs

@@ -0,0 +1,19 @@
+import { SqliteStorageFailpoint } from "./SqliteStorageFailpoint.mjs";
+import { Context, Effect, Layer, Ref } from "effect";
+//#region src/SqliteStorageFailpointTesting.ts
+const noFailpoint = () => Effect.void;
+/** Test-only control for replacing the active SQLite failpoint handler. */
+var SqliteStorageFailpointTestControl = class SqliteStorageFailpointTestControl extends Context.Service()("@effect-agent/storage-sqlite/SqliteStorageFailpointTestControl") {
+	/** Reusable test Layer with a control service backed by the same handler Ref. */
+	static layer = Layer.effectContext(Effect.gen(function* () {
+		const handler = yield* Ref.make(noFailpoint);
+		return Context.make(SqliteStorageFailpoint, SqliteStorageFailpoint.of({ hit: (location) => Ref.get(handler).pipe(Effect.flatMap((current) => current(location))) })).pipe(Context.add(SqliteStorageFailpointTestControl, SqliteStorageFailpointTestControl.of({
+			clear: Ref.set(handler, noFailpoint),
+			setHandler: (next) => Ref.set(handler, next)
+		})));
+	}));
+};
+//#endregion
+export { SqliteStorageFailpointTestControl };
+
+//# sourceMappingURL=SqliteStorageFailpointTesting.mjs.map

package/dist/SqliteStorageFailpointTesting.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStorageFailpointTesting.mjs","names":[],"sources":["../src/SqliteStorageFailpointTesting.ts"],"sourcesContent":["import { Context, Effect, Layer, Ref } from \"effect\";\n\nimport {\n  SqliteStorageFailpoint,\n  type SqliteStorageFailpointHandler,\n} from \"./SqliteStorageFailpoint.ts\";\n\nconst noFailpoint: SqliteStorageFailpointHandler = () => Effect.void;\n\n/** Test-only control for replacing the active SQLite failpoint handler. */\nexport class SqliteStorageFailpointTestControl extends Context.Service<\n  SqliteStorageFailpointTestControl,\n  {\n    readonly clear: Effect.Effect<void>;\n    readonly setHandler: (handler: SqliteStorageFailpointHandler) => Effect.Effect<void>;\n  }\n>()(\"@effect-agent/storage-sqlite/SqliteStorageFailpointTestControl\") {\n  /** Reusable test Layer with a control service backed by the same handler Ref. */\n  static readonly layer = Layer.effectContext(\n    Effect.gen(function* () {\n      const handler = yield* Ref.make<SqliteStorageFailpointHandler>(noFailpoint);\n\n      return Context.make(\n        SqliteStorageFailpoint,\n        SqliteStorageFailpoint.of({\n          hit: (location) => Ref.get(handler).pipe(Effect.flatMap((current) => current(location))),\n        }),\n      ).pipe(\n        Context.add(\n          SqliteStorageFailpointTestControl,\n          SqliteStorageFailpointTestControl.of({\n            clear: Ref.set(handler, noFailpoint),\n            setHandler: (next) => Ref.set(handler, next),\n          }),\n        ),\n      );\n    }),\n  );\n}\n"],"mappings":";;;AAOA,MAAM,oBAAmD,OAAO;;AAGhE,IAAa,oCAAb,MAAa,0CAA0C,QAAQ,QAM7D,CAAC,CAAC,gEAAgE,CAAC,CAAC;;CAEpE,OAAgB,QAAQ,MAAM,cAC5B,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,IAAI,KAAoC,WAAW;EAE1E,OAAO,QAAQ,KACb,wBACA,uBAAuB,GAAG,EACxB,MAAM,aAAa,IAAI,IAAI,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,YAAY,QAAQ,QAAQ,CAAC,CAAC,EACzF,CAAC,CACH,CAAC,CAAC,KACA,QAAQ,IACN,mCACA,kCAAkC,GAAG;GACnC,OAAO,IAAI,IAAI,SAAS,WAAW;GACnC,aAAa,SAAS,IAAI,IAAI,SAAS,IAAI;EAC7C,CAAC,CACH,CACF;CACF,CAAC,CACH;AACF"}

package/dist/SqliteStorageVersion-gA7_96xM.d.mts

@@ -0,0 +1,9 @@
+import { SqliteMigrator } from "@effect/sql-sqlite-node";
+//#region src/internal/migrations.d.ts
+declare const CurrentSqliteStorageVersion = 9;
+declare namespace SqliteStorageVersion_d_exports {
+  export { CurrentSqliteStorageVersion };
+}
+//#endregion
+export { CurrentSqliteStorageVersion as n, SqliteStorageVersion_d_exports as t };
+//# sourceMappingURL=SqliteStorageVersion-gA7_96xM.d.mts.map

package/dist/SqliteStorageVersion.d.mts

@@ -0,0 +1,2 @@
+import { n as CurrentSqliteStorageVersion } from "./SqliteStorageVersion-gA7_96xM.mjs";
+export { CurrentSqliteStorageVersion };

package/dist/SqliteStorageVersion.mjs

@@ -0,0 +1,8 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { t as CurrentSqliteStorageVersion } from "./migrations-dnTR0RKq.mjs";
+//#region src/SqliteStorageVersion.ts
+var SqliteStorageVersion_exports = /* @__PURE__ */ __exportAll({ CurrentSqliteStorageVersion: () => 9 });
+//#endregion
+export { CurrentSqliteStorageVersion, SqliteStorageVersion_exports as t };
+
+//# sourceMappingURL=SqliteStorageVersion.mjs.map

package/dist/SqliteStorageVersion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStorageVersion.mjs","names":[],"sources":["../src/SqliteStorageVersion.ts"],"sourcesContent":["/** Public SqliteStorageVersion API. Implementation helpers remain private. */\nexport { CurrentSqliteStorageVersion } from \"./internal/migrations.ts\";\n"],"mappings":""}

package/dist/SqliteSubmissionLedger.d.mts

@@ -0,0 +1,23 @@
+import { SqliteStorageConfig } from "./SqliteStorageConfig.mjs";
+import { SqliteStorageFailpoint } from "./SqliteStorageFailpoint.mjs";
+import { SqliteStorageInitializationError, SqliteStorageOptions } from "./SqliteThreadStore.mjs";
+import { Crypto, Layer } from "effect";
+import * as SqlClientService from "effect/unstable/sql/SqlClient";
+import { SubmissionLedger } from "@effect-agent/thread/SubmissionLedger";
+declare namespace SqliteSubmissionLedger_d_exports {
+  export { ledgerLayer, submissionLedgerLayer };
+}
+/**
+ * SQLite SubmissionLedger implementation sharing the journal's database file, write
+ * transaction discipline, and producer-epoch fencing substrate. Configuration, failpoint,
+ * SQL, and Crypto authority stay visible in the input channel.
+ */
+declare const submissionLedgerLayer: Layer.Layer<SubmissionLedger, SqliteStorageInitializationError, SqliteStorageConfig | SqliteStorageFailpoint | SqlClientService.SqlClient | Crypto.Crypto>;
+/**
+ * A composition-root convenience Layer for the durable Submission Ledger. Point it at the
+ * same database file as the ThreadStore so claims fence the same producer epochs.
+ */
+declare const ledgerLayer: (options: SqliteStorageOptions) => Layer.Layer<SubmissionLedger, SqliteStorageInitializationError>;
+//#endregion
+export { ledgerLayer, submissionLedgerLayer, SqliteSubmissionLedger_d_exports as t };
+//# sourceMappingURL=SqliteSubmissionLedger.d.mts.map