@atmosphere-money/testing 0.0.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.0.0-beta.0
+
+- Initial closed-beta testing package for ATM app integrations.
+- Adds signed webhook fixtures and request helpers for route tests.
+- Adds dedicated fixtures for payment completion, failure, refund, dispute,
+  product archive, subscription update, ticket issuance, and ticket check-in.
+- Adds a generic event fixture for all documented ATM event types.
+- Adds replay-store helpers and idempotency-key helpers.
+- Adds package release checks, API snapshot checks, and dry-run tarball validation.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Atmosphere Money
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# @atmosphere-money/testing
+
+Testing fixtures and assertions for Atmosphere Money app integrations.
+
+This package is for app test suites. It creates signed ATM webhook fixtures,
+sample payment/subscription/ticket events, generic event fixtures,
+replay-store helpers, and idempotency-key helpers so apps can test fulfillment
+without calling Stripe or ATM production services.
+
+## Status
+
+`@atmosphere-money/testing` is the planned dev-only testing package for ATM app
+integrations. Until npm publishing is enabled, closed-beta apps install it from
+a local checkout or private tarball.
+
+## Install during closed beta
+
+```sh
+npm install ../path/to/atmosphere-money/packages/testing
+```
+
+When published:
+
+```sh
+npm install -D @atmosphere-money/testing
+```
+
+## Signed webhook fixture
+
+```ts
+import {
+  ATM_TEST_WEBHOOK_SECRET,
+  createPaymentCompletedFixture,
+} from "@atmosphere-money/testing";
+import { constructTypedAtmWebhookEvent } from "@atmosphere-money/app-node";
+
+const fixture = createPaymentCompletedFixture({
+  payment: {
+    id: "pay_test_123",
+    metadata: { appOrderId: "ord_123" },
+  },
+});
+
+const event = constructTypedAtmWebhookEvent({
+  rawBody: fixture.rawBody,
+  secret: ATM_TEST_WEBHOOK_SECRET,
+  expectedType: "payment.completed",
+  now: fixture.event.created,
+  headers: {
+    signature: fixture.headers["atm-signature"],
+    deliveryId: fixture.headers["atm-delivery-id"],
+    event: fixture.headers["atm-event"],
+    apiVersion: fixture.headers["atm-api-version"],
+    environment: fixture.headers["atm-environment"],
+  },
+});
+```
+
+## Request helper
+
+Use `createAtmWebhookRequest` when your route tests expect a real Web
+`Request`.
+
+```ts
+import {
+  ATM_TEST_WEBHOOK_SECRET,
+  createAtmWebhookRequest,
+  createPaymentCompletedFixture,
+} from "@atmosphere-money/testing";
+import { createNodeWebhookHandler } from "@atmosphere-money/app-node";
+
+const fixture = createPaymentCompletedFixture();
+const request = createAtmWebhookRequest(fixture);
+
+const handler = createNodeWebhookHandler({
+  secret: ATM_TEST_WEBHOOK_SECRET,
+  expectedType: "payment.completed",
+  onEvent: async (event) => {
+    const metadata = event.data.payment.metadata as
+      | { appOrderId?: string }
+      | undefined;
+    await markOrderPaid(String(metadata?.appOrderId ?? ""));
+  },
+});
+
+const response = await handler(request);
+```
+
+## Replay helper
+
+```ts
+import {
+  assertFreshDelivery,
+  createMemoryReplayStore,
+} from "@atmosphere-money/testing";
+
+const replayStore = createMemoryReplayStore();
+await assertFreshDelivery(replayStore, "del_payment_completed_fixture");
+```
+
+## Generic event fixture
+
+Use `createAtmEventFixture` for documented events that do not need a dedicated
+factory.
+
+```ts
+import { createAtmEventFixture } from "@atmosphere-money/testing";
+
+const archived = createAtmEventFixture({
+  type: "product.archived",
+  data: {
+    productUri: "at://did:plc:creator/money.atmosphere.product/product_123",
+    appDid: "did:plc:app",
+  },
+});
+```
+
+## Common event fixtures
+
+Use dedicated factories for events most apps branch on during fulfillment,
+support, and operations.
+
+```ts
+import {
+  createPaymentDisputedFixture,
+  createPaymentFailedFixture,
+  createPaymentRefundedFixture,
+  createProductArchivedFixture,
+  createTicketCheckedInFixture,
+} from "@atmosphere-money/testing";
+
+const failedPayment = createPaymentFailedFixture({
+  payment: { failureCode: "card_declined" },
+});
+const refundedPayment = createPaymentRefundedFixture({
+  payment: { refundedAmountCents: 500 },
+});
+const disputedPayment = createPaymentDisputedFixture({
+  payment: { disputeStatus: "under_review" },
+});
+const archivedProduct = createProductArchivedFixture();
+const checkedInTicket = createTicketCheckedInFixture();
+```
+
+## Included fixtures
+
+- `createAtmEventFixture`
+- `createPaymentCompletedFixture`
+- `createPaymentFailedFixture`
+- `createPaymentRefundedFixture`
+- `createPaymentDisputedFixture`
+- `createProductArchivedFixture`
+- `createSubscriptionUpdatedFixture`
+- `createTicketCheckedInFixture`
+- `createTicketsIssuedFixture`
+- `signAtmFixture`
+- `createAtmWebhookRequest`
+- `createMemoryReplayStore`
+- `assertFreshDelivery`
+- `createAtmIdempotencyKey`
+
+## License
+
+`@atmosphere-money/testing` is released under the MIT license. The package
+license does not license the rest of the ATM monorepo or hosted platform code.
+
+## Package boundary
+
+This package does not mock Stripe, ATM checkout, processor webhooks, or PDS
+writes. It only helps apps test their own webhook/XRPC receiver and fulfillment
+logic with ATM-shaped events.

