mailery 0.0.0 → 0.1.0

package/dist/testing.d.cts

@@ -1,3 +1,64 @@
-declare const TESTING_PLACEHOLDER = true;
+import { Db } from 'mongodb';
+import { C as ContactAdapter, a as Contact, A as AdapterFilter, c as Mailer, q as NullProvider } from './null-7gnz1V98.cjs';
+import 'ioredis';
+import 'zod';
+import 'handlebars';
 
-export { TESTING_PLACEHOLDER };
+/**
+ * MemoryContactAdapter — drop-in in-process ContactAdapter for tests.
+ * Hold contacts in a Map; everything operates synchronously over RAM.
+ */
+
+declare class MemoryContactAdapter implements ContactAdapter {
+    private readonly byId;
+    constructor(initial?: Contact[]);
+    upsert(contact: Contact): void;
+    delete(externalId: string): void;
+    getById(externalId: string): Promise<Contact | null>;
+    getByEmail(email: string): Promise<Contact | null>;
+    getBatch(externalIds: string[]): Promise<Map<string, Contact>>;
+    query(filter: AdapterFilter, opts: {
+        limit: number;
+        cursor?: string;
+    }): Promise<{
+        contacts: Contact[];
+        nextCursor?: string;
+    }>;
+    count(filter: AdapterFilter): Promise<number>;
+    addTags(externalId: string, tags: string[]): Promise<void>;
+    removeTags(externalId: string, tags: string[]): Promise<void>;
+}
+
+/**
+ * Test helpers — `import { ... } from 'mailery/testing'`.
+ *
+ *   const harness = await createTestMailer({ seedContacts: [...] })
+ *   await harness.mailer.upsertSubscription({ externalId: 'u1', source: 'test' })
+ *   await harness.mailer.fire('Created', 'u1')
+ *   // drive the runner directly:
+ *   const { runTick, processOneRunStep, dispatchSend } = await import('mailery')
+ *   await runTick(harness.mailer.getRunnerContext())
+ *   expect(harness.provider.sent.length).toBe(1)
+ *   await harness.stop()
+ *
+ * Backed by mongodb-memory-server + ioredis-mock + NullProvider.
+ */
+
+interface TestMailerOptions {
+    adapter?: ContactAdapter;
+    seedContacts?: Contact[];
+    provider?: NullProvider;
+    /** Override Mailer config (excluding required fields the harness fills in). */
+    config?: Partial<Omit<Parameters<typeof Mailer.init>[0], 'db' | 'adapter' | 'redis' | 'providers' | 'defaultProvider'>>;
+}
+interface TestMailerHarness {
+    mailer: Mailer;
+    db: Db;
+    provider: NullProvider;
+    adapter: ContactAdapter;
+    memoryAdapter: MemoryContactAdapter | null;
+    stop: () => Promise<void>;
+}
+declare function createTestMailer(opts?: TestMailerOptions): Promise<TestMailerHarness>;
+
+export { MemoryContactAdapter, NullProvider, type TestMailerHarness, type TestMailerOptions, createTestMailer };

package/dist/testing.d.ts

@@ -1,3 +1,64 @@
-declare const TESTING_PLACEHOLDER = true;
+import { Db } from 'mongodb';
+import { C as ContactAdapter, a as Contact, A as AdapterFilter, c as Mailer, q as NullProvider } from './null-7gnz1V98.js';
+import 'ioredis';
+import 'zod';
+import 'handlebars';
 
-export { TESTING_PLACEHOLDER };
+/**
+ * MemoryContactAdapter — drop-in in-process ContactAdapter for tests.
+ * Hold contacts in a Map; everything operates synchronously over RAM.
+ */
+
+declare class MemoryContactAdapter implements ContactAdapter {
+    private readonly byId;
+    constructor(initial?: Contact[]);
+    upsert(contact: Contact): void;
+    delete(externalId: string): void;
+    getById(externalId: string): Promise<Contact | null>;
+    getByEmail(email: string): Promise<Contact | null>;
+    getBatch(externalIds: string[]): Promise<Map<string, Contact>>;
+    query(filter: AdapterFilter, opts: {
+        limit: number;
+        cursor?: string;
+    }): Promise<{
+        contacts: Contact[];
+        nextCursor?: string;
+    }>;
+    count(filter: AdapterFilter): Promise<number>;
+    addTags(externalId: string, tags: string[]): Promise<void>;
+    removeTags(externalId: string, tags: string[]): Promise<void>;
+}
+
+/**
+ * Test helpers — `import { ... } from 'mailery/testing'`.
+ *
+ *   const harness = await createTestMailer({ seedContacts: [...] })
+ *   await harness.mailer.upsertSubscription({ externalId: 'u1', source: 'test' })
+ *   await harness.mailer.fire('Created', 'u1')
+ *   // drive the runner directly:
+ *   const { runTick, processOneRunStep, dispatchSend } = await import('mailery')
+ *   await runTick(harness.mailer.getRunnerContext())
+ *   expect(harness.provider.sent.length).toBe(1)
+ *   await harness.stop()
+ *
+ * Backed by mongodb-memory-server + ioredis-mock + NullProvider.
+ */
+
+interface TestMailerOptions {
+    adapter?: ContactAdapter;
+    seedContacts?: Contact[];
+    provider?: NullProvider;
+    /** Override Mailer config (excluding required fields the harness fills in). */
+    config?: Partial<Omit<Parameters<typeof Mailer.init>[0], 'db' | 'adapter' | 'redis' | 'providers' | 'defaultProvider'>>;
+}
+interface TestMailerHarness {
+    mailer: Mailer;
+    db: Db;
+    provider: NullProvider;
+    adapter: ContactAdapter;
+    memoryAdapter: MemoryContactAdapter | null;
+    stop: () => Promise<void>;
+}
+declare function createTestMailer(opts?: TestMailerOptions): Promise<TestMailerHarness>;
+
+export { MemoryContactAdapter, NullProvider, type TestMailerHarness, type TestMailerOptions, createTestMailer };