effect-mq 0.3.1 → 0.3.2

package/README.md

@@ -16,7 +16,7 @@ One package, tree-shakeable modules:
 | `effect-mq` | `Job`, `JobStore`, `MemoryJobStore`, `Worker` | — |
 | `effect-mq/drizzle-postgres` | drizzle-postgres schema factories + the Postgres `JobStore` | `drizzle-orm` (v1), `@effect/sql-pg` |
 | `effect-mq/redis` | the Redis `JobStore` (Lua-script atomicity) | a `Redis` service (`@effect/platform-node`/`-bun`) |
-| `effect-mq/testing` | the `JobStore` conformance suite for driver authors | `@effect/vitest` |
+| `effect-mq/testing` | `TestJobStore` (assert enqueues in unit tests) + the driver conformance suite | `@effect/vitest` (conformance only) |
 
 ## Five-minute tour
 
@@ -510,6 +510,34 @@ handler).
 and `historySweepInterval`; drizzle-postgres additionally takes the table
 instances (+ `validate`), Redis a key `prefix`.
 
+## Testing your app
+
+Unit-test that services enqueue correctly — no worker, no boilerplate, and
+payloads come back **decoded through the job's schema** (so `Redacted`,
+`DateTime`, and branded values are real instances, not stored JSON):
+
+```ts
+import { TestJobStore } from "effect-mq/testing"
+
+it.effect("signup enqueues a welcome email", () =>
+  Effect.gen(function*() {
+    yield* SignupService.register({ email: "ada@example.com" })
+
+    const emails = yield* TestJobStore.enqueuedOf(SendEmail)
+    expect(emails).toHaveLength(1)
+    expect(emails[0]?.payload.to).toBe("ada@example.com")
+    expect(emails[0]?.state).toBe("waiting")
+  }).pipe(Effect.provide(TestJobStore.layer)))
+```
+
+`TestJobStore.layer` provides a fresh in-memory store as both the default
+`JobStore` (for the code under test) and the inspection service; jobs just
+accumulate in `waiting`/`delayed` since nothing claims them. Named stores
+use `TestJobStore.layerFor(Durable)`. Records surface scheduling detail
+(`state`, `priority`, `runAt`, `metadata`, `dedupeKey`), and the raw store
+is exposed for simulating claims/acks. No `@effect/vitest` required — it is
+plain Effect, so it works with any test runner.
+
 ## Writing a storage driver
 
 Implement the `JobStore` service (one atomic seam: `enqueue`, `claim`, `ack`,

package/dist/testing/TestJobStore.d.ts

@@ -0,0 +1,95 @@
+/**
+ * A test harness for asserting what your services enqueue, without running
+ * a worker.
+ *
+ * Provide `TestJobStore.layer` in a unit test and jobs enqueued by the code
+ * under test simply accumulate in `waiting`/`delayed` (nothing claims them).
+ * `enqueuedOf` returns them with payloads **decoded through the job's own
+ * schema** — you assert against the typed values your service produced, not
+ * the encoded JSON the store persists:
+ *
+ * ```ts
+ * import { TestJobStore } from "effect-mq/testing"
+ *
+ * it.effect("signup enqueues a welcome email", () =>
+ *   Effect.gen(function*() {
+ *     yield* SignupService.register({ email: "ada@example.com" })
+ *
+ *     const emails = yield* TestJobStore.enqueuedOf(SendEmail)
+ *     expect(emails).toHaveLength(1)
+ *     expect(emails[0]?.payload.to).toBe("ada@example.com")
+ *     expect(emails[0]?.state).toBe("waiting")
+ *   }).pipe(Effect.provide(TestJobStore.layer)))
+ * ```
+ *
+ * Jobs bound to named stores use `TestJobStore.layerFor(Durable)` instead.
+ * The raw `JobStore` service is also exposed (as `.store`) for advanced
+ * scenarios — simulating claims/acks, reading `counts()`, and so on.
+ *
+ * @since 0.3.2
+ */
+import * as JobStore from "../JobStore.ts";
+import { Context, Effect, Layer, Schema } from "effect";
+/**
+ * The minimal structural view of a `Job.make` class that `enqueuedOf`
+ * needs: its tag and its JSON payload codec.
+ *
+ * @since 0.3.2
+ */
+export interface AnyJobDefinition {
+    readonly _tag: string;
+    readonly payloadJsonSchema: Schema.Top & {
+        readonly DecodingServices: never;
+    };
+}
+/**
+ * A stored job with its payload decoded back to the definition's payload
+ * type.
+ *
+ * @since 0.3.2
+ */
+export interface EnqueuedJob<Payload> extends Omit<JobStore.JobRecord, "payload"> {
+    readonly payload: Payload;
+}
+declare const TestJobStore_base: Context.ServiceClass<TestJobStore, "effect-mq/testing/TestJobStore", {
+    store: JobStore.Service;
+    enqueued: (name?: string) => Effect.Effect<JobStore.JobRecord[], never, never>;
+    enqueuedOf: <J extends AnyJobDefinition>(job: J) => Effect.Effect<EnqueuedJob<J["payloadJsonSchema"]["Type"]>[], never, never>;
+}>;
+/**
+ * Inspection API over the test store. `enqueued(name?)` returns raw records
+ * oldest-first; `enqueuedOf(JobClass)` additionally decodes payloads through
+ * the definition's schema.
+ *
+ * @since 0.3.2
+ */
+export declare class TestJobStore extends TestJobStore_base {
+}
+/**
+ * A fresh in-memory store provided as BOTH the default `JobStore` (for the
+ * code under test) and the `TestJobStore` inspection service (for the
+ * assertions).
+ *
+ * @since 0.3.2
+ */
+export declare const layer: Layer.Layer<JobStore.JobStore | TestJobStore>;
+/**
+ * Like `layer`, for jobs bound to a `JobStore.named(...)` key.
+ *
+ * @since 0.3.2
+ */
+export declare const layerFor: <Id>(store: Context.Key<Id, JobStore.Service>) => Layer.Layer<Id | TestJobStore>;
+/**
+ * Convenience accessors so tests don't have to `yield* TestJobStore` first.
+ *
+ * @since 0.3.2
+ */
+export declare const enqueuedOf: <J extends AnyJobDefinition>(job: J) => Effect.Effect<Array<EnqueuedJob<J["payloadJsonSchema"]["Type"]>>, never, TestJobStore>;
+/**
+ * Raw records (optionally filtered by job name), oldest-first.
+ *
+ * @since 0.3.2
+ */
+export declare const enqueued: (name?: string) => Effect.Effect<Array<JobStore.JobRecord>, never, TestJobStore>;
+export {};
+//# sourceMappingURL=TestJobStore.d.ts.map

package/dist/testing/TestJobStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestJobStore.d.ts","sourceRoot":"","sources":["../../src/testing/TestJobStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,GAAG;QAAE,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAA;KAAE,CAAA;CAC9E;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,CAAE,SAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;;;sBAmBmB,MAAM;iBACX,CAAC,SAAS,gBAAgB,OAAO,CAAC;;AAWjD;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,iBAEjC;CAAG;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,GAAG,YAAY,CAK/D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,EAAE,SAClB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,KACvC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,YAAY,CAM7B,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,gBAAgB,OAC9C,CAAC,KACL,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAC5B,CAAA;AAE5D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,UACZ,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,CACJ,CAAA"}

package/dist/testing/TestJobStore.js

@@ -0,0 +1,88 @@
+/**
+ * A test harness for asserting what your services enqueue, without running
+ * a worker.
+ *
+ * Provide `TestJobStore.layer` in a unit test and jobs enqueued by the code
+ * under test simply accumulate in `waiting`/`delayed` (nothing claims them).
+ * `enqueuedOf` returns them with payloads **decoded through the job's own
+ * schema** — you assert against the typed values your service produced, not
+ * the encoded JSON the store persists:
+ *
+ * ```ts
+ * import { TestJobStore } from "effect-mq/testing"
+ *
+ * it.effect("signup enqueues a welcome email", () =>
+ *   Effect.gen(function*() {
+ *     yield* SignupService.register({ email: "ada@example.com" })
+ *
+ *     const emails = yield* TestJobStore.enqueuedOf(SendEmail)
+ *     expect(emails).toHaveLength(1)
+ *     expect(emails[0]?.payload.to).toBe("ada@example.com")
+ *     expect(emails[0]?.state).toBe("waiting")
+ *   }).pipe(Effect.provide(TestJobStore.layer)))
+ * ```
+ *
+ * Jobs bound to named stores use `TestJobStore.layerFor(Durable)` instead.
+ * The raw `JobStore` service is also exposed (as `.store`) for advanced
+ * scenarios — simulating claims/acks, reading `counts()`, and so on.
+ *
+ * @since 0.3.2
+ */
+import * as JobStore from "../JobStore.js";
+import * as MemoryJobStore from "../MemoryJobStore.js";
+import { Context, Effect, Layer, Schema } from "effect";
+const drainList = (store, name) => Effect.gen(function* () {
+    const all = [];
+    let cursor = undefined;
+    while (true) {
+        const page = yield* store.list({ name, cursor, limit: 200 }).pipe(Effect.orDie);
+        all.push(...page.items);
+        if (page.cursor === undefined)
+            break;
+        cursor = page.cursor;
+    }
+    // list() is newest-first; flip to oldest-first for natural reading.
+    // Ties (same-instant enqueues) order by id, not submission order.
+    return all.toReversed();
+});
+const makeApi = (store) => ({
+    store,
+    enqueued: (name) => drainList(store, name),
+    enqueuedOf: (job) => drainList(store, job._tag).pipe(Effect.flatMap(Effect.forEach((record) => Schema.decodeUnknownEffect(job.payloadJsonSchema)(record.payload).pipe(Effect.orDie, Effect.map((payload) => ({ ...record, payload }))))))
+});
+/**
+ * Inspection API over the test store. `enqueued(name?)` returns raw records
+ * oldest-first; `enqueuedOf(JobClass)` additionally decodes payloads through
+ * the definition's schema.
+ *
+ * @since 0.3.2
+ */
+export class TestJobStore extends Context.Service()("effect-mq/testing/TestJobStore") {
+}
+/**
+ * A fresh in-memory store provided as BOTH the default `JobStore` (for the
+ * code under test) and the `TestJobStore` inspection service (for the
+ * assertions).
+ *
+ * @since 0.3.2
+ */
+export const layer = Layer.effectContext(Effect.map(MemoryJobStore.makeWith(), (store) => Context.make(JobStore.JobStore, store).pipe(Context.add(TestJobStore, TestJobStore.of(makeApi(store))))));
+/**
+ * Like `layer`, for jobs bound to a `JobStore.named(...)` key.
+ *
+ * @since 0.3.2
+ */
+export const layerFor = (store) => Layer.effectContext(Effect.map(MemoryJobStore.makeWith(), (memory) => Context.make(store, memory).pipe(Context.add(TestJobStore, TestJobStore.of(makeApi(memory))))));
+/**
+ * Convenience accessors so tests don't have to `yield* TestJobStore` first.
+ *
+ * @since 0.3.2
+ */
+export const enqueuedOf = (job) => Effect.flatMap(TestJobStore, (api) => api.enqueuedOf(job));
+/**
+ * Raw records (optionally filtered by job name), oldest-first.
+ *
+ * @since 0.3.2
+ */
+export const enqueued = (name) => Effect.flatMap(TestJobStore, (api) => api.enqueued(name));
+//# sourceMappingURL=TestJobStore.js.map

package/dist/testing/TestJobStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestJobStore.js","sourceRoot":"","sources":["../../src/testing/TestJobStore.ts"],"names":[],"mappings":"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"}

package/dist/testing/index.d.ts

@@ -5,4 +5,10 @@
  * @since 0.1.0
  */
 export * from "./conformance.ts";
+/**
+ * Assert what services enqueue in unit tests, with typed payloads.
+ *
+ * @since 0.3.2
+ */
+export * as TestJobStore from "./TestJobStore.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,kBAAkB,CAAA;AAEhC;;;;GAIG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA"}

package/dist/testing/index.js

@@ -5,4 +5,10 @@
  * @since 0.1.0
  */
 export * from "./conformance.js";
+/**
+ * Assert what services enqueue in unit tests, with typed payloads.
+ *
+ * @since 0.3.2
+ */
+export * as TestJobStore from "./TestJobStore.js";
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,kBAAkB,CAAA;AAEhC;;;;GAIG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-mq",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Effect-native background jobs: schema-first definitions, storage-agnostic queue core, worker runtime, and a Postgres store through drizzle.",
   "license": "MIT",
   "author": "Adam Rankin",

package/src/testing/TestJobStore.ts

@@ -0,0 +1,143 @@
+/**
+ * A test harness for asserting what your services enqueue, without running
+ * a worker.
+ *
+ * Provide `TestJobStore.layer` in a unit test and jobs enqueued by the code
+ * under test simply accumulate in `waiting`/`delayed` (nothing claims them).
+ * `enqueuedOf` returns them with payloads **decoded through the job's own
+ * schema** — you assert against the typed values your service produced, not
+ * the encoded JSON the store persists:
+ *
+ * ```ts
+ * import { TestJobStore } from "effect-mq/testing"
+ *
+ * it.effect("signup enqueues a welcome email", () =>
+ *   Effect.gen(function*() {
+ *     yield* SignupService.register({ email: "ada@example.com" })
+ *
+ *     const emails = yield* TestJobStore.enqueuedOf(SendEmail)
+ *     expect(emails).toHaveLength(1)
+ *     expect(emails[0]?.payload.to).toBe("ada@example.com")
+ *     expect(emails[0]?.state).toBe("waiting")
+ *   }).pipe(Effect.provide(TestJobStore.layer)))
+ * ```
+ *
+ * Jobs bound to named stores use `TestJobStore.layerFor(Durable)` instead.
+ * The raw `JobStore` service is also exposed (as `.store`) for advanced
+ * scenarios — simulating claims/acks, reading `counts()`, and so on.
+ *
+ * @since 0.3.2
+ */
+import * as JobStore from "../JobStore.ts"
+import * as MemoryJobStore from "../MemoryJobStore.ts"
+import { Context, Effect, Layer, Schema } from "effect"
+
+/**
+ * The minimal structural view of a `Job.make` class that `enqueuedOf`
+ * needs: its tag and its JSON payload codec.
+ *
+ * @since 0.3.2
+ */
+export interface AnyJobDefinition {
+  readonly _tag: string
+  readonly payloadJsonSchema: Schema.Top & { readonly DecodingServices: never }
+}
+
+/**
+ * A stored job with its payload decoded back to the definition's payload
+ * type.
+ *
+ * @since 0.3.2
+ */
+export interface EnqueuedJob<Payload> extends Omit<JobStore.JobRecord, "payload"> {
+  readonly payload: Payload
+}
+
+const drainList = (store: JobStore.Service, name?: string) =>
+  Effect.gen(function*() {
+    const all: Array<JobStore.JobRecord> = []
+    let cursor: string | undefined = undefined
+    while (true) {
+      const page: JobStore.ListResult = yield* store.list({ name, cursor, limit: 200 }).pipe(Effect.orDie)
+      all.push(...page.items)
+      if (page.cursor === undefined) break
+      cursor = page.cursor
+    }
+    // list() is newest-first; flip to oldest-first for natural reading.
+    // Ties (same-instant enqueues) order by id, not submission order.
+    return all.toReversed()
+  })
+
+const makeApi = (store: JobStore.Service) => ({
+  store,
+  enqueued: (name?: string) => drainList(store, name),
+  enqueuedOf: <J extends AnyJobDefinition>(job: J) =>
+    drainList(store, job._tag).pipe(
+      Effect.flatMap(Effect.forEach((record) =>
+        Schema.decodeUnknownEffect(job.payloadJsonSchema)(record.payload).pipe(
+          Effect.orDie,
+          Effect.map((payload): EnqueuedJob<J["payloadJsonSchema"]["Type"]> => ({ ...record, payload }))
+        )
+      ))
+    )
+})
+
+/**
+ * Inspection API over the test store. `enqueued(name?)` returns raw records
+ * oldest-first; `enqueuedOf(JobClass)` additionally decodes payloads through
+ * the definition's schema.
+ *
+ * @since 0.3.2
+ */
+export class TestJobStore extends Context.Service<TestJobStore, ReturnType<typeof makeApi>>()(
+  "effect-mq/testing/TestJobStore"
+) {}
+
+/**
+ * A fresh in-memory store provided as BOTH the default `JobStore` (for the
+ * code under test) and the `TestJobStore` inspection service (for the
+ * assertions).
+ *
+ * @since 0.3.2
+ */
+export const layer: Layer.Layer<JobStore.JobStore | TestJobStore> = Layer.effectContext(
+  Effect.map(MemoryJobStore.makeWith(), (store) =>
+    Context.make(JobStore.JobStore, store).pipe(
+      Context.add(TestJobStore, TestJobStore.of(makeApi(store)))
+    ))
+)
+
+/**
+ * Like `layer`, for jobs bound to a `JobStore.named(...)` key.
+ *
+ * @since 0.3.2
+ */
+export const layerFor = <Id>(
+  store: Context.Key<Id, JobStore.Service>
+): Layer.Layer<Id | TestJobStore> =>
+  Layer.effectContext(
+    Effect.map(MemoryJobStore.makeWith(), (memory) =>
+      Context.make(store, memory).pipe(
+        Context.add(TestJobStore, TestJobStore.of(makeApi(memory)))
+      ))
+  )
+
+/**
+ * Convenience accessors so tests don't have to `yield* TestJobStore` first.
+ *
+ * @since 0.3.2
+ */
+export const enqueuedOf = <J extends AnyJobDefinition>(
+  job: J
+): Effect.Effect<Array<EnqueuedJob<J["payloadJsonSchema"]["Type"]>>, never, TestJobStore> =>
+  Effect.flatMap(TestJobStore, (api) => api.enqueuedOf(job))
+
+/**
+ * Raw records (optionally filtered by job name), oldest-first.
+ *
+ * @since 0.3.2
+ */
+export const enqueued = (
+  name?: string
+): Effect.Effect<Array<JobStore.JobRecord>, never, TestJobStore> =>
+  Effect.flatMap(TestJobStore, (api) => api.enqueued(name))

package/src/testing/index.ts

@@ -5,3 +5,10 @@
  * @since 0.1.0
  */
 export * from "./conformance.ts"
+
+/**
+ * Assert what services enqueue in unit tests, with typed payloads.
+ *
+ * @since 0.3.2
+ */
+export * as TestJobStore from "./TestJobStore.ts"