@effect-agent/storage-cloudflare 0.1.0-beta.38 → 0.1.0-beta.40

package/dist/do-storage-failpoint-9XB9tuif.d.mts

@@ -0,0 +1,107 @@
+import { Context, Effect, Layer, Schema } from "effect";
+//#region src/errors.d.ts
+declare const DoStorageCompatibilityError_base: Schema.Class<DoStorageCompatibilityError, Schema.TaggedStruct<"DoStorageCompatibilityError", {
+  readonly actualVersion: Schema.Int;
+  readonly message: Schema.String;
+  readonly supportedVersion: Schema.Int;
+}>, import("effect/Cause").YieldableError>;
+/** The Durable Object's SQLite storage uses a private-development format this adapter cannot read. */
+declare class DoStorageCompatibilityError extends DoStorageCompatibilityError_base {}
+declare const DoStorageCorruptionError_base: Schema.Class<DoStorageCorruptionError, Schema.TaggedStruct<"DoStorageCorruptionError", {
+  readonly message: Schema.String;
+  readonly rowKey: Schema.String;
+  readonly table: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Stored bytes failed the current Schema and cannot be used as recovery truth. */
+declare class DoStorageCorruptionError extends DoStorageCorruptionError_base {}
+declare const DoStorageError_base: Schema.Class<DoStorageError, Schema.TaggedStruct<"DoStorageError", {
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+  readonly message: Schema.String;
+  readonly operation: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Durable Object SQLite infrastructure failed while opening or operating the store. */
+declare class DoStorageError extends DoStorageError_base {}
+declare const DoLedgerError_base: Schema.Class<DoLedgerError, Schema.TaggedStruct<"DoLedgerError", {
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+  readonly message: Schema.String;
+  readonly operation: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Durable Object SQLite infrastructure failed while operating the Submission Ledger. Surfaces
+ * at the SubmissionLedger port as the typed `LedgerError` with this error preserved as its
+ * cause, so the adapter-level tag is never erased.
+ */
+declare class DoLedgerError extends DoLedgerError_base {}
+declare const DoValueBoundExceeded_base: Schema.Class<DoValueBoundExceeded, Schema.TaggedStruct<"DoValueBoundExceeded", {
+  readonly actualBytes: Schema.Int;
+  readonly maxBytes: Schema.Int;
+  readonly operation: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * A value to be stored exceeds the configured Durable Object per-value bound
+ * (`DoStorageConfigValue.maxStoredValueBytes`, kept under the platform's 2 MB SQLite value
+ * limit). The refusal happens typed BEFORE any durable mutation; no partial state is written.
+ * Payloads of this size are the designed overflow case for a future R2-backed AttachmentStore
+ * (deployment spec §3.1, deferred until a real attachment requirement exists).
+ */
+declare class DoValueBoundExceeded extends DoValueBoundExceeded_base {
+  get message(): string;
+}
+declare const DoAppendConflict_base: Schema.Class<DoAppendConflict, Schema.TaggedStruct<"DoAppendConflict", {
+  readonly message: Schema.String;
+  readonly reason: Schema.Literals<readonly ["batch-digest", "record-identity", "tail"]>;
+  readonly actualTailSequence: Schema.optionalKey<Schema.brand<Schema.Natural, "@effect-agent/thread/CanonicalSequence">>;
+  readonly actualTailDigest: Schema.optionalKey<Schema.String>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * A canonical batch retry conflicts with existing append state. Tail conflicts carry the
+ * actual committed tail as a diagnostic resume hint.
+ */
+declare class DoAppendConflict extends DoAppendConflict_base {}
+declare const DoFenceRejected_base: Schema.Class<DoFenceRejected, Schema.TaggedStruct<"DoFenceRejected", {
+  readonly actualEpoch: Schema.brand<Schema.Natural, "@effect-agent/thread/ProducerEpoch">;
+  readonly message: Schema.String;
+  readonly producerEpoch: Schema.brand<Schema.Natural, "@effect-agent/thread/ProducerEpoch">;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * A producer epoch does not match the Thread's current writer registration. Appends
+ * require the exact registered epoch, so both older and newer unregistered epochs are fenced;
+ * a newer epoch takes over by materializing first.
+ */
+declare class DoFenceRejected extends DoFenceRejected_base {}
+declare const DoCheckpointConflict_base: Schema.Class<DoCheckpointConflict, Schema.TaggedStruct<"DoCheckpointConflict", {
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A checkpoint conflicts with a previously stored checkpoint at the same offset. */
+declare class DoCheckpointConflict extends DoCheckpointConflict_base {}
+/**
+ * Deterministic fault-injection locations at Durable Object storage operation boundaries.
+ *
+ * The string list is copied VERBATIM from `SqliteStorageFailpointLocation`
+ * (`packages/storage-sqlite/src/errors.ts`) so every crash-matrix row keeps the same name on
+ * both platforms — the DN process-kill evidence and the DC eviction evidence address identical
+ * locations. There is intentionally no Cloudflare-only location.
+ */
+declare const DoStorageFailpointLocation: Schema.Literals<readonly ["materialize:before", "materialize:after", "append:before", "append:after-batch-insert", "append:after-record-insert", "append:after-tail-update", "append:after", "export:after-thread-read", "save-checkpoint:before", "save-checkpoint:after", "ledger:admit:before", "ledger:admit:after", "ledger:mark-ready:before", "ledger:mark-ready:after", "ledger:claim:before", "ledger:claim:after", "ledger:mark-input-applied:before", "ledger:mark-input-applied:after", "ledger:renew:before", "ledger:renew:after", "ledger:reserve-settlement:before", "ledger:reserve-settlement:after", "ledger:finalize-settlement:before", "ledger:finalize-settlement:after", "ledger:request-abort:before", "ledger:request-abort:after", "ledger:release:before", "ledger:release:after", "ledger:claim-joining:before", "ledger:claim-joining:after", "ledger:mark-joined:before", "ledger:mark-joined:after", "ledger:revert-joining:before", "ledger:revert-joining:after", "ledger:suspend:before", "ledger:suspend:after", "ledger:approval-decision:before", "ledger:approval-decision:after", "ledger:mark-unknown:before", "ledger:mark-unknown:after", "ledger:unknown-resolution:before", "ledger:unknown-resolution:after", "ledger:child-reservation:before", "ledger:child-reservation:after", "ledger:child-attach:before", "ledger:child-attach:after", "ledger:child-release-pending:before", "ledger:child-release-pending:after", "ledger:child-release:before", "ledger:child-release:after", "ledger:child-settled:before", "ledger:child-settled:after"]>;
+type DoStorageFailpointLocation = typeof DoStorageFailpointLocation.Type;
+declare const DoStorageFailpointError_base: Schema.Class<DoStorageFailpointError, Schema.TaggedStruct<"DoStorageFailpointError", {
+  readonly location: Schema.Literals<readonly ["materialize:before", "materialize:after", "append:before", "append:after-batch-insert", "append:after-record-insert", "append:after-tail-update", "append:after", "export:after-thread-read", "save-checkpoint:before", "save-checkpoint:after", "ledger:admit:before", "ledger:admit:after", "ledger:mark-ready:before", "ledger:mark-ready:after", "ledger:claim:before", "ledger:claim:after", "ledger:mark-input-applied:before", "ledger:mark-input-applied:after", "ledger:renew:before", "ledger:renew:after", "ledger:reserve-settlement:before", "ledger:reserve-settlement:after", "ledger:finalize-settlement:before", "ledger:finalize-settlement:after", "ledger:request-abort:before", "ledger:request-abort:after", "ledger:release:before", "ledger:release:after", "ledger:claim-joining:before", "ledger:claim-joining:after", "ledger:mark-joined:before", "ledger:mark-joined:after", "ledger:revert-joining:before", "ledger:revert-joining:after", "ledger:suspend:before", "ledger:suspend:after", "ledger:approval-decision:before", "ledger:approval-decision:after", "ledger:mark-unknown:before", "ledger:mark-unknown:after", "ledger:unknown-resolution:before", "ledger:unknown-resolution:after", "ledger:child-reservation:before", "ledger:child-reservation:after", "ledger:child-attach:before", "ledger:child-attach:after", "ledger:child-release-pending:before", "ledger:child-release-pending:after", "ledger:child-release:before", "ledger:child-release:after", "ledger:child-settled:before", "ledger:child-settled:after"]>;
+}>, import("effect/Cause").YieldableError>;
+/** Deterministic test-only fault or pause injected at a Durable Object storage boundary. */
+declare class DoStorageFailpointError extends DoStorageFailpointError_base {
+  get message(): string;
+}
+//#endregion
+//#region src/do-storage-failpoint.d.ts
+type DoStorageFailpointHandler = (location: DoStorageFailpointLocation) => Effect.Effect<void, DoStorageFailpointError>;
+declare const DoStorageFailpoint_base: Context.ServiceClass<DoStorageFailpoint, "@effect-agent/storage-cloudflare/DoStorageFailpoint", {
+  readonly hit: DoStorageFailpointHandler;
+}>;
+/** Explicit fault-injection authority used at Durable Object storage operation boundaries. */
+declare class DoStorageFailpoint extends DoStorageFailpoint_base {
+  /** Production default: no fault injection. */
+  static readonly layer: Layer.Layer<DoStorageFailpoint, never, never>;
+}
+//#endregion
+export { DoFenceRejected as a, DoStorageCorruptionError as c, DoStorageFailpointLocation as d, DoValueBoundExceeded as f, DoCheckpointConflict as i, DoStorageError as l, DoStorageFailpointHandler as n, DoLedgerError as o, DoAppendConflict as r, DoStorageCompatibilityError as s, DoStorageFailpoint as t, DoStorageFailpointError as u };
+//# sourceMappingURL=do-storage-failpoint-9XB9tuif.d.mts.map

package/dist/do-storage-failpoint-C-Qtchs7.mjs

@@ -0,0 +1,12 @@
+import { Context, Effect, Layer } from "effect";
+//#region src/do-storage-failpoint.ts
+const noFailpoint = () => Effect.void;
+/** Explicit fault-injection authority used at Durable Object storage operation boundaries. */
+var DoStorageFailpoint = class extends Context.Service()("@effect-agent/storage-cloudflare/DoStorageFailpoint") {
+	/** Production default: no fault injection. */
+	static layer = Layer.succeed(this)({ hit: noFailpoint });
+};
+//#endregion
+export { DoStorageFailpoint as t };
+
+//# sourceMappingURL=do-storage-failpoint-C-Qtchs7.mjs.map

package/dist/do-storage-failpoint-C-Qtchs7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-storage-failpoint-C-Qtchs7.mjs","names":[],"sources":["../src/do-storage-failpoint.ts"],"sourcesContent":["import { Context, Effect, Layer } from \"effect\";\n\nimport type { DoStorageFailpointError, DoStorageFailpointLocation } from \"./errors.ts\";\n\nexport type DoStorageFailpointHandler = (\n  location: DoStorageFailpointLocation,\n) => Effect.Effect<void, DoStorageFailpointError>;\n\nconst noFailpoint: DoStorageFailpointHandler = () => Effect.void;\n\n/** Explicit fault-injection authority used at Durable Object storage operation boundaries. */\nexport class DoStorageFailpoint extends Context.Service<\n  DoStorageFailpoint,\n  {\n    readonly hit: DoStorageFailpointHandler;\n  }\n>()(\"@effect-agent/storage-cloudflare/DoStorageFailpoint\") {\n  /** Production default: no fault injection. */\n  static readonly layer = Layer.succeed(this)({ hit: noFailpoint });\n}\n"],"mappings":";;AAQA,MAAM,oBAA+C,OAAO;;AAG5D,IAAa,qBAAb,cAAwC,QAAQ,QAK9C,CAAC,CAAC,qDAAqD,CAAC,CAAC;;CAEzD,OAAgB,QAAQ,MAAM,QAAQ,IAAI,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC;AAClE"}