package/dist/index.d.ts

@@ -0,0 +1,185 @@
+export type AtmTestEnvironment = "test" | "live";
+export type AtmTestWebhookEventType = "app.webhook.test" | "payment.completed" | "payment.failed" | "payment.refunded" | "payment.disputed" | "subscription.invoice_paid" | "subscription.updated" | "subscription.cancelled" | "payer.record.requested" | "creator.proof.requested" | "attestation.updated" | "product.updated" | "product.archived" | "product.deleted" | "ticket.hold.created" | "ticket.hold.expired" | "tickets.issued" | "ticket.voided" | "ticket.refunded" | "ticket.checked_in";
+export type AtmTestWebhookEnvelope<TData = Record<string, unknown>> = {
+    id: string;
+    type: AtmTestWebhookEventType;
+    created: number;
+    apiVersion: string;
+    environment: AtmTestEnvironment;
+    data: TData;
+};
+export type AtmSignedFixture<TData = Record<string, unknown>> = {
+    event: AtmTestWebhookEnvelope<TData>;
+    rawBody: string;
+    headers: {
+        "atm-signature": string;
+        "atm-delivery-id": string;
+        "atm-event": AtmTestWebhookEventType;
+        "atm-api-version": string;
+        "atm-environment": AtmTestEnvironment;
+    };
+};
+export type AtmFixtureRequestOptions = {
+    url?: string;
+    method?: string;
+    headers?: HeadersInit;
+};
+export type AtmPaymentCompletedFixtureData = {
+    payment: {
+        id: string;
+        amountCents: number;
+        currency: string;
+        status: "completed";
+        paymentType: "tip" | "shop" | "commission" | "subscribe" | "ticket";
+        payerDid?: string;
+        recipientDid: string;
+        appDid: string;
+        metadata: Record<string, unknown>;
+    };
+};
+export type AtmPaymentFailedFixtureData = {
+    payment: {
+        id: string;
+        amountCents: number;
+        currency: string;
+        status: "failed";
+        paymentType: "tip" | "shop" | "commission" | "subscribe" | "ticket";
+        payerDid?: string;
+        recipientDid: string;
+        appDid: string;
+        failureCode: string;
+        failureMessage: string;
+        metadata: Record<string, unknown>;
+    };
+};
+export type AtmPaymentRefundedFixtureData = {
+    payment: {
+        id: string;
+        amountCents: number;
+        refundedAmountCents: number;
+        currency: string;
+        status: "refunded";
+        paymentType: "tip" | "shop" | "commission" | "subscribe" | "ticket";
+        payerDid?: string;
+        recipientDid: string;
+        appDid: string;
+        refundId: string;
+        metadata: Record<string, unknown>;
+    };
+};
+export type AtmPaymentDisputedFixtureData = {
+    payment: {
+        id: string;
+        amountCents: number;
+        currency: string;
+        status: "disputed";
+        paymentType: "tip" | "shop" | "commission" | "subscribe" | "ticket";
+        payerDid?: string;
+        recipientDid: string;
+        appDid: string;
+        disputeId: string;
+        disputeStatus: "needs_response" | "under_review" | "won" | "lost";
+        metadata: Record<string, unknown>;
+    };
+};
+export type AtmSubscriptionUpdatedFixtureData = {
+    subscription: {
+        id: string;
+        status: "active" | "past_due" | "cancelled";
+        amountCents: number;
+        previousAmountCents?: number;
+        currency: string;
+        interval: "month" | "quarter" | "year";
+        payerDid?: string;
+        recipientDid: string;
+        appDid: string;
+    };
+};
+export type AtmTicketsIssuedFixtureData = {
+    eventUri: string;
+    holdId: string;
+    paymentId?: string;
+    buyerDid?: string;
+    issuedCount: number;
+    tickets: Array<{
+        ticketId: string;
+        ticketTierId: string;
+        status: "issued";
+    }>;
+};
+export type AtmProductArchivedFixtureData = {
+    product: {
+        productUri: string;
+        productCid?: string;
+        appDid: string;
+        creatorDid?: string;
+        archivedAt: string;
+        metadata: Record<string, unknown>;
+    };
+};
+export type AtmTicketCheckedInFixtureData = {
+    ticket: {
+        ticketId: string;
+        ticketTierId: string;
+        eventUri: string;
+        buyerDid?: string;
+        checkInListId: string;
+        checkedInAt: string;
+        repeat: boolean;
+        metadata: Record<string, unknown>;
+    };
+};
+export type AtmFixtureOptions = {
+    id?: string;
+    deliveryId?: string;
+    created?: number;
+    apiVersion?: string;
+    environment?: AtmTestEnvironment;
+    secret?: string;
+};
+export type AtmReplayStore = {
+    insertOnce(key: string): Promise<boolean> | boolean;
+    has?(key: string): Promise<boolean> | boolean;
+};
+export declare const ATM_TEST_WEBHOOK_SECRET = "atm_whsec_test_fixture";
+export declare const ATM_TEST_API_VERSION = "2026-05";
+export declare const ATM_TEST_CREATED = 1780000000;
+export declare function createAtmEventFixture<TData>(options: AtmFixtureOptions & {
+    type: AtmTestWebhookEventType;
+    data: TData;
+}): AtmSignedFixture<TData>;
+export declare function createPaymentCompletedFixture(options?: AtmFixtureOptions & {
+    payment?: Partial<AtmPaymentCompletedFixtureData["payment"]>;
+}): AtmSignedFixture<AtmPaymentCompletedFixtureData>;
+export declare function createPaymentFailedFixture(options?: AtmFixtureOptions & {
+    payment?: Partial<AtmPaymentFailedFixtureData["payment"]>;
+}): AtmSignedFixture<AtmPaymentFailedFixtureData>;
+export declare function createPaymentRefundedFixture(options?: AtmFixtureOptions & {
+    payment?: Partial<AtmPaymentRefundedFixtureData["payment"]>;
+}): AtmSignedFixture<AtmPaymentRefundedFixtureData>;
+export declare function createPaymentDisputedFixture(options?: AtmFixtureOptions & {
+    payment?: Partial<AtmPaymentDisputedFixtureData["payment"]>;
+}): AtmSignedFixture<AtmPaymentDisputedFixtureData>;
+export declare function createSubscriptionUpdatedFixture(options?: AtmFixtureOptions & {
+    subscription?: Partial<AtmSubscriptionUpdatedFixtureData["subscription"]>;
+}): AtmSignedFixture<AtmSubscriptionUpdatedFixtureData>;
+export declare function createTicketsIssuedFixture(options?: AtmFixtureOptions & {
+    ticket?: Partial<AtmTicketsIssuedFixtureData>;
+}): AtmSignedFixture<AtmTicketsIssuedFixtureData>;
+export declare function createProductArchivedFixture(options?: AtmFixtureOptions & {
+    product?: Partial<AtmProductArchivedFixtureData["product"]>;
+}): AtmSignedFixture<AtmProductArchivedFixtureData>;
+export declare function createTicketCheckedInFixture(options?: AtmFixtureOptions & {
+    ticket?: Partial<AtmTicketCheckedInFixtureData["ticket"]>;
+}): AtmSignedFixture<AtmTicketCheckedInFixtureData>;
+export declare function signAtmFixture(options: {
+    rawBody: string;
+    deliveryId: string;
+    secret?: string;
+    timestamp?: number;
+}): string;
+export declare function createMemoryReplayStore(initialKeys?: Iterable<string>): AtmReplayStore;
+export declare function createAtmWebhookRequest<TData>(fixture: AtmSignedFixture<TData>, options?: AtmFixtureRequestOptions): Request;
+export declare function assertFreshDelivery(store: AtmReplayStore, deliveryId: string): Promise<void>;
+export declare function createAtmIdempotencyKey(parts: Array<string | number | boolean | null | undefined>): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,256 @@
+import { createHmac } from "node:crypto";
+export const ATM_TEST_WEBHOOK_SECRET = "atm_whsec_test_fixture";
+export const ATM_TEST_API_VERSION = "2026-05";
+export const ATM_TEST_CREATED = 1_780_000_000;
+export function createAtmEventFixture(options) {
+    return createSignedFixture({
+        type: options.type,
+        options,
+        data: options.data,
+    });
+}
+export function createPaymentCompletedFixture(options = {}) {
+    return createAtmEventFixture({
+        type: "payment.completed",
+        ...options,
+        data: {
+            payment: {
+                id: options.payment?.id ?? "pay_fixture_123",
+                amountCents: options.payment?.amountCents ?? 1200,
+                currency: options.payment?.currency ?? "usd",
+                status: "completed",
+                paymentType: options.payment?.paymentType ?? "shop",
+                payerDid: options.payment?.payerDid ?? "did:plc:buyer",
+                recipientDid: options.payment?.recipientDid ?? "did:plc:creator",
+                appDid: options.payment?.appDid ?? "did:plc:app",
+                metadata: options.payment?.metadata ?? { appOrderId: "ord_fixture_123" },
+            },
+        },
+    });
+}
+export function createPaymentFailedFixture(options = {}) {
+    return createAtmEventFixture({
+        type: "payment.failed",
+        ...options,
+        data: {
+            payment: {
+                id: options.payment?.id ?? "pay_fixture_failed",
+                amountCents: options.payment?.amountCents ?? 1200,
+                currency: options.payment?.currency ?? "usd",
+                status: "failed",
+                paymentType: options.payment?.paymentType ?? "shop",
+                payerDid: options.payment?.payerDid ?? "did:plc:buyer",
+                recipientDid: options.payment?.recipientDid ?? "did:plc:creator",
+                appDid: options.payment?.appDid ?? "did:plc:app",
+                failureCode: options.payment?.failureCode ?? "card_declined",
+                failureMessage: options.payment?.failureMessage ?? "The payment was declined.",
+                metadata: options.payment?.metadata ?? { appOrderId: "ord_fixture_failed" },
+            },
+        },
+    });
+}
+export function createPaymentRefundedFixture(options = {}) {
+    return createAtmEventFixture({
+        type: "payment.refunded",
+        ...options,
+        data: {
+            payment: {
+                id: options.payment?.id ?? "pay_fixture_refunded",
+                amountCents: options.payment?.amountCents ?? 1200,
+                refundedAmountCents: options.payment?.refundedAmountCents ?? 1200,
+                currency: options.payment?.currency ?? "usd",
+                status: "refunded",
+                paymentType: options.payment?.paymentType ?? "shop",
+                payerDid: options.payment?.payerDid ?? "did:plc:buyer",
+                recipientDid: options.payment?.recipientDid ?? "did:plc:creator",
+                appDid: options.payment?.appDid ?? "did:plc:app",
+                refundId: options.payment?.refundId ?? "ref_fixture_123",
+                metadata: options.payment?.metadata ?? { appOrderId: "ord_fixture_refunded" },
+            },
+        },
+    });
+}
+export function createPaymentDisputedFixture(options = {}) {
+    return createAtmEventFixture({
+        type: "payment.disputed",
+        ...options,
+        data: {
+            payment: {
+                id: options.payment?.id ?? "pay_fixture_disputed",
+                amountCents: options.payment?.amountCents ?? 1200,
+                currency: options.payment?.currency ?? "usd",
+                status: "disputed",
+                paymentType: options.payment?.paymentType ?? "shop",
+                payerDid: options.payment?.payerDid ?? "did:plc:buyer",
+                recipientDid: options.payment?.recipientDid ?? "did:plc:creator",
+                appDid: options.payment?.appDid ?? "did:plc:app",
+                disputeId: options.payment?.disputeId ?? "dp_fixture_123",
+                disputeStatus: options.payment?.disputeStatus ?? "needs_response",
+                metadata: options.payment?.metadata ?? { appOrderId: "ord_fixture_disputed" },
+            },
+        },
+    });
+}
+export function createSubscriptionUpdatedFixture(options = {}) {
+    return createAtmEventFixture({
+        type: "subscription.updated",
+        ...options,
+        data: {
+            subscription: {
+                id: options.subscription?.id ?? "sub_fixture_123",
+                status: options.subscription?.status ?? "active",
+                amountCents: options.subscription?.amountCents ?? 1500,
+                previousAmountCents: options.subscription?.previousAmountCents ?? 500,
+                currency: options.subscription?.currency ?? "usd",
+                interval: options.subscription?.interval ?? "month",
+                payerDid: options.subscription?.payerDid ?? "did:plc:buyer",
+                recipientDid: options.subscription?.recipientDid ?? "did:plc:creator",
+                appDid: options.subscription?.appDid ?? "did:plc:app",
+            },
+        },
+    });
+}
+export function createTicketsIssuedFixture(options = {}) {
+    const tickets = options.ticket?.tickets ?? [
+        {
+            ticketId: "ticket_fixture_123",
+            ticketTierId: "tier_fixture_general",
+            status: "issued",
+        },
+    ];
+    return createAtmEventFixture({
+        type: "tickets.issued",
+        ...options,
+        data: {
+            eventUri: options.ticket?.eventUri ??
+                "at://did:plc:organizer/community.lexicon.calendar.event/demo",
+            holdId: options.ticket?.holdId ?? "hold_fixture_123",
+            paymentId: options.ticket?.paymentId ?? "pay_fixture_123",
+            buyerDid: options.ticket?.buyerDid ?? "did:plc:buyer",
+            issuedCount: options.ticket?.issuedCount ?? tickets.length,
+            tickets,
+        },
+    });
+}
+export function createProductArchivedFixture(options = {}) {
+    const product = {
+        productUri: options.product?.productUri ??
+            "at://did:plc:creator/money.atmosphere.product/product_fixture",
+        appDid: options.product?.appDid ?? "did:plc:app",
+        archivedAt: options.product?.archivedAt ?? "2026-05-01T12:00:00.000Z",
+        metadata: options.product?.metadata ?? { reason: "creator_archived" },
+    };
+    if (options.product?.productCid !== undefined)
+        product.productCid = options.product.productCid;
+    if (options.product?.creatorDid !== undefined)
+        product.creatorDid = options.product.creatorDid;
+    return createAtmEventFixture({
+        type: "product.archived",
+        ...options,
+        data: { product },
+    });
+}
+export function createTicketCheckedInFixture(options = {}) {
+    const ticket = {
+        ticketId: options.ticket?.ticketId ?? "ticket_fixture_123",
+        ticketTierId: options.ticket?.ticketTierId ?? "tier_fixture_general",
+        eventUri: options.ticket?.eventUri ??
+            "at://did:plc:organizer/community.lexicon.calendar.event/demo",
+        checkInListId: options.ticket?.checkInListId ?? "checklist_fixture_123",
+        checkedInAt: options.ticket?.checkedInAt ?? "2026-05-01T12:00:00.000Z",
+        repeat: options.ticket?.repeat ?? false,
+        metadata: options.ticket?.metadata ?? { scannerId: "scanner_fixture_123" },
+    };
+    if (options.ticket?.buyerDid !== undefined)
+        ticket.buyerDid = options.ticket.buyerDid;
+    return createAtmEventFixture({
+        type: "ticket.checked_in",
+        ...options,
+        data: { ticket },
+    });
+}
+export function signAtmFixture(options) {
+    const timestamp = options.timestamp ?? ATM_TEST_CREATED;
+    const secret = options.secret ?? ATM_TEST_WEBHOOK_SECRET;
+    const signedPayload = `${timestamp}.${options.deliveryId}.${options.rawBody}`;
+    const digest = createHmac("sha256", secret)
+        .update(signedPayload)
+        .digest("hex");
+    return `t=${timestamp},v1=${digest}`;
+}
+export function createMemoryReplayStore(initialKeys = []) {
+    const seen = new Set(initialKeys);
+    return {
+        insertOnce(key) {
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        },
+        has(key) {
+            return seen.has(key);
+        },
+    };
+}
+export function createAtmWebhookRequest(fixture, options = {}) {
+    const headers = new Headers(options.headers);
+    for (const [name, value] of Object.entries(fixture.headers)) {
+        headers.set(name, value);
+    }
+    return new Request(options.url ?? "https://app.example/webhooks/atm", {
+        method: options.method ?? "POST",
+        headers,
+        body: fixture.rawBody,
+    });
+}
+export async function assertFreshDelivery(store, deliveryId) {
+    const inserted = await store.insertOnce(deliveryId);
+    if (!inserted) {
+        throw new Error(`Duplicate ATM delivery id: ${deliveryId}`);
+    }
+}
+export function createAtmIdempotencyKey(parts) {
+    const normalized = parts
+        .filter((part) => part !== null && part !== undefined && part !== "")
+        .map((part) => String(part).trim())
+        .join(":");
+    if (!normalized) {
+        throw new Error("At least one idempotency key part is required");
+    }
+    return `atm:test:${normalized}`;
+}
+function createSignedFixture({ type, options, data, }) {
+    const deliveryId = options.deliveryId ?? options.id ?? `del_${type.replace(".", "_")}_fixture`;
+    const id = options.id ?? deliveryId;
+    const created = options.created ?? ATM_TEST_CREATED;
+    const apiVersion = options.apiVersion ?? ATM_TEST_API_VERSION;
+    const environment = options.environment ?? "test";
+    const event = {
+        id,
+        type,
+        created,
+        apiVersion,
+        environment,
+        data,
+    };
+    const rawBody = JSON.stringify(event);
+    const signatureOptions = {
+        rawBody,
+        deliveryId,
+        timestamp: created,
+    };
+    if (options.secret !== undefined)
+        signatureOptions.secret = options.secret;
+    const signature = signAtmFixture(signatureOptions);
+    return {
+        event,
+        rawBody,
+        headers: {
+            "atm-signature": signature,
+            "atm-delivery-id": deliveryId,
+            "atm-event": type,
+            "atm-api-version": apiVersion,
+            "atm-environment": environment,
+        },
+    };
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@atmosphere-money/testing",
+  "version": "0.0.0-beta.0",
+  "description": "Testing fixtures and assertions for Atmosphere Money app integrations.",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "sideEffects": false,
+  "homepage": "https://atmosphere.money/docs/testing-package",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Atmosphere-Money/ATM.git",
+    "directory": "packages/testing"
+  },
+  "bugs": {
+    "url": "https://github.com/Atmosphere-Money/ATM/issues"
+  },
+  "keywords": [
+    "atmosphere-money",
+    "at-protocol",
+    "atproto",
+    "payments",
+    "webhooks",
+    "fixtures",
+    "testing"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+    "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsx test/index.test.ts",
+    "api:snapshot": "node ../../scripts/check-sdk-api-snapshot.mjs packages/testing --write",
+    "api:check": "node ../../scripts/check-sdk-api-snapshot.mjs packages/testing",
+    "check": "npm run build && npm run api:check && npm run test && npm run release:check && npm run pack:dry-run",
+    "release:check": "node scripts/check-release.mjs",
+    "publish:check": "ATM_TESTING_PUBLISH=1 node scripts/check-release.mjs && npm run pack:dry-run",
+    "pack:dry-run": "npm pack --dry-run",
+    "prepare": "npm run build",
+    "prepack": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.22.3",
+    "typescript": "^5.7.2"
+  }
+}