better-ship 0.37.0 → 0.38.0

package/dist/{outbox-repository-options-A2fA1UDX.d.ts → outbox-repository-options-q-CGUoCr.d.ts}

@@ -1,5 +1,5 @@
-import "./index-DUFS0SJ_.js";
-import { F as IEventCollector } from "./index-BosM_da2.js";
+import "./index-CtIdbnEZ.js";
+import { F as IEventCollector } from "./index-BMY7ylgk.js";
 import { BatchItem } from "drizzle-orm/batch";
 //#region src/infrastructure/drizzle-schema.d.ts
 /**
@@ -23,4 +23,4 @@ declare const OUTBOX_REPOSITORY_DEFAULTS: {
 type OutboxRepositoryOptions = Readonly<Partial<typeof OUTBOX_REPOSITORY_DEFAULTS>>;
 //#endregion
 export { eventCollector as n, DrizzleSchema as r, OutboxRepositoryOptions as t };
-//# sourceMappingURL=outbox-repository-options-A2fA1UDX.d.ts.map
+//# sourceMappingURL=outbox-repository-options-q-CGUoCr.d.ts.map

package/dist/{outbox-repository-options-A2fA1UDX.d.ts.map → outbox-repository-options-q-CGUoCr.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"outbox-repository-options-A2fA1UDX.d.ts","names":[],"sources":["../src/infrastructure/drizzle-schema.ts","../src/infrastructure/unit-of-work-context.ts","../src/infrastructure/outbox-repository-options.ts"],"mappings":";;;;;;;;KAKY,gBAAgB;;;;cCuBf,gBAAgB;;;;cC3BhB;EACX;EACA;EACA;;;KAIU,0BAA0B,SAAS,eAAe"}
+{"version":3,"file":"outbox-repository-options-q-CGUoCr.d.ts","names":[],"sources":["../src/infrastructure/drizzle-schema.ts","../src/infrastructure/unit-of-work-context.ts","../src/infrastructure/outbox-repository-options.ts"],"mappings":";;;;;;;;KAKY,gBAAgB;;;;cCuBf,gBAAgB;;;;cC3BhB;EACX;EACA;EACA;;;KAIU,0BAA0B,SAAS,eAAe"}

package/dist/{payment-service.error-CqF7GkNp.js → payment-service.error-BR10zqxk.js}

@@ -1,4 +1,4 @@
-import { nt as AppError } from "./core-BiN6S_cm.js";
+import { tt as AppError } from "./core-DOBZeYSX.js";
 import Stripe from "stripe";
 
 //#region src/infrastructure/stripe/payment-service.error.ts
@@ -27,4 +27,4 @@ function classifyStripeError(error) {
 
 //#endregion
 export { PaymentServiceError as t };
-//# sourceMappingURL=payment-service.error-CqF7GkNp.js.map
+//# sourceMappingURL=payment-service.error-BR10zqxk.js.map

package/dist/{payment-service.error-CqF7GkNp.js.map → payment-service.error-BR10zqxk.js.map}

@@ -1 +1 @@
-{"version":3,"file":"payment-service.error-CqF7GkNp.js","names":[],"sources":["../src/infrastructure/stripe/payment-service.error.ts"],"sourcesContent":["import Stripe from 'stripe'\n\nimport { AppError, type FailureClassification } from '@/core'\n\n/** A final Stripe request failure. The caller logs once; native details remain in cause. */\nexport class PaymentServiceError extends AppError {\n  readonly _tag = 'PaymentServiceError'\n  readonly classification: FailureClassification\n\n  /** Classify the final SDK error without scheduling another payment attempt. */\n  constructor(\n    readonly operation: string,\n    cause: Stripe.errors.StripeError,\n  ) {\n    super(`Stripe request failed: ${operation}`, { cause })\n    this.classification = classifyStripeError(cause)\n  }\n}\n\nfunction classifyStripeError(error: Stripe.errors.StripeError): FailureClassification {\n  if (error.headers?.['stripe-should-retry'] === 'false') return 'terminal'\n  const status = error.statusCode\n  if (status !== undefined && status >= 400 && status < 500 && status !== 409 && status !== 429)\n    return 'terminal'\n  if (\n    error instanceof Stripe.errors.StripeAuthenticationError ||\n    error instanceof Stripe.errors.StripePermissionError ||\n    error instanceof Stripe.errors.StripeInvalidRequestError ||\n    error instanceof Stripe.errors.StripeIdempotencyError ||\n    error instanceof Stripe.errors.StripeCardError\n  )\n    return 'terminal'\n  if (error.headers?.['stripe-should-retry'] === 'true') return 'transient'\n  if (status === 409 || status === 429 || (status !== undefined && status >= 500))\n    return 'transient'\n  if (\n    error instanceof Stripe.errors.StripeConnectionError ||\n    error instanceof Stripe.errors.StripeAPIError ||\n    error instanceof Stripe.errors.StripeRateLimitError\n  )\n    return 'transient'\n  return 'unknown'\n}\n"],"mappings":";;;;;AAKA,IAAa,sBAAb,cAAyC,SAAS;CAMrC;CALX,AAAS,OAAO;CAChB,AAAS;;CAGT,YACE,AAAS,WACT,OACA;EACA,MAAM,0BAA0B,aAAa,EAAE,MAAM,CAAC;EAH7C;EAIT,KAAK,iBAAiB,oBAAoB,KAAK;CACjD;AACF;AAEA,SAAS,oBAAoB,OAAyD;CACpF,IAAI,MAAM,UAAU,2BAA2B,SAAS,OAAO;CAC/D,MAAM,SAAS,MAAM;CACrB,IAAI,WAAW,UAAa,UAAU,OAAO,SAAS,OAAO,WAAW,OAAO,WAAW,KACxF,OAAO;CACT,IACE,iBAAiB,OAAO,OAAO,6BAC/B,iBAAiB,OAAO,OAAO,yBAC/B,iBAAiB,OAAO,OAAO,6BAC/B,iBAAiB,OAAO,OAAO,0BAC/B,iBAAiB,OAAO,OAAO,iBAE/B,OAAO;CACT,IAAI,MAAM,UAAU,2BAA2B,QAAQ,OAAO;CAC9D,IAAI,WAAW,OAAO,WAAW,OAAQ,WAAW,UAAa,UAAU,KACzE,OAAO;CACT,IACE,iBAAiB,OAAO,OAAO,yBAC/B,iBAAiB,OAAO,OAAO,kBAC/B,iBAAiB,OAAO,OAAO,sBAE/B,OAAO;CACT,OAAO;AACT"}
+{"version":3,"file":"payment-service.error-BR10zqxk.js","names":[],"sources":["../src/infrastructure/stripe/payment-service.error.ts"],"sourcesContent":["import Stripe from 'stripe'\n\nimport { AppError, type FailureClassification } from '@/core'\n\n/** A final Stripe request failure. The caller logs once; native details remain in cause. */\nexport class PaymentServiceError extends AppError {\n  readonly _tag = 'PaymentServiceError'\n  readonly classification: FailureClassification\n\n  /** Classify the final SDK error without scheduling another payment attempt. */\n  constructor(\n    readonly operation: string,\n    cause: Stripe.errors.StripeError,\n  ) {\n    super(`Stripe request failed: ${operation}`, { cause })\n    this.classification = classifyStripeError(cause)\n  }\n}\n\nfunction classifyStripeError(error: Stripe.errors.StripeError): FailureClassification {\n  if (error.headers?.['stripe-should-retry'] === 'false') return 'terminal'\n  const status = error.statusCode\n  if (status !== undefined && status >= 400 && status < 500 && status !== 409 && status !== 429)\n    return 'terminal'\n  if (\n    error instanceof Stripe.errors.StripeAuthenticationError ||\n    error instanceof Stripe.errors.StripePermissionError ||\n    error instanceof Stripe.errors.StripeInvalidRequestError ||\n    error instanceof Stripe.errors.StripeIdempotencyError ||\n    error instanceof Stripe.errors.StripeCardError\n  )\n    return 'terminal'\n  if (error.headers?.['stripe-should-retry'] === 'true') return 'transient'\n  if (status === 409 || status === 429 || (status !== undefined && status >= 500))\n    return 'transient'\n  if (\n    error instanceof Stripe.errors.StripeConnectionError ||\n    error instanceof Stripe.errors.StripeAPIError ||\n    error instanceof Stripe.errors.StripeRateLimitError\n  )\n    return 'transient'\n  return 'unknown'\n}\n"],"mappings":";;;;;AAKA,IAAa,sBAAb,cAAyC,SAAS;CAMrC;CALX,AAAS,OAAO;CAChB,AAAS;;CAGT,YACE,AAAS,WACT,OACA;EACA,MAAM,0BAA0B,aAAa,EAAE,MAAM,CAAC;EAH7C;EAIT,KAAK,iBAAiB,oBAAoB,KAAK;CACjD;AACF;AAEA,SAAS,oBAAoB,OAAyD;CACpF,IAAI,MAAM,UAAU,2BAA2B,SAAS,OAAO;CAC/D,MAAM,SAAS,MAAM;CACrB,IAAI,WAAW,UAAa,UAAU,OAAO,SAAS,OAAO,WAAW,OAAO,WAAW,KACxF,OAAO;CACT,IACE,iBAAiB,OAAO,OAAO,6BAC/B,iBAAiB,OAAO,OAAO,yBAC/B,iBAAiB,OAAO,OAAO,6BAC/B,iBAAiB,OAAO,OAAO,0BAC/B,iBAAiB,OAAO,OAAO,iBAE/B,OAAO;CACT,IAAI,MAAM,UAAU,2BAA2B,QAAQ,OAAO;CAC9D,IAAI,WAAW,OAAO,WAAW,OAAQ,WAAW,UAAa,UAAU,KACzE,OAAO;CACT,IACE,iBAAiB,OAAO,OAAO,yBAC/B,iBAAiB,OAAO,OAAO,kBAC/B,iBAAiB,OAAO,OAAO,sBAE/B,OAAO;CACT,OAAO;AACT"}

package/dist/postgres.d.ts

@@ -1,6 +1,6 @@
-import { W as DomainEvent, Xt as AppError, nt as DatabaseFailure, q as MessageId, tt as DatabaseError } from "./index-DUFS0SJ_.js";
-import { A as IOutboxRepository, M as OutboxClaim, N as OutboxMessage, P as IMessageStore, k as DeadLetterReason, w as ITransaction } from "./index-BosM_da2.js";
-import { n as eventCollector, r as DrizzleSchema, t as OutboxRepositoryOptions } from "./outbox-repository-options-A2fA1UDX.js";
+import { Jt as AppError, W as DomainEvent, nt as DatabaseFailure, q as MessageId, tt as DatabaseError } from "./index-CtIdbnEZ.js";
+import { A as IOutboxRepository, M as OutboxClaim, N as OutboxMessage, P as IMessageStore, k as DeadLetterReason, w as ITransaction } from "./index-BMY7ylgk.js";
+import { n as eventCollector, r as DrizzleSchema, t as OutboxRepositoryOptions } from "./outbox-repository-options-q-CGUoCr.js";
 import { ExtractTablesWithRelations } from "drizzle-orm";
 import { NodePgDatabase, NodePgTransaction } from "drizzle-orm/node-postgres";
 import { Pool } from "pg";

package/dist/postgres.js

@@ -1,6 +1,6 @@
-import { O as DatabaseError, nt as AppError, s as exponentialDelayCapMs } from "./core-BiN6S_cm.js";
-import { o as MessageAlreadyProcessedError } from "./application-B5hnNUdI.js";
-import { i as runWithUnitOfWorkContext, r as eventCollector, t as OUTBOX_REPOSITORY_DEFAULTS } from "./outbox-repository-options-BNpCWTht.js";
+import { O as DatabaseError, s as exponentialDelayCapMs, tt as AppError } from "./core-DOBZeYSX.js";
+import { o as MessageAlreadyProcessedError } from "./application-Dsz-o9Aj.js";
+import { i as runWithUnitOfWorkContext, r as eventCollector, t as OUTBOX_REPOSITORY_DEFAULTS } from "./outbox-repository-options-Ca67c3c9.js";
 import { Result } from "better-result";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { DrizzleQueryError } from "drizzle-orm/errors";

package/dist/posthog/metrics.d.ts

@@ -1,2 +1,2 @@
-import { t as PostHogMetricsService } from "../metrics-B89jvpZQ.js";
+import { t as PostHogMetricsService } from "../metrics-CdTF_lWR.js";
 export { PostHogMetricsService };

package/dist/posthog/server.d.ts

@@ -1,6 +1,6 @@
-import { Gt as AnalyticsEventIdentity, Kt as AnalyticsEventInput, qt as AnalyticsProperties } from "../index-DUFS0SJ_.js";
-import { tt as AnalyticsService } from "../index-BosM_da2.js";
-import { t as PostHogMetricsService } from "../metrics-B89jvpZQ.js";
+import { Kt as AnalyticsTarget, Ut as AnalyticsEventInput, Wt as AnalyticsProperties } from "../index-CtIdbnEZ.js";
+import { nt as AnalyticsService } from "../index-BMY7ylgk.js";
+import { t as PostHogMetricsService } from "../metrics-CdTF_lWR.js";
 import { PostHog, PostHogOptions } from "posthog-node";
 //#region src/infrastructure/posthog/server.d.ts
 /** Deployment values and SDK options; the runtime owns delivery promises. */
@@ -27,10 +27,10 @@ export declare class PostHogAnalyticsService implements AnalyticsService {
   identify(distinctId: string, properties?: AnalyticsProperties): void;
   /** Schedule an irreversible person merge; only alias IDs the application proves belong to one person. */
   alias(distinctId: string, previousDistinctId: string): void;
-  /** Schedule an event; omit identity for SDK-generated UUID and capture time. */
-  track(event: AnalyticsEventInput, distinctId: string, identity?: AnalyticsEventIdentity): void;
+  /** Schedule an event; without an event ID the SDK sets a new UUID and the capture time. */
+  track(name: string, properties: AnalyticsEventInput['properties'], target: AnalyticsTarget): void;
   /** Schedule an event without creating a person profile for an attempt or resource ID. */
-  trackAnonymous(event: AnalyticsEventInput, distinctId: string, identity?: AnalyticsEventIdentity): void;
+  trackAnonymous(name: string, properties: AnalyticsEventInput['properties'], target: AnalyticsTarget): void;
   private capture;
 }
 //#endregion

package/dist/posthog/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","names":[],"sources":["../../src/infrastructure/posthog/server.ts"],"mappings":";;;;;;iBAaiB;WACN;WACA;WACA;WACA,YAAY,SAAS;WACrB,UAAU,KACjB;aAGS,UAAU,KAAK,YAAY;;;;qBAK3B,mCAAmC;;WAMnC,SAAS;mBACD;;WALV,SAAS;UAEX;;SASA,OAAO,QAAQ,yBAAyB;;EAqB/C,SAAS,oBAAoB,aAAa;;EAO1C,MAAM,oBAAoB;;EAK1B,MAAM,OAAO,qBAAqB,oBAAoB,WAAW;;EAKjE,eACE,OAAO,qBACP,oBACA,WAAW;UAKL"}
+{"version":3,"file":"server.d.ts","names":[],"sources":["../../src/infrastructure/posthog/server.ts"],"mappings":";;;;;;iBAiBiB;WACN;WACA;WACA;WACA,YAAY,SAAS;WACrB,UAAU,KACjB;aAGS,UAAU,KAAK,YAAY;;;;qBAK3B,mCAAmC;;WAMnC,SAAS;mBACD;;WALV,SAAS;UAEX;;SASA,OAAO,QAAQ,yBAAyB;;EAqB/C,SAAS,oBAAoB,aAAa;;EAO1C,MAAM,oBAAoB;;EAK1B,MACE,cACA,YAAY,mCACZ,QAAQ;;EAMV,eACE,cACA,YAAY,mCACZ,QAAQ;UAKF"}

package/dist/posthog/server.js

@@ -1,8 +1,10 @@
-import { tt as MissingConfigurationError } from "../core-BiN6S_cm.js";
+import { et as MissingConfigurationError } from "../core-DOBZeYSX.js";
 import { t as PostHogMetricsService } from "../metrics-CWv37yf9.js";
+import { v5, validate } from "uuid";
 import { PostHog } from "posthog-node";
 
 //#region src/infrastructure/posthog/server.ts
+const EVENT_ID_NAMESPACE = "53d7af30-65cb-4176-b2c9-f1ed42367ab1";
 /** Worker analytics ported from Typist; disabled applications select Porte's NULL_ANALYTICS instead. */
 var PostHogAnalyticsService = class PostHogAnalyticsService {
 	posthog;
@@ -49,28 +51,28 @@ var PostHogAnalyticsService = class PostHogAnalyticsService {
 			alias: previousDistinctId
 		}));
 	}
-	/** Schedule an event; omit identity for SDK-generated UUID and capture time. */
-	track(event, distinctId, identity) {
-		this.capture(event, distinctId, "person", identity);
+	/** Schedule an event; without an event ID the SDK sets a new UUID and the capture time. */
+	track(name, properties, target) {
+		this.capture(name, properties, target, "person");
 	}
 	/** Schedule an event without creating a person profile for an attempt or resource ID. */
-	trackAnonymous(event, distinctId, identity) {
-		this.capture(event, distinctId, "anonymous", identity);
+	trackAnonymous(name, properties, target) {
+		this.capture(name, properties, target, "anonymous");
 	}
-	capture(event, distinctId, profile, identity) {
-		const properties = { ...event.properties };
+	capture(name, eventProperties, target, profile) {
+		const properties = { ...eventProperties };
 		const payload = {
-			distinctId,
-			event: event.name,
+			distinctId: target.distinctId,
+			event: name,
 			properties
 		};
 		if (profile === "anonymous") payload.properties = {
 			...properties,
 			$process_person_profile: false
 		};
-		if (identity !== void 0) {
-			payload.uuid = identity.uuid;
-			payload.timestamp = identity.timestamp;
+		if (target.eventId !== void 0) {
+			payload.uuid = validate(target.eventId) ? target.eventId : v5(target.eventId, EVENT_ID_NAMESPACE);
+			payload.timestamp = new Date(target.occurredAt);
 		}
 		this.waitUntil(this.posthog.captureImmediate(payload));
 	}

package/dist/posthog/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../../src/infrastructure/posthog/server.ts"],"sourcesContent":["import { PostHog, type PostHogOptions } from 'posthog-node'\n\nimport type { AnalyticsService } from '@/application'\nimport {\n  MissingConfigurationError,\n  type AnalyticsEventIdentity,\n  type AnalyticsEventInput,\n  type AnalyticsProperties,\n} from '@/core'\n\nimport { PostHogMetricsService } from './metrics.ts'\n\n/** Deployment values and SDK options; the runtime owns delivery promises. */\nexport interface PostHogAnalyticsConfig {\n  readonly apiKey: string\n  readonly environment: string\n  readonly source: string\n  readonly waitUntil: (promise: Promise<unknown>) => void\n  readonly options?: Omit<\n    PostHogOptions,\n    'waitUntil' | 'flushAt' | 'flushInterval' | 'metrics' | 'disabled'\n  > & {\n    readonly metrics?: Omit<NonNullable<PostHogOptions['metrics']>, 'serviceName' | 'environment'>\n  }\n}\n\n/** Worker analytics ported from Typist; disabled applications select Porte's NULL_ANALYTICS instead. */\nexport class PostHogAnalyticsService implements AnalyticsService {\n  /** Metrics share this service's SDK client and delivery lifetime. */\n  readonly metrics: PostHogMetricsService\n\n  private constructor(\n    /** Raw SDK access for integrations such as PostHog AI tracing. */\n    readonly posthog: PostHog,\n    private readonly waitUntil: (promise: Promise<unknown>) => void,\n  ) {\n    this.metrics = new PostHogMetricsService(posthog, waitUntil)\n  }\n\n  /** Construct once per Worker invocation; a blank key throws MissingConfigurationError. */\n  static create(config: PostHogAnalyticsConfig): PostHogAnalyticsService {\n    const apiKey = config.apiKey.trim()\n    if (apiKey.length === 0) throw new MissingConfigurationError('POSTHOG_API_KEY')\n    const client = new PostHog(apiKey, {\n      host: 'https://us.i.posthog.com',\n      ...config.options,\n      flushAt: 1,\n      flushInterval: 0,\n      waitUntil: config.waitUntil,\n      metrics: {\n        ...config.options?.metrics,\n        environment: config.environment,\n        serviceName: config.source,\n      },\n    })\n    // The SDK applies in-memory super properties synchronously before this promise resolves.\n    void client.register({ environment: config.environment, source: config.source })\n    return new PostHogAnalyticsService(client, config.waitUntil)\n  }\n\n  /** Schedule person properties; the SDK's waitUntil option protects queued delivery. */\n  identify(distinctId: string, properties?: AnalyticsProperties): void {\n    const payload: Parameters<PostHog['identify']>[0] = { distinctId }\n    if (properties !== undefined) payload.properties = properties\n    this.posthog.identify(payload)\n  }\n\n  /** Schedule an irreversible person merge; only alias IDs the application proves belong to one person. */\n  alias(distinctId: string, previousDistinctId: string): void {\n    this.waitUntil(this.posthog.aliasImmediate({ distinctId, alias: previousDistinctId }))\n  }\n\n  /** Schedule an event; omit identity for SDK-generated UUID and capture time. */\n  track(event: AnalyticsEventInput, distinctId: string, identity?: AnalyticsEventIdentity): void {\n    this.capture(event, distinctId, 'person', identity)\n  }\n\n  /** Schedule an event without creating a person profile for an attempt or resource ID. */\n  trackAnonymous(\n    event: AnalyticsEventInput,\n    distinctId: string,\n    identity?: AnalyticsEventIdentity,\n  ): void {\n    this.capture(event, distinctId, 'anonymous', identity)\n  }\n\n  private capture(\n    event: AnalyticsEventInput,\n    distinctId: string,\n    profile: 'person' | 'anonymous',\n    identity?: AnalyticsEventIdentity,\n  ): void {\n    const properties = { ...event.properties }\n    const payload: Parameters<PostHog['captureImmediate']>[0] = {\n      distinctId,\n      event: event.name,\n      properties,\n    }\n    if (profile === 'anonymous')\n      payload.properties = { ...properties, $process_person_profile: false }\n    if (identity !== undefined) {\n      payload.uuid = identity.uuid\n      payload.timestamp = identity.timestamp\n    }\n    this.waitUntil(this.posthog.captureImmediate(payload))\n  }\n}\n"],"mappings":";;;;;;AA2BA,IAAa,0BAAb,MAAa,wBAAoD;CAMpD;CACQ;;CALnB,AAAS;CAET,AAAQ,YAEN,AAAS,SACT,AAAiB,WACjB;EAFS;EACQ;EAEjB,KAAK,UAAU,IAAI,sBAAsB,SAAS,SAAS;CAC7D;;CAGA,OAAO,OAAO,QAAyD;EACrE,MAAM,SAAS,OAAO,OAAO,KAAK;EAClC,IAAI,OAAO,WAAW,GAAG,MAAM,IAAI,0BAA0B,iBAAiB;EAC9E,MAAM,SAAS,IAAI,QAAQ,QAAQ;GACjC,MAAM;GACN,GAAG,OAAO;GACV,SAAS;GACT,eAAe;GACf,WAAW,OAAO;GAClB,SAAS;IACP,GAAG,OAAO,SAAS;IACnB,aAAa,OAAO;IACpB,aAAa,OAAO;GACtB;EACF,CAAC;EAED,AAAK,OAAO,SAAS;GAAE,aAAa,OAAO;GAAa,QAAQ,OAAO;EAAO,CAAC;EAC/E,OAAO,IAAI,wBAAwB,QAAQ,OAAO,SAAS;CAC7D;;CAGA,SAAS,YAAoB,YAAwC;EACnE,MAAM,UAA8C,EAAE,WAAW;EACjE,IAAI,eAAe,QAAW,QAAQ,aAAa;EACnD,KAAK,QAAQ,SAAS,OAAO;CAC/B;;CAGA,MAAM,YAAoB,oBAAkC;EAC1D,KAAK,UAAU,KAAK,QAAQ,eAAe;GAAE;GAAY,OAAO;EAAmB,CAAC,CAAC;CACvF;;CAGA,MAAM,OAA4B,YAAoB,UAAyC;EAC7F,KAAK,QAAQ,OAAO,YAAY,UAAU,QAAQ;CACpD;;CAGA,eACE,OACA,YACA,UACM;EACN,KAAK,QAAQ,OAAO,YAAY,aAAa,QAAQ;CACvD;CAEA,AAAQ,QACN,OACA,YACA,SACA,UACM;EACN,MAAM,aAAa,EAAE,GAAG,MAAM,WAAW;EACzC,MAAM,UAAsD;GAC1D;GACA,OAAO,MAAM;GACb;EACF;EACA,IAAI,YAAY,aACd,QAAQ,aAAa;GAAE,GAAG;GAAY,yBAAyB;EAAM;EACvE,IAAI,aAAa,QAAW;GAC1B,QAAQ,OAAO,SAAS;GACxB,QAAQ,YAAY,SAAS;EAC/B;EACA,KAAK,UAAU,KAAK,QAAQ,iBAAiB,OAAO,CAAC;CACvD;AACF"}
+{"version":3,"file":"server.js","names":["isUuid","uuidv5"],"sources":["../../src/infrastructure/posthog/server.ts"],"sourcesContent":["import { PostHog, type PostHogOptions } from 'posthog-node'\nimport { validate as isUuid, v5 as uuidv5 } from 'uuid'\n\nimport type { AnalyticsService } from '@/application'\nimport {\n  MissingConfigurationError,\n  type AnalyticsEventInput,\n  type AnalyticsProperties,\n  type AnalyticsTarget,\n} from '@/core'\n\nimport { PostHogMetricsService } from './metrics.ts'\n\n// Fixed forever: changing it changes every derived UUID, so PostHog would keep a repeat.\nconst EVENT_ID_NAMESPACE = '53d7af30-65cb-4176-b2c9-f1ed42367ab1'\n\n/** Deployment values and SDK options; the runtime owns delivery promises. */\nexport interface PostHogAnalyticsConfig {\n  readonly apiKey: string\n  readonly environment: string\n  readonly source: string\n  readonly waitUntil: (promise: Promise<unknown>) => void\n  readonly options?: Omit<\n    PostHogOptions,\n    'waitUntil' | 'flushAt' | 'flushInterval' | 'metrics' | 'disabled'\n  > & {\n    readonly metrics?: Omit<NonNullable<PostHogOptions['metrics']>, 'serviceName' | 'environment'>\n  }\n}\n\n/** Worker analytics ported from Typist; disabled applications select Porte's NULL_ANALYTICS instead. */\nexport class PostHogAnalyticsService implements AnalyticsService {\n  /** Metrics share this service's SDK client and delivery lifetime. */\n  readonly metrics: PostHogMetricsService\n\n  private constructor(\n    /** Raw SDK access for integrations such as PostHog AI tracing. */\n    readonly posthog: PostHog,\n    private readonly waitUntil: (promise: Promise<unknown>) => void,\n  ) {\n    this.metrics = new PostHogMetricsService(posthog, waitUntil)\n  }\n\n  /** Construct once per Worker invocation; a blank key throws MissingConfigurationError. */\n  static create(config: PostHogAnalyticsConfig): PostHogAnalyticsService {\n    const apiKey = config.apiKey.trim()\n    if (apiKey.length === 0) throw new MissingConfigurationError('POSTHOG_API_KEY')\n    const client = new PostHog(apiKey, {\n      host: 'https://us.i.posthog.com',\n      ...config.options,\n      flushAt: 1,\n      flushInterval: 0,\n      waitUntil: config.waitUntil,\n      metrics: {\n        ...config.options?.metrics,\n        environment: config.environment,\n        serviceName: config.source,\n      },\n    })\n    // The SDK applies in-memory super properties synchronously before this promise resolves.\n    void client.register({ environment: config.environment, source: config.source })\n    return new PostHogAnalyticsService(client, config.waitUntil)\n  }\n\n  /** Schedule person properties; the SDK's waitUntil option protects queued delivery. */\n  identify(distinctId: string, properties?: AnalyticsProperties): void {\n    const payload: Parameters<PostHog['identify']>[0] = { distinctId }\n    if (properties !== undefined) payload.properties = properties\n    this.posthog.identify(payload)\n  }\n\n  /** Schedule an irreversible person merge; only alias IDs the application proves belong to one person. */\n  alias(distinctId: string, previousDistinctId: string): void {\n    this.waitUntil(this.posthog.aliasImmediate({ distinctId, alias: previousDistinctId }))\n  }\n\n  /** Schedule an event; without an event ID the SDK sets a new UUID and the capture time. */\n  track(\n    name: string,\n    properties: AnalyticsEventInput['properties'],\n    target: AnalyticsTarget,\n  ): void {\n    this.capture(name, properties, target, 'person')\n  }\n\n  /** Schedule an event without creating a person profile for an attempt or resource ID. */\n  trackAnonymous(\n    name: string,\n    properties: AnalyticsEventInput['properties'],\n    target: AnalyticsTarget,\n  ): void {\n    this.capture(name, properties, target, 'anonymous')\n  }\n\n  private capture(\n    name: string,\n    eventProperties: AnalyticsEventInput['properties'],\n    target: AnalyticsTarget,\n    profile: 'person' | 'anonymous',\n  ): void {\n    const properties = { ...eventProperties }\n    const payload: Parameters<PostHog['captureImmediate']>[0] = {\n      distinctId: target.distinctId,\n      event: name,\n      properties,\n    }\n    if (profile === 'anonymous')\n      payload.properties = { ...properties, $process_person_profile: false }\n    if (target.eventId !== undefined) {\n      // PostHog drops a repeat only when its uuid and timestamp match the first event.\n      payload.uuid = isUuid(target.eventId)\n        ? target.eventId\n        : uuidv5(target.eventId, EVENT_ID_NAMESPACE)\n      payload.timestamp = new Date(target.occurredAt)\n    }\n    this.waitUntil(this.posthog.captureImmediate(payload))\n  }\n}\n"],"mappings":";;;;;;AAcA,MAAM,qBAAqB;;AAiB3B,IAAa,0BAAb,MAAa,wBAAoD;CAMpD;CACQ;;CALnB,AAAS;CAET,AAAQ,YAEN,AAAS,SACT,AAAiB,WACjB;EAFS;EACQ;EAEjB,KAAK,UAAU,IAAI,sBAAsB,SAAS,SAAS;CAC7D;;CAGA,OAAO,OAAO,QAAyD;EACrE,MAAM,SAAS,OAAO,OAAO,KAAK;EAClC,IAAI,OAAO,WAAW,GAAG,MAAM,IAAI,0BAA0B,iBAAiB;EAC9E,MAAM,SAAS,IAAI,QAAQ,QAAQ;GACjC,MAAM;GACN,GAAG,OAAO;GACV,SAAS;GACT,eAAe;GACf,WAAW,OAAO;GAClB,SAAS;IACP,GAAG,OAAO,SAAS;IACnB,aAAa,OAAO;IACpB,aAAa,OAAO;GACtB;EACF,CAAC;EAED,AAAK,OAAO,SAAS;GAAE,aAAa,OAAO;GAAa,QAAQ,OAAO;EAAO,CAAC;EAC/E,OAAO,IAAI,wBAAwB,QAAQ,OAAO,SAAS;CAC7D;;CAGA,SAAS,YAAoB,YAAwC;EACnE,MAAM,UAA8C,EAAE,WAAW;EACjE,IAAI,eAAe,QAAW,QAAQ,aAAa;EACnD,KAAK,QAAQ,SAAS,OAAO;CAC/B;;CAGA,MAAM,YAAoB,oBAAkC;EAC1D,KAAK,UAAU,KAAK,QAAQ,eAAe;GAAE;GAAY,OAAO;EAAmB,CAAC,CAAC;CACvF;;CAGA,MACE,MACA,YACA,QACM;EACN,KAAK,QAAQ,MAAM,YAAY,QAAQ,QAAQ;CACjD;;CAGA,eACE,MACA,YACA,QACM;EACN,KAAK,QAAQ,MAAM,YAAY,QAAQ,WAAW;CACpD;CAEA,AAAQ,QACN,MACA,iBACA,QACA,SACM;EACN,MAAM,aAAa,EAAE,GAAG,gBAAgB;EACxC,MAAM,UAAsD;GAC1D,YAAY,OAAO;GACnB,OAAO;GACP;EACF;EACA,IAAI,YAAY,aACd,QAAQ,aAAa;GAAE,GAAG;GAAY,yBAAyB;EAAM;EACvE,IAAI,OAAO,YAAY,QAAW;GAEhC,QAAQ,OAAOA,SAAO,OAAO,OAAO,IAChC,OAAO,UACPC,GAAO,OAAO,SAAS,kBAAkB;GAC7C,QAAQ,YAAY,IAAI,KAAK,OAAO,UAAU;EAChD;EACA,KAAK,UAAU,KAAK,QAAQ,iBAAiB,OAAO,CAAC;CACvD;AACF"}

package/dist/{r2-errors-rk7n7rvk.js → r2-errors-BF49eqU_.js}

@@ -1,4 +1,4 @@
-import { nt as AppError, u as classifyBoundaryError, v as isAbortError } from "./core-BiN6S_cm.js";
+import { tt as AppError, u as classifyBoundaryError, v as isAbortError } from "./core-DOBZeYSX.js";
 import { z } from "zod";
 
 //#region src/infrastructure/cloudflare/r2-errors.ts
@@ -87,4 +87,4 @@ var R2JsonError = class extends AppError {
 
 //#endregion
 export { R2JsonError as n, R2Error as t };
-//# sourceMappingURL=r2-errors-rk7n7rvk.js.map
+//# sourceMappingURL=r2-errors-BF49eqU_.js.map

package/dist/{r2-errors-rk7n7rvk.js.map → r2-errors-BF49eqU_.js.map}

@@ -1 +1 @@
-{"version":3,"file":"r2-errors-rk7n7rvk.js","names":[],"sources":["../src/infrastructure/cloudflare/r2-errors.ts"],"sourcesContent":["import { z } from 'zod'\n\nimport { AppError, classifyBoundaryError, isAbortError, type FailureClassification } from '@/core'\n\n/** The storage operation that failed. */\nexport type R2Operation =\n  | 'head'\n  | 'get'\n  | 'getJson'\n  | 'put'\n  | 'delete'\n  | 'list'\n  | 'createMultipartUpload'\n  | 'uploadPart'\n  | 'complete'\n  | 'abort'\n\n/** Provider diagnostics from the outer failure, without request bodies or credentials. */\nexport type R2Failure = {\n  readonly code: number\n  readonly action?: string | undefined\n}\n\nconst R2FailureSchema = z.object({\n  code: z.number().int().positive(),\n  action: z.string().optional(),\n})\n\n// R2 codes describe failures; the caller owns retry decisions and repeat safety.\nconst classifications: ReadonlyMap<number, FailureClassification> = new Map([\n  [10001, 'transient'],\n  [10043, 'transient'],\n  [10054, 'transient'],\n  [10058, 'transient'],\n  [10013, 'transient'],\n  [10002, 'terminal'],\n  [10003, 'terminal'],\n  [10018, 'terminal'],\n  [10035, 'terminal'],\n  [10042, 'terminal'],\n  [10005, 'terminal'],\n  [10006, 'terminal'],\n  [10008, 'terminal'],\n  [10009, 'terminal'],\n  [10073, 'terminal'],\n  [10007, 'terminal'],\n  [10020, 'terminal'],\n  [100100, 'terminal'],\n  [10012, 'terminal'],\n  [10069, 'terminal'],\n  [10033, 'terminal'],\n  [10014, 'terminal'],\n  [10037, 'terminal'],\n  [10039, 'terminal'],\n  [10031, 'terminal'],\n  [10011, 'terminal'],\n  [10024, 'terminal'],\n  [10025, 'terminal'],\n  [10048, 'terminal'],\n])\n\nfunction extractR2Failure(cause: unknown): R2Failure | undefined {\n  if (!(cause instanceof Error)) return undefined\n  const parsed = R2FailureSchema.safeParse(cause)\n  if (parsed.success) return parsed.data\n  // Cloudflare documents the numeric suffix for bindings that omit structured fields.\n  const match = /\\((\\d{5,6})\\)\\s*$/.exec(cause.message)\n  return match?.[1] === undefined ? undefined : { code: Number(match[1]) }\n}\n\nfunction classifyR2Code(cause: unknown): FailureClassification | undefined {\n  const failure = extractR2Failure(cause)\n  return failure === undefined ? undefined : (classifications.get(failure.code) ?? 'unknown')\n}\n\nfunction classifyR2Error(cause: unknown): FailureClassification {\n  if (isAbortError(cause)) return 'terminal'\n  if (cause instanceof AppError) return cause.classification\n  return classifyBoundaryError({ cause, classifyBoundary: classifyR2Code, includeCloudflare: true })\n}\n\n/** A raw binding failure after one attempt. Classification does not establish whether a mutation committed. */\nexport class R2Error extends AppError {\n  readonly _tag = 'R2Error'\n  readonly classification: FailureClassification\n  readonly operation: R2Operation\n  readonly r2?: R2Failure | undefined\n  override readonly cause: unknown\n\n  constructor(input: { operation: R2Operation; cause: unknown }) {\n    super(`R2 ${input.operation} failed`, { cause: input.cause })\n    this.operation = input.operation\n    this.cause = input.cause\n    this.r2 = extractR2Failure(input.cause)\n    this.classification = classifyR2Error(input.cause)\n  }\n}\n\n/** JSON serialization or syntax failed. Binding and body-read failures use R2Error. */\nexport class R2JsonError extends AppError {\n  readonly _tag = 'R2JsonError'\n  readonly classification = 'terminal'\n  readonly operation: 'encode' | 'decode'\n  override readonly cause: unknown\n\n  constructor(input: { operation: 'encode' | 'decode'; cause: unknown }) {\n    super(`R2 JSON ${input.operation} failed`, { cause: input.cause })\n    this.operation = input.operation\n    this.cause = input.cause\n  }\n}\n"],"mappings":";;;;AAuBA,MAAM,kBAAkB,EAAE,OAAO;CAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CAChC,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;AAC9B,CAAC;AAGD,MAAM,kCAA8D,IAAI,IAAI;CAC1E,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,QAAQ,UAAU;CACnB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;AACpB,CAAC;AAED,SAAS,iBAAiB,OAAuC;CAC/D,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CACtC,MAAM,SAAS,gBAAgB,UAAU,KAAK;CAC9C,IAAI,OAAO,SAAS,OAAO,OAAO;CAElC,MAAM,QAAQ,oBAAoB,KAAK,MAAM,OAAO;CACpD,OAAO,QAAQ,OAAO,SAAY,SAAY,EAAE,MAAM,OAAO,MAAM,EAAE,EAAE;AACzE;AAEA,SAAS,eAAe,OAAmD;CACzE,MAAM,UAAU,iBAAiB,KAAK;CACtC,OAAO,YAAY,SAAY,SAAa,gBAAgB,IAAI,QAAQ,IAAI,KAAK;AACnF;AAEA,SAAS,gBAAgB,OAAuC;CAC9D,IAAI,aAAa,KAAK,GAAG,OAAO;CAChC,IAAI,iBAAiB,UAAU,OAAO,MAAM;CAC5C,OAAO,sBAAsB;EAAE;EAAO,kBAAkB;EAAgB,mBAAmB;CAAK,CAAC;AACnG;;AAGA,IAAa,UAAb,cAA6B,SAAS;CACpC,AAAS,OAAO;CAChB,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAkB;CAElB,YAAY,OAAmD;EAC7D,MAAM,MAAM,MAAM,UAAU,UAAU,EAAE,OAAO,MAAM,MAAM,CAAC;EAC5D,KAAK,YAAY,MAAM;EACvB,KAAK,QAAQ,MAAM;EACnB,KAAK,KAAK,iBAAiB,MAAM,KAAK;EACtC,KAAK,iBAAiB,gBAAgB,MAAM,KAAK;CACnD;AACF;;AAGA,IAAa,cAAb,cAAiC,SAAS;CACxC,AAAS,OAAO;CAChB,AAAS,iBAAiB;CAC1B,AAAS;CACT,AAAkB;CAElB,YAAY,OAA2D;EACrE,MAAM,WAAW,MAAM,UAAU,UAAU,EAAE,OAAO,MAAM,MAAM,CAAC;EACjE,KAAK,YAAY,MAAM;EACvB,KAAK,QAAQ,MAAM;CACrB;AACF"}
+{"version":3,"file":"r2-errors-BF49eqU_.js","names":[],"sources":["../src/infrastructure/cloudflare/r2-errors.ts"],"sourcesContent":["import { z } from 'zod'\n\nimport { AppError, classifyBoundaryError, isAbortError, type FailureClassification } from '@/core'\n\n/** The storage operation that failed. */\nexport type R2Operation =\n  | 'head'\n  | 'get'\n  | 'getJson'\n  | 'put'\n  | 'delete'\n  | 'list'\n  | 'createMultipartUpload'\n  | 'uploadPart'\n  | 'complete'\n  | 'abort'\n\n/** Provider diagnostics from the outer failure, without request bodies or credentials. */\nexport type R2Failure = {\n  readonly code: number\n  readonly action?: string | undefined\n}\n\nconst R2FailureSchema = z.object({\n  code: z.number().int().positive(),\n  action: z.string().optional(),\n})\n\n// R2 codes describe failures; the caller owns retry decisions and repeat safety.\nconst classifications: ReadonlyMap<number, FailureClassification> = new Map([\n  [10001, 'transient'],\n  [10043, 'transient'],\n  [10054, 'transient'],\n  [10058, 'transient'],\n  [10013, 'transient'],\n  [10002, 'terminal'],\n  [10003, 'terminal'],\n  [10018, 'terminal'],\n  [10035, 'terminal'],\n  [10042, 'terminal'],\n  [10005, 'terminal'],\n  [10006, 'terminal'],\n  [10008, 'terminal'],\n  [10009, 'terminal'],\n  [10073, 'terminal'],\n  [10007, 'terminal'],\n  [10020, 'terminal'],\n  [100100, 'terminal'],\n  [10012, 'terminal'],\n  [10069, 'terminal'],\n  [10033, 'terminal'],\n  [10014, 'terminal'],\n  [10037, 'terminal'],\n  [10039, 'terminal'],\n  [10031, 'terminal'],\n  [10011, 'terminal'],\n  [10024, 'terminal'],\n  [10025, 'terminal'],\n  [10048, 'terminal'],\n])\n\nfunction extractR2Failure(cause: unknown): R2Failure | undefined {\n  if (!(cause instanceof Error)) return undefined\n  const parsed = R2FailureSchema.safeParse(cause)\n  if (parsed.success) return parsed.data\n  // Cloudflare documents the numeric suffix for bindings that omit structured fields.\n  const match = /\\((\\d{5,6})\\)\\s*$/.exec(cause.message)\n  return match?.[1] === undefined ? undefined : { code: Number(match[1]) }\n}\n\nfunction classifyR2Code(cause: unknown): FailureClassification | undefined {\n  const failure = extractR2Failure(cause)\n  return failure === undefined ? undefined : (classifications.get(failure.code) ?? 'unknown')\n}\n\nfunction classifyR2Error(cause: unknown): FailureClassification {\n  if (isAbortError(cause)) return 'terminal'\n  if (cause instanceof AppError) return cause.classification\n  return classifyBoundaryError({ cause, classifyBoundary: classifyR2Code, includeCloudflare: true })\n}\n\n/** A raw binding failure after one attempt. Classification does not establish whether a mutation committed. */\nexport class R2Error extends AppError {\n  readonly _tag = 'R2Error'\n  readonly classification: FailureClassification\n  readonly operation: R2Operation\n  readonly r2?: R2Failure | undefined\n  override readonly cause: unknown\n\n  constructor(input: { operation: R2Operation; cause: unknown }) {\n    super(`R2 ${input.operation} failed`, { cause: input.cause })\n    this.operation = input.operation\n    this.cause = input.cause\n    this.r2 = extractR2Failure(input.cause)\n    this.classification = classifyR2Error(input.cause)\n  }\n}\n\n/** JSON serialization or syntax failed. Binding and body-read failures use R2Error. */\nexport class R2JsonError extends AppError {\n  readonly _tag = 'R2JsonError'\n  readonly classification = 'terminal'\n  readonly operation: 'encode' | 'decode'\n  override readonly cause: unknown\n\n  constructor(input: { operation: 'encode' | 'decode'; cause: unknown }) {\n    super(`R2 JSON ${input.operation} failed`, { cause: input.cause })\n    this.operation = input.operation\n    this.cause = input.cause\n  }\n}\n"],"mappings":";;;;AAuBA,MAAM,kBAAkB,EAAE,OAAO;CAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CAChC,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;AAC9B,CAAC;AAGD,MAAM,kCAA8D,IAAI,IAAI;CAC1E,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,WAAW;CACnB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,QAAQ,UAAU;CACnB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;CAClB,CAAC,OAAO,UAAU;AACpB,CAAC;AAED,SAAS,iBAAiB,OAAuC;CAC/D,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CACtC,MAAM,SAAS,gBAAgB,UAAU,KAAK;CAC9C,IAAI,OAAO,SAAS,OAAO,OAAO;CAElC,MAAM,QAAQ,oBAAoB,KAAK,MAAM,OAAO;CACpD,OAAO,QAAQ,OAAO,SAAY,SAAY,EAAE,MAAM,OAAO,MAAM,EAAE,EAAE;AACzE;AAEA,SAAS,eAAe,OAAmD;CACzE,MAAM,UAAU,iBAAiB,KAAK;CACtC,OAAO,YAAY,SAAY,SAAa,gBAAgB,IAAI,QAAQ,IAAI,KAAK;AACnF;AAEA,SAAS,gBAAgB,OAAuC;CAC9D,IAAI,aAAa,KAAK,GAAG,OAAO;CAChC,IAAI,iBAAiB,UAAU,OAAO,MAAM;CAC5C,OAAO,sBAAsB;EAAE;EAAO,kBAAkB;EAAgB,mBAAmB;CAAK,CAAC;AACnG;;AAGA,IAAa,UAAb,cAA6B,SAAS;CACpC,AAAS,OAAO;CAChB,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAkB;CAElB,YAAY,OAAmD;EAC7D,MAAM,MAAM,MAAM,UAAU,UAAU,EAAE,OAAO,MAAM,MAAM,CAAC;EAC5D,KAAK,YAAY,MAAM;EACvB,KAAK,QAAQ,MAAM;EACnB,KAAK,KAAK,iBAAiB,MAAM,KAAK;EACtC,KAAK,iBAAiB,gBAAgB,MAAM,KAAK;CACnD;AACF;;AAGA,IAAa,cAAb,cAAiC,SAAS;CACxC,AAAS,OAAO;CAChB,AAAS,iBAAiB;CAC1B,AAAS;CACT,AAAkB;CAElB,YAAY,OAA2D;EACrE,MAAM,WAAW,MAAM,UAAU,UAAU,EAAE,OAAO,MAAM,MAAM,CAAC;EACjE,KAAK,YAAY,MAAM;EACvB,KAAK,QAAQ,MAAM;CACrB;AACF"}

package/dist/{request-4vJEWxyZ.js → request-BYQodKDU.js}

@@ -1,4 +1,4 @@
-import { t as PaymentServiceError } from "./payment-service.error-CqF7GkNp.js";
+import { t as PaymentServiceError } from "./payment-service.error-BR10zqxk.js";
 import Stripe from "stripe";
 
 //#region src/infrastructure/stripe/request.ts
@@ -18,4 +18,4 @@ async function stripeRequest(operation, work) {
 
 //#endregion
 export { stripeRequest as t };
-//# sourceMappingURL=request-4vJEWxyZ.js.map
+//# sourceMappingURL=request-BYQodKDU.js.map

package/dist/{request-4vJEWxyZ.js.map → request-BYQodKDU.js.map}

@@ -1 +1 @@
-{"version":3,"file":"request-4vJEWxyZ.js","names":[],"sources":["../src/infrastructure/stripe/request.ts"],"sourcesContent":["import Stripe from 'stripe'\n\nimport { PaymentServiceError } from './payment-service.error.ts'\n\n/**\n * Invoke one SDK operation; the SDK owns retries configured on its client or request.\n * Convert every Stripe error to PaymentServiceError without logging; preserve the original error in cause.\n * Non-Stripe failures propagate unchanged.\n */\nexport async function stripeRequest<T>(operation: string, work: () => Promise<T>): Promise<T> {\n  try {\n    return await work()\n  } catch (cause) {\n    if (!(cause instanceof Stripe.errors.StripeError)) throw cause\n    throw new PaymentServiceError(operation, cause)\n  }\n}\n"],"mappings":";;;;;;;;;AASA,eAAsB,cAAiB,WAAmB,MAAoC;CAC5F,IAAI;EACF,OAAO,MAAM,KAAK;CACpB,SAAS,OAAO;EACd,IAAI,EAAE,iBAAiB,OAAO,OAAO,cAAc,MAAM;EACzD,MAAM,IAAI,oBAAoB,WAAW,KAAK;CAChD;AACF"}
+{"version":3,"file":"request-BYQodKDU.js","names":[],"sources":["../src/infrastructure/stripe/request.ts"],"sourcesContent":["import Stripe from 'stripe'\n\nimport { PaymentServiceError } from './payment-service.error.ts'\n\n/**\n * Invoke one SDK operation; the SDK owns retries configured on its client or request.\n * Convert every Stripe error to PaymentServiceError without logging; preserve the original error in cause.\n * Non-Stripe failures propagate unchanged.\n */\nexport async function stripeRequest<T>(operation: string, work: () => Promise<T>): Promise<T> {\n  try {\n    return await work()\n  } catch (cause) {\n    if (!(cause instanceof Stripe.errors.StripeError)) throw cause\n    throw new PaymentServiceError(operation, cause)\n  }\n}\n"],"mappings":";;;;;;;;;AASA,eAAsB,cAAiB,WAAmB,MAAoC;CAC5F,IAAI;EACF,OAAO,MAAM,KAAK;CACpB,SAAS,OAAO;EACd,IAAI,EAAE,iBAAiB,OAAO,OAAO,cAAc,MAAM;EACzD,MAAM,IAAI,oBAAoB,WAAW,KAAK;CAChD;AACF"}

package/dist/resend.d.ts

@@ -1,6 +1,6 @@
-import { jt as BounceType } from "./index-DUFS0SJ_.js";
-import { B as OutboundEmail, H as ReceivedContent, I as EmailAccepted, R as IEmailService, U as ReceivedEmail } from "./index-BosM_da2.js";
-import { n as WebhookVerifier } from "./webhook-verification-D1c7BY4q.js";
+import { jt as BounceType } from "./index-CtIdbnEZ.js";
+import { B as OutboundEmail, H as ReceivedContent, I as EmailAccepted, R as IEmailService, U as ReceivedEmail } from "./index-BMY7ylgk.js";
+import { n as WebhookVerifier } from "./webhook-verification-DL4L3zbu.js";
 import "resend";
 //#region src/infrastructure/resend/resend-email-service.d.ts
 /**

package/dist/resend.js

@@ -1,5 +1,5 @@
-import { $ as EmailAddressSchema, J as parseBounceType, X as EmailServiceError } from "./core-BiN6S_cm.js";
-import { t as WebhookVerificationError } from "./webhook-verification-lWso44-q.js";
+import { $ as EmailAddressSchema, J as parseBounceType, X as EmailServiceError } from "./core-DOBZeYSX.js";
+import { t as WebhookVerificationError } from "./webhook-verification-C4R6OO7f.js";
 import { z } from "zod";
 import { Buffer } from "node:buffer";
 

package/dist/sentry/client.d.ts

@@ -1,4 +1,4 @@
-import { u as LoggerErrorHook } from "../index-DUFS0SJ_.js";
+import { u as LoggerErrorHook } from "../index-CtIdbnEZ.js";
 import * as Sentry from "@sentry/tanstackstart-react";
 //#region src/infrastructure/sentry/client.d.ts
 /** Application settings use Sentry's names; enablement and environment belong to the application. */

package/dist/sentry/client.js

@@ -1,4 +1,4 @@
-import { a as setLoggerErrorHook } from "../core-BiN6S_cm.js";
+import { a as setLoggerErrorHook } from "../core-DOBZeYSX.js";
 import * as Sentry from "@sentry/tanstackstart-react";
 import { isNotFound, isRedirect } from "@tanstack/react-router";
 

package/dist/sentry/server.d.ts

@@ -1,5 +1,5 @@
-import { u as LoggerErrorHook } from "../index-DUFS0SJ_.js";
-import { J as ObservabilityService, Y as ObservabilityUser, q as ObservabilityScope } from "../index-BosM_da2.js";
+import { u as LoggerErrorHook } from "../index-CtIdbnEZ.js";
+import { J as ObservabilityService, Y as ObservabilityUser, q as ObservabilityScope } from "../index-BMY7ylgk.js";
 import * as Sentry from "@sentry/cloudflare";
 //#region src/infrastructure/sentry/server.d.ts
 /** Application-owned deployment settings with the full Cloudflare SDK option contract. */

package/dist/sentry/tanstack.d.ts

@@ -1,4 +1,4 @@
-import { ot as ErrorTable } from "../index-DUFS0SJ_.js";
+import { ot as ErrorTable } from "../index-CtIdbnEZ.js";
 import { ErrorEvent, EventHint } from "@sentry/cloudflare";
 //#region src/infrastructure/sentry/tanstack.d.ts
 /**

package/dist/stripe/payment-service.error.d.ts

@@ -1,4 +1,4 @@
-import { Xt as AppError, Zt as FailureClassification } from "../index-DUFS0SJ_.js";
+import { Jt as AppError, Yt as FailureClassification } from "../index-CtIdbnEZ.js";
 import Stripe from "stripe";
 //#region src/infrastructure/stripe/payment-service.error.d.ts
 /** A final Stripe request failure. The caller logs once; native details remain in cause. */

package/dist/stripe/payment-service.error.js

@@ -1,3 +1,3 @@
-import { t as PaymentServiceError } from "../payment-service.error-CqF7GkNp.js";
+import { t as PaymentServiceError } from "../payment-service.error-BR10zqxk.js";
 
 export { PaymentServiceError };

package/dist/stripe/payment-service.js

@@ -1,4 +1,4 @@
-import { t as stripeRequest } from "../request-4vJEWxyZ.js";
+import { t as stripeRequest } from "../request-BYQodKDU.js";
 
 //#region src/infrastructure/stripe/payment-service.ts
 /**

package/dist/stripe/payment-webhook.d.ts

@@ -1,4 +1,4 @@
-import { n as WebhookVerifier } from "../webhook-verification-D1c7BY4q.js";
+import { n as WebhookVerifier } from "../webhook-verification-DL4L3zbu.js";
 import Stripe from "stripe";
 //#region src/infrastructure/stripe/payment-webhook.d.ts
 /**

package/dist/stripe/payment-webhook.js

@@ -1,4 +1,4 @@
-import { t as WebhookVerificationError } from "../webhook-verification-lWso44-q.js";
+import { t as WebhookVerificationError } from "../webhook-verification-C4R6OO7f.js";
 import Stripe from "stripe";
 
 //#region src/infrastructure/stripe/payment-webhook.ts

package/dist/stripe/request.js

@@ -1,3 +1,3 @@
-import { t as stripeRequest } from "../request-4vJEWxyZ.js";
+import { t as stripeRequest } from "../request-BYQodKDU.js";
 
 export { stripeRequest };

package/dist/tanstack.d.ts

@@ -1,4 +1,4 @@
-import { ot as ErrorTable } from "./index-DUFS0SJ_.js";
+import { ot as ErrorTable } from "./index-CtIdbnEZ.js";
 import { Register } from "@tanstack/react-start";
 import { BetterAuthCookies } from "better-auth";
 //#region src/infrastructure/tanstack/request-context.d.ts

package/dist/tanstack.js

@@ -1,4 +1,4 @@
-import { H as StaleSessionError, R as ValidationError, W as AuthenticationError, nt as AppError, r as createLogger } from "./core-BiN6S_cm.js";
+import { H as StaleSessionError, R as ValidationError, W as AuthenticationError, r as createLogger, tt as AppError } from "./core-DOBZeYSX.js";
 import { t as applyObservabilityUser } from "./request-user-B4rh1c2-.js";
 import { n as withSpan } from "./tracing-C_7B_odV.js";
 import { z } from "zod";

package/dist/testing/outbox-repository.d.ts

@@ -1,5 +1,5 @@
-import { W as DomainEvent } from "../index-DUFS0SJ_.js";
-import { A as IOutboxRepository } from "../index-BosM_da2.js";
+import { W as DomainEvent } from "../index-CtIdbnEZ.js";
+import { A as IOutboxRepository } from "../index-BMY7ylgk.js";
 //#region src/infrastructure/testing/outbox-repository-contract.d.ts
 /** Stored fields observed by the adapter contract, independent of a database library. */
 export type OutboxContractRow = {

package/dist/testing/payment-service.js

@@ -1,4 +1,4 @@
-import { t as PaymentServiceError } from "../payment-service.error-CqF7GkNp.js";
+import { t as PaymentServiceError } from "../payment-service.error-BR10zqxk.js";
 import { t as stripeFixture } from "../stripe-fixture-yFUknTJO.js";
 import Stripe from "stripe";
 import { deepStrictEqual, equal, ok, rejects } from "node:assert/strict";

package/dist/{webhook-verification-lWso44-q.js → webhook-verification-C4R6OO7f.js}

@@ -1,4 +1,4 @@
-import { nt as AppError } from "./core-BiN6S_cm.js";
+import { tt as AppError } from "./core-DOBZeYSX.js";
 
 //#region src/infrastructure/http/webhook-verification.ts
 /** A webhook cannot be trusted or parsed. The HTTP handler logs the rejection once. */
@@ -15,4 +15,4 @@ var WebhookVerificationError = class extends AppError {
 
 //#endregion
 export { WebhookVerificationError as t };
-//# sourceMappingURL=webhook-verification-lWso44-q.js.map
+//# sourceMappingURL=webhook-verification-C4R6OO7f.js.map

package/dist/{webhook-verification-lWso44-q.js.map → webhook-verification-C4R6OO7f.js.map}

@@ -1 +1 @@
-{"version":3,"file":"webhook-verification-lWso44-q.js","names":[],"sources":["../src/infrastructure/http/webhook-verification.ts"],"sourcesContent":["import { AppError } from '@/core'\n\n/** A webhook cannot be trusted or parsed. The HTTP handler logs the rejection once. */\nexport class WebhookVerificationError extends AppError {\n  readonly _tag = 'WebhookVerificationError'\n  readonly classification = 'terminal'\n\n  /** Keep secrets and payload details out of the public message. */\n  constructor(\n    readonly reason: 'missing_headers' | 'invalid_signature' | 'invalid_payload',\n    cause?: unknown,\n  ) {\n    super(`Webhook rejected: ${reason}`, { cause })\n  }\n}\n\n/** The provider owns signature verification, timestamp tolerance, and payload parsing. */\nexport interface WebhookVerifier<Verified> {\n  /**\n   * Verify the exact body before parsing it. Return null for an ignored webhook.\n   * @throws WebhookVerificationError when the request cannot be trusted or parsed.\n   */\n  verify(body: string, headers: Headers): Promise<Verified | null>\n}\n"],"mappings":";;;;AAGA,IAAa,2BAAb,cAA8C,SAAS;CAM1C;CALX,AAAS,OAAO;CAChB,AAAS,iBAAiB;;CAG1B,YACE,AAAS,QACT,OACA;EACA,MAAM,qBAAqB,UAAU,EAAE,MAAM,CAAC;EAHrC;CAIX;AACF"}
+{"version":3,"file":"webhook-verification-C4R6OO7f.js","names":[],"sources":["../src/infrastructure/http/webhook-verification.ts"],"sourcesContent":["import { AppError } from '@/core'\n\n/** A webhook cannot be trusted or parsed. The HTTP handler logs the rejection once. */\nexport class WebhookVerificationError extends AppError {\n  readonly _tag = 'WebhookVerificationError'\n  readonly classification = 'terminal'\n\n  /** Keep secrets and payload details out of the public message. */\n  constructor(\n    readonly reason: 'missing_headers' | 'invalid_signature' | 'invalid_payload',\n    cause?: unknown,\n  ) {\n    super(`Webhook rejected: ${reason}`, { cause })\n  }\n}\n\n/** The provider owns signature verification, timestamp tolerance, and payload parsing. */\nexport interface WebhookVerifier<Verified> {\n  /**\n   * Verify the exact body before parsing it. Return null for an ignored webhook.\n   * @throws WebhookVerificationError when the request cannot be trusted or parsed.\n   */\n  verify(body: string, headers: Headers): Promise<Verified | null>\n}\n"],"mappings":";;;;AAGA,IAAa,2BAAb,cAA8C,SAAS;CAM1C;CALX,AAAS,OAAO;CAChB,AAAS,iBAAiB;;CAG1B,YACE,AAAS,QACT,OACA;EACA,MAAM,qBAAqB,UAAU,EAAE,MAAM,CAAC;EAHrC;CAIX;AACF"}

package/dist/{webhook-verification-D1c7BY4q.d.ts → webhook-verification-DL4L3zbu.d.ts}

@@ -1,4 +1,4 @@
-import { Xt as AppError } from "./index-DUFS0SJ_.js";
+import { Jt as AppError } from "./index-CtIdbnEZ.js";
 //#region src/infrastructure/http/webhook-verification.d.ts
 /** A webhook cannot be trusted or parsed. The HTTP handler logs the rejection once. */
 declare class WebhookVerificationError extends AppError {
@@ -18,4 +18,4 @@ interface WebhookVerifier<Verified> {
 }
 //#endregion
 export { WebhookVerifier as n, WebhookVerificationError as t };
-//# sourceMappingURL=webhook-verification-D1c7BY4q.d.ts.map
+//# sourceMappingURL=webhook-verification-DL4L3zbu.d.ts.map

package/dist/{webhook-verification-D1c7BY4q.d.ts.map → webhook-verification-DL4L3zbu.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"webhook-verification-D1c7BY4q.d.ts","names":[],"sources":["../src/infrastructure/http/webhook-verification.ts"],"mappings":";;;cAGa,iCAAiC;WAMjC;WALF;WACA;;EAGT,YACW,qEACT;;;UAOa,gBAAgB;;;;;EAK/B,OAAO,cAAc,SAAS,UAAU,QAAQ"}
+{"version":3,"file":"webhook-verification-DL4L3zbu.d.ts","names":[],"sources":["../src/infrastructure/http/webhook-verification.ts"],"mappings":";;;cAGa,iCAAiC;WAMjC;WALF;WACA;;EAGT,YACW,qEACT;;;UAOa,gBAAgB;;;;;EAK/B,OAAO,cAAc,SAAS,UAAU,QAAQ"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "better-ship",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "Foundation for applications on Cloudflare Workers: logger, errors, message bus, infrastructure adapters, and UI primitives",
   "license": "Apache-2.0",
   "repository": {

package/src/application/analytics-service.ts

@@ -1,4 +1,12 @@
-import type { AnalyticsEventIdentity, AnalyticsEventInput, AnalyticsProperties } from '@/core'
+import type { AnalyticsEventInput, AnalyticsProperties, AnalyticsTarget } from '@/core'
+
+/** The properties of one event name; an untyped service accepts any properties. */
+export type AnalyticsPropertiesOf<
+  TEvent extends AnalyticsEventInput,
+  TName extends TEvent['name'],
+> = string extends TEvent['name']
+  ? TEvent['properties']
+  : Extract<TEvent, { readonly name: TName }>['properties']
 
 /** Product analytics without an SDK dependency, ported from Typist and Porte. */
 export interface AnalyticsService<TEvent extends AnalyticsEventInput = AnalyticsEventInput> {
@@ -7,15 +15,34 @@ export interface AnalyticsService<TEvent extends AnalyticsEventInput = Analytics
   /** Merge a previous ID into this person; the application must establish that both identify the same person. */
   alias(distinctId: string, previousDistinctId: string): void
   /** Schedule an event for a person; returning does not confirm remote acceptance. */
-  track(event: TEvent, distinctId: string, identity?: AnalyticsEventIdentity): void
+  track<TName extends TEvent['name']>(
+    name: TName,
+    properties: AnalyticsPropertiesOf<TEvent, TName>,
+    target: AnalyticsTarget,
+  ): void
   /** Schedule an event without creating a person profile for its distinct ID. */
-  trackAnonymous(event: TEvent, distinctId: string, identity?: AnalyticsEventIdentity): void
+  trackAnonymous<TName extends TEvent['name']>(
+    name: TName,
+    properties: AnalyticsPropertiesOf<TEvent, TName>,
+    target: AnalyticsTarget,
+  ): void
 }
 
-/** Reports to nobody. The composition root selects this service when analytics is disabled. */
-export const NULL_ANALYTICS: AnalyticsService = {
+/**
+ * Reports to nobody. The composition root selects this service when analytics is disabled.
+ * `satisfies` keeps its own type, so it serves an `AnalyticsService` of any event map.
+ */
+export const NULL_ANALYTICS = {
   identify: () => {},
   alias: () => {},
-  track: () => {},
-  trackAnonymous: () => {},
-}
+  track: (
+    _name: string,
+    _properties: AnalyticsEventInput['properties'],
+    _target: AnalyticsTarget,
+  ) => {},
+  trackAnonymous: (
+    _name: string,
+    _properties: AnalyticsEventInput['properties'],
+    _target: AnalyticsTarget,
+  ) => {},
+} satisfies AnalyticsService

package/src/application/index.ts

@@ -1,5 +1,9 @@
 export type { CommandHandler, EventHandler, QueryHandler } from './handlers.ts'
-export { NULL_ANALYTICS, type AnalyticsService } from './analytics-service.ts'
+export {
+  NULL_ANALYTICS,
+  type AnalyticsPropertiesOf,
+  type AnalyticsService,
+} from './analytics-service.ts'
 export {
   NULL_METRICS_SERVICE,
   type MetricsService,

package/src/core/analytics-event.ts

@@ -1,5 +1,3 @@
-import { z } from 'zod'
-
 /** An event name and its application-owned properties, ported from Typist's analytics/types.ts. */
 export interface AnalyticsEventInput<
   TName extends string = string,
@@ -24,14 +22,20 @@ export interface AnalyticsProperties {
   readonly [name: string]: AnalyticsProperty
 }
 
-/** Parse a persisted analytics event UUID; the SDK generates ordinary event UUIDs itself. */
-export const AnalyticsEventIdSchema = z.uuid().brand<'AnalyticsEventId'>()
-
-/** The identity of one analytics event across repeated application deliveries. */
-export type AnalyticsEventId = z.infer<typeof AnalyticsEventIdSchema>
-
-/** Supply both original values when replaying one event; never share them across different occurrences. */
-export interface AnalyticsEventIdentity {
-  readonly uuid: AnalyticsEventId
-  readonly timestamp: Date
-}
+/**
+ * Who an event belongs to, and, for code that can run twice, which occurrence it is.
+ * Pass `eventId` and `occurredAt` together: the same pair always sends the same event,
+ * so the analytics provider drops a repeat. Any stable string is an event ID.
+ */
+export type AnalyticsTarget =
+  | {
+      readonly distinctId: string
+      readonly eventId?: never
+      readonly occurredAt?: never
+    }
+  | {
+      readonly distinctId: string
+      readonly eventId: string
+      /** The business time of the occurrence, as a `Date` or an ISO 8601 string. */
+      readonly occurredAt: Date | string
+    }

package/src/core/index.ts

@@ -1,12 +1,10 @@
 export { AppError } from './app-error.ts'
 export { MissingConfigurationError } from './missing-configuration.error.ts'
 export {
-  AnalyticsEventIdSchema,
-  type AnalyticsEventId,
-  type AnalyticsEventIdentity,
   type AnalyticsEventInput,
   type AnalyticsProperties,
   type AnalyticsProperty,
+  type AnalyticsTarget,
 } from './analytics-event.ts'
 export { EmailAddressSchema, type EmailAddress } from './email-address.ts'
 export {