@01.software/sdk 0.33.0 → 0.35.0

package/dist/errors.js

@@ -0,0 +1,277 @@
+// src/core/errors.ts
+var SDKError = class extends Error {
+  constructor(code, message, status, details, userMessage, suggestion, requestId) {
+    super(message);
+    this.name = "SDKError";
+    this.code = code;
+    this.status = status;
+    this.details = details;
+    this.userMessage = userMessage;
+    this.suggestion = suggestion;
+    this.requestId = requestId;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, new.target);
+    }
+  }
+  getUserMessage() {
+    return this.userMessage || this.message;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      status: this.status,
+      details: this.details,
+      userMessage: this.userMessage,
+      suggestion: this.suggestion,
+      ...this.requestId !== void 0 && { requestId: this.requestId }
+    };
+  }
+};
+var NetworkError = class extends SDKError {
+  constructor(message, status, details, userMessage, suggestion) {
+    super("NETWORK_ERROR", message, status, details, userMessage, suggestion);
+    this.name = "NetworkError";
+  }
+};
+var ValidationError = class extends SDKError {
+  constructor(message, details, userMessage, suggestion, status = 400) {
+    super("VALIDATION_ERROR", message, status, details, userMessage, suggestion);
+    this.name = "ValidationError";
+  }
+};
+var ApiError = class extends SDKError {
+  constructor(message, status, details, userMessage, suggestion, requestId) {
+    super(
+      "API_ERROR",
+      message,
+      status,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
+    this.name = "ApiError";
+  }
+};
+var ConfigError = class extends SDKError {
+  constructor(message, details, userMessage, suggestion) {
+    super("CONFIG_ERROR", message, void 0, details, userMessage, suggestion);
+    this.name = "ConfigError";
+  }
+};
+var TimeoutError = class extends SDKError {
+  constructor(message = "Request timed out.", details, userMessage, suggestion) {
+    super("TIMEOUT_ERROR", message, 408, details, userMessage, suggestion);
+    this.name = "TimeoutError";
+  }
+};
+var GoneError = class extends SDKError {
+  constructor(message = "The requested resource is no longer available.", details, userMessage, suggestion) {
+    super("GONE_ERROR", message, 410, details, userMessage, suggestion);
+    this.name = "GoneError";
+  }
+};
+var ServiceUnavailableError = class extends SDKError {
+  constructor(message = "Service temporarily unavailable.", retryAfter, details, userMessage, suggestion) {
+    super(
+      "SERVICE_UNAVAILABLE_ERROR",
+      message,
+      503,
+      details,
+      userMessage,
+      suggestion
+    );
+    this.name = "ServiceUnavailableError";
+    this.retryAfter = retryAfter;
+  }
+};
+var UsageLimitError = class extends SDKError {
+  constructor(message, usage, details, userMessage, suggestion) {
+    super("USAGE_LIMIT_ERROR", message, 429, details, userMessage, suggestion);
+    this.name = "UsageLimitError";
+    this.usage = usage;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      usage: this.usage
+    };
+  }
+};
+var AuthError = class extends SDKError {
+  constructor(message, details, userMessage, suggestion, requestId) {
+    super(
+      "auth_error",
+      message,
+      401,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
+    this.name = "AuthError";
+  }
+};
+var PermissionError = class extends SDKError {
+  constructor(message, details, userMessage, suggestion, requestId) {
+    super(
+      "permission_error",
+      message,
+      403,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
+    this.name = "PermissionError";
+  }
+};
+var NotFoundError = class extends SDKError {
+  constructor(message, details, userMessage, suggestion, requestId) {
+    super(
+      "not_found",
+      message,
+      404,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
+    this.name = "NotFoundError";
+  }
+};
+var ConflictError = class extends SDKError {
+  constructor(message, details, userMessage, suggestion, requestId) {
+    super("conflict", message, 409, details, userMessage, suggestion, requestId);
+    this.name = "ConflictError";
+  }
+};
+var RateLimitError = class extends SDKError {
+  constructor(message, retryAfter, details, userMessage, suggestion, requestId) {
+    super(
+      "rate_limit_exceeded",
+      message,
+      429,
+      details,
+      userMessage,
+      suggestion,
+      requestId
+    );
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+function isSDKError(error) {
+  return error instanceof SDKError;
+}
+function isNetworkError(error) {
+  return error instanceof NetworkError;
+}
+function isValidationError(error) {
+  return error instanceof ValidationError;
+}
+function isApiError(error) {
+  return error instanceof ApiError;
+}
+function isConfigError(error) {
+  return error instanceof ConfigError;
+}
+function isTimeoutError(error) {
+  return error instanceof TimeoutError;
+}
+function isGoneError(error) {
+  return error instanceof GoneError;
+}
+function isServiceUnavailableError(error) {
+  return error instanceof ServiceUnavailableError;
+}
+function isUsageLimitError(error) {
+  return error instanceof UsageLimitError;
+}
+function isAuthError(error) {
+  return error instanceof AuthError;
+}
+function isPermissionError(error) {
+  return error instanceof PermissionError;
+}
+function isNotFoundError(error) {
+  return error instanceof NotFoundError;
+}
+function isConflictError(error) {
+  return error instanceof ConflictError;
+}
+function isRateLimitError(error) {
+  return error instanceof RateLimitError;
+}
+var createNetworkError = (message, status, details, userMessage, suggestion) => new NetworkError(message, status, details, userMessage, suggestion);
+var createValidationError = (message, details, userMessage, suggestion, status) => new ValidationError(message, details, userMessage, suggestion, status);
+var createApiError = (message, status, details, userMessage, suggestion, requestId) => new ApiError(message, status, details, userMessage, suggestion, requestId);
+var createConfigError = (message, details, userMessage, suggestion) => new ConfigError(message, details, userMessage, suggestion);
+var createTimeoutError = (message, details, userMessage, suggestion) => new TimeoutError(message, details, userMessage, suggestion);
+var createGoneError = (message, details, userMessage, suggestion) => new GoneError(message, details, userMessage, suggestion);
+var createServiceUnavailableError = (message, retryAfter, details, userMessage, suggestion) => new ServiceUnavailableError(
+  message,
+  retryAfter,
+  details,
+  userMessage,
+  suggestion
+);
+var createUsageLimitError = (message, usage, details, userMessage, suggestion) => new UsageLimitError(message, usage, details, userMessage, suggestion);
+var createAuthError = (message, details, userMessage, suggestion, requestId) => new AuthError(message, details, userMessage, suggestion, requestId);
+var createPermissionError = (message, details, userMessage, suggestion, requestId) => new PermissionError(message, details, userMessage, suggestion, requestId);
+var createNotFoundError = (message, details, userMessage, suggestion, requestId) => new NotFoundError(message, details, userMessage, suggestion, requestId);
+var createConflictError = (message, details, userMessage, suggestion, requestId) => new ConflictError(message, details, userMessage, suggestion, requestId);
+var createRateLimitError = (message, retryAfter, details, userMessage, suggestion, requestId) => new RateLimitError(
+  message,
+  retryAfter,
+  details,
+  userMessage,
+  suggestion,
+  requestId
+);
+export {
+  ApiError,
+  AuthError,
+  ConfigError,
+  ConflictError,
+  GoneError,
+  NetworkError,
+  NotFoundError,
+  PermissionError,
+  RateLimitError,
+  SDKError,
+  ServiceUnavailableError,
+  TimeoutError,
+  UsageLimitError,
+  ValidationError,
+  createApiError,
+  createAuthError,
+  createConfigError,
+  createConflictError,
+  createGoneError,
+  createNetworkError,
+  createNotFoundError,
+  createPermissionError,
+  createRateLimitError,
+  createServiceUnavailableError,
+  createTimeoutError,
+  createUsageLimitError,
+  createValidationError,
+  isApiError,
+  isAuthError,
+  isConfigError,
+  isConflictError,
+  isGoneError,
+  isNetworkError,
+  isNotFoundError,
+  isPermissionError,
+  isRateLimitError,
+  isSDKError,
+  isServiceUnavailableError,
+  isTimeoutError,
+  isUsageLimitError,
+  isValidationError
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors.ts"],"sourcesContent":["export class SDKError extends Error {\n  readonly code: string\n  readonly status?: number\n  readonly details?: unknown\n  readonly userMessage?: string\n  readonly suggestion?: string\n  readonly requestId?: string\n\n  constructor(\n    code: string,\n    message: string,\n    status?: number,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    requestId?: string,\n  ) {\n    super(message)\n    this.name = 'SDKError'\n    this.code = code\n    this.status = status\n    this.details = details\n    this.userMessage = userMessage\n    this.suggestion = suggestion\n    this.requestId = requestId\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, new.target)\n    }\n  }\n\n  getUserMessage(): string {\n    return this.userMessage || this.message\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      status: this.status,\n      details: this.details,\n      userMessage: this.userMessage,\n      suggestion: this.suggestion,\n      ...(this.requestId !== undefined && { requestId: this.requestId }),\n    }\n  }\n}\n\nexport class NetworkError extends SDKError {\n  constructor(\n    message: string,\n    status?: number,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n  ) {\n    super('NETWORK_ERROR', message, status, details, userMessage, suggestion)\n    this.name = 'NetworkError'\n  }\n}\n\nexport class ValidationError extends SDKError {\n  constructor(\n    message: string,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    status = 400,\n  ) {\n    super('VALIDATION_ERROR', message, status, details, userMessage, suggestion)\n    this.name = 'ValidationError'\n  }\n}\n\nexport class ApiError extends SDKError {\n  constructor(\n    message: string,\n    status: number,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    requestId?: string,\n  ) {\n    super(\n      'API_ERROR',\n      message,\n      status,\n      details,\n      userMessage,\n      suggestion,\n      requestId,\n    )\n    this.name = 'ApiError'\n  }\n}\n\nexport class ConfigError extends SDKError {\n  constructor(\n    message: string,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n  ) {\n    super('CONFIG_ERROR', message, undefined, details, userMessage, suggestion)\n    this.name = 'ConfigError'\n  }\n}\n\nexport class TimeoutError extends SDKError {\n  constructor(\n    message = 'Request timed out.',\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n  ) {\n    super('TIMEOUT_ERROR', message, 408, details, userMessage, suggestion)\n    this.name = 'TimeoutError'\n  }\n}\n\nexport class GoneError extends SDKError {\n  constructor(\n    message = 'The requested resource is no longer available.',\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n  ) {\n    super('GONE_ERROR', message, 410, details, userMessage, suggestion)\n    this.name = 'GoneError'\n  }\n}\n\nexport class ServiceUnavailableError extends SDKError {\n  readonly retryAfter?: number\n\n  constructor(\n    message = 'Service temporarily unavailable.',\n    retryAfter?: number,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n  ) {\n    super(\n      'SERVICE_UNAVAILABLE_ERROR',\n      message,\n      503,\n      details,\n      userMessage,\n      suggestion,\n    )\n    this.name = 'ServiceUnavailableError'\n    this.retryAfter = retryAfter\n  }\n}\n\nexport class UsageLimitError extends SDKError {\n  readonly usage: { limit: number; current: number; remaining: number }\n\n  constructor(\n    message: string,\n    usage: { limit: number; current: number; remaining: number },\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n  ) {\n    super('USAGE_LIMIT_ERROR', message, 429, details, userMessage, suggestion)\n    this.name = 'UsageLimitError'\n    this.usage = usage\n  }\n\n  toJSON() {\n    return {\n      ...super.toJSON(),\n      usage: this.usage,\n    }\n  }\n}\n\nexport class AuthError extends SDKError {\n  constructor(\n    message: string,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    requestId?: string,\n  ) {\n    super(\n      'auth_error',\n      message,\n      401,\n      details,\n      userMessage,\n      suggestion,\n      requestId,\n    )\n    this.name = 'AuthError'\n  }\n}\n\nexport class PermissionError extends SDKError {\n  constructor(\n    message: string,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    requestId?: string,\n  ) {\n    super(\n      'permission_error',\n      message,\n      403,\n      details,\n      userMessage,\n      suggestion,\n      requestId,\n    )\n    this.name = 'PermissionError'\n  }\n}\n\nexport class NotFoundError extends SDKError {\n  constructor(\n    message: string,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    requestId?: string,\n  ) {\n    super(\n      'not_found',\n      message,\n      404,\n      details,\n      userMessage,\n      suggestion,\n      requestId,\n    )\n    this.name = 'NotFoundError'\n  }\n}\n\nexport class ConflictError extends SDKError {\n  constructor(\n    message: string,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    requestId?: string,\n  ) {\n    super('conflict', message, 409, details, userMessage, suggestion, requestId)\n    this.name = 'ConflictError'\n  }\n}\n\nexport class RateLimitError extends SDKError {\n  readonly retryAfter?: number\n\n  constructor(\n    message: string,\n    retryAfter?: number,\n    details?: unknown,\n    userMessage?: string,\n    suggestion?: string,\n    requestId?: string,\n  ) {\n    super(\n      'rate_limit_exceeded',\n      message,\n      429,\n      details,\n      userMessage,\n      suggestion,\n      requestId,\n    )\n    this.name = 'RateLimitError'\n    this.retryAfter = retryAfter\n  }\n}\n\nexport function isSDKError(error: unknown): error is SDKError {\n  return error instanceof SDKError\n}\n\nexport function isNetworkError(error: unknown): error is NetworkError {\n  return error instanceof NetworkError\n}\n\nexport function isValidationError(error: unknown): error is ValidationError {\n  return error instanceof ValidationError\n}\n\nexport function isApiError(error: unknown): error is ApiError {\n  return error instanceof ApiError\n}\n\nexport function isConfigError(error: unknown): error is ConfigError {\n  return error instanceof ConfigError\n}\n\nexport function isTimeoutError(error: unknown): error is TimeoutError {\n  return error instanceof TimeoutError\n}\n\nexport function isGoneError(error: unknown): error is GoneError {\n  return error instanceof GoneError\n}\n\nexport function isServiceUnavailableError(\n  error: unknown,\n): error is ServiceUnavailableError {\n  return error instanceof ServiceUnavailableError\n}\n\nexport function isUsageLimitError(error: unknown): error is UsageLimitError {\n  return error instanceof UsageLimitError\n}\n\nexport function isAuthError(error: unknown): error is AuthError {\n  return error instanceof AuthError\n}\n\nexport function isPermissionError(error: unknown): error is PermissionError {\n  return error instanceof PermissionError\n}\n\nexport function isNotFoundError(error: unknown): error is NotFoundError {\n  return error instanceof NotFoundError\n}\n\nexport function isConflictError(error: unknown): error is ConflictError {\n  return error instanceof ConflictError\n}\n\nexport function isRateLimitError(error: unknown): error is RateLimitError {\n  return error instanceof RateLimitError\n}\n\nexport const createNetworkError = (\n  message: string,\n  status?: number,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n) => new NetworkError(message, status, details, userMessage, suggestion)\n\nexport const createValidationError = (\n  message: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n  status?: number,\n) => new ValidationError(message, details, userMessage, suggestion, status)\n\nexport const createApiError = (\n  message: string,\n  status: number,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n  requestId?: string,\n) => new ApiError(message, status, details, userMessage, suggestion, requestId)\n\nexport const createConfigError = (\n  message: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n) => new ConfigError(message, details, userMessage, suggestion)\n\nexport const createTimeoutError = (\n  message?: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n) => new TimeoutError(message, details, userMessage, suggestion)\n\nexport const createGoneError = (\n  message?: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n) => new GoneError(message, details, userMessage, suggestion)\n\nexport const createServiceUnavailableError = (\n  message?: string,\n  retryAfter?: number,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n) =>\n  new ServiceUnavailableError(\n    message,\n    retryAfter,\n    details,\n    userMessage,\n    suggestion,\n  )\n\nexport const createUsageLimitError = (\n  message: string,\n  usage: { limit: number; current: number; remaining: number },\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n) => new UsageLimitError(message, usage, details, userMessage, suggestion)\n\nexport const createAuthError = (\n  message: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n  requestId?: string,\n) => new AuthError(message, details, userMessage, suggestion, requestId)\n\nexport const createPermissionError = (\n  message: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n  requestId?: string,\n) => new PermissionError(message, details, userMessage, suggestion, requestId)\n\nexport const createNotFoundError = (\n  message: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n  requestId?: string,\n) => new NotFoundError(message, details, userMessage, suggestion, requestId)\n\nexport const createConflictError = (\n  message: string,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n  requestId?: string,\n) => new ConflictError(message, details, userMessage, suggestion, requestId)\n\nexport const createRateLimitError = (\n  message: string,\n  retryAfter?: number,\n  details?: unknown,\n  userMessage?: string,\n  suggestion?: string,\n  requestId?: string,\n) =>\n  new RateLimitError(\n    message,\n    retryAfter,\n    details,\n    userMessage,\n    suggestion,\n    requestId,\n  )\n"],"mappings":"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","names":[]}

package/dist/index-CjA3U6X3.d.cts

@@ -0,0 +1,186 @@
+import { C as Collection } from './const-BTvdrXtY.cjs';
+import { C as CollectionType } from './types-Bx558PU6.cjs';
+import './payload-types-C7tb7Xbs.cjs';
+
+type WebhookOperation = string;
+/**
+ * Semantic event type for manual Admin Panel ordering changes.
+ *
+ * Order-change webhooks remain `operation: "update"` events for compatibility.
+ * Do not filter on or emit `operation: "reorder"`; use this event type with
+ * `isOrderChangedWebhookEvent()` to distinguish ordering from normal content
+ * updates.
+ */
+declare const ORDER_CHANGED_EVENT_TYPE: "collection.orderChanged";
+/** Semantic event type for v1 commerce notification webhooks. */
+declare const COMMERCE_NOTIFICATION_EVENT_TYPE: "commerce.notification";
+/** Collection webhook operations emitted for tenant collection writes. */
+type CollectionWebhookOperation = 'create' | 'update';
+/** Describes the ordered area affected by an order-change webhook. */
+type WebhookOrderScope = {
+    kind: 'collection';
+    collection: string;
+} | {
+    kind: 'join';
+    collection: string;
+    field: string;
+    id: string | number;
+};
+/** Identifies the public moved document for the ordered scope. */
+type WebhookOrderMoved = {
+    collection: string;
+    id: string | number;
+    relatedCollection?: string;
+    relatedId?: string | number;
+};
+/** Metadata attached to `collection.orderChanged` webhook events. */
+type WebhookOrderChange = {
+    type: 'order';
+    source: 'payload-orderable';
+    /**
+     * Diagnostic Payload order field name.
+     *
+     * This may contain hidden implementation field names. Application routing
+     * should use `change.scope` and `change.moved` instead.
+     */
+    orderableFieldName?: string;
+    previousOrder?: string | null;
+    nextOrder?: string | null;
+    scope: WebhookOrderScope;
+    moved: WebhookOrderMoved;
+};
+/** Known semantic webhook change metadata. */
+type WebhookChange = WebhookOrderChange | WebhookCommerceNotificationChange;
+interface WebhookEvent<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>> {
+    collection: T;
+    operation: WebhookOperation;
+    data: TData;
+    eventType?: string;
+    change?: unknown;
+    timestamp?: string;
+    deliveryId?: string;
+}
+type WebhookHandler<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>> = (event: WebhookEvent<T, TData>) => Promise<void> | void;
+interface WebhookOptions {
+    secret?: string;
+    /** Max accepted skew for signed webhook delivery timestamps. Default: 300s. */
+    toleranceSeconds?: number;
+}
+declare function isValidWebhookEvent(data: unknown): data is WebhookEvent;
+/** Webhook event emitted when manual Admin Panel ordering changes. */
+type OrderChangedWebhookEvent<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>> = WebhookEvent<T, TData> & {
+    operation: 'update';
+    eventType: typeof ORDER_CHANGED_EVENT_TYPE;
+    change: WebhookOrderChange;
+};
+declare const COMMERCE_NOTIFICATION_OPERATION: "notification";
+declare const COMMERCE_NOTIFICATION_EVENTS: readonly ["orderPaid", "orderCanceled", "fulfillmentShipped", "orderDelivered", "returnRequested", "returnCompleted"];
+type CommerceNotificationEventName = (typeof COMMERCE_NOTIFICATION_EVENTS)[number];
+type CommerceNotificationSourceCollection = 'orders' | 'fulfillments' | 'returns';
+type CommerceNotificationSource = {
+    collection: CommerceNotificationSourceCollection;
+    id: string | number;
+};
+type CommerceNotificationData = {
+    source?: CommerceNotificationSource;
+    orderId?: string | number;
+    orderNumber?: string;
+    status?: string;
+    totalAmount?: number;
+    currency?: string;
+    fulfillmentId?: string | number;
+    fulfillmentStatus?: string;
+    shippedAt?: string;
+    returnId?: string | number;
+    returnStatus?: string;
+    refundAmount?: number;
+    completedAt?: string;
+};
+type CommerceNotification = {
+    event: CommerceNotificationEventName;
+    intentId: string;
+    dedupeKey: string;
+    orderId?: string;
+    fulfillmentId?: string;
+    returnId?: string;
+};
+type WebhookCommerceNotificationChange = {
+    type: 'notification';
+    source: 'commerce-notifications';
+    event: CommerceNotificationEventName;
+    sourceCollection: CommerceNotificationSourceCollection;
+    sourceId: string | number;
+};
+/** Webhook event emitted for v1 commerce notification deliveries. */
+type CommerceNotificationWebhookEvent = WebhookEvent<CommerceNotificationSourceCollection, CommerceNotificationData> & {
+    operation: typeof COMMERCE_NOTIFICATION_OPERATION;
+    eventType: typeof COMMERCE_NOTIFICATION_EVENT_TYPE;
+    change?: WebhookCommerceNotificationChange;
+    notification: CommerceNotification;
+};
+type CommerceEmailChannel = 'webhook' | 'provider';
+type CommerceEmailEventConfig = {
+    enabled: boolean;
+    channel: CommerceEmailChannel;
+    template?: string;
+};
+type CommerceEmailConfig = {
+    version: 1;
+    commerceNotifications: Partial<Record<CommerceNotificationEventName, CommerceEmailEventConfig>>;
+};
+type CommerceEmailHandlerContext = {
+    event: CommerceNotificationWebhookEvent;
+    idempotencyKey: string;
+};
+type MaybePromise<T> = T | Promise<T>;
+type CommerceEmailEventHandlers = Partial<Record<CommerceNotificationEventName, (context: CommerceEmailHandlerContext) => MaybePromise<void>>> & {
+    unhandled?: (event: WebhookEvent<string, unknown>) => MaybePromise<void>;
+};
+/**
+ * Returns true for semantic order-change webhooks emitted as update events.
+ *
+ * Use this guard with `ORDER_CHANGED_EVENT_TYPE` instead of filtering on
+ * `operation: "reorder"`. Tenant order-change webhooks intentionally keep
+ * `operation: "update"` for compatibility with existing webhook handlers.
+ */
+declare function isOrderChangedWebhookEvent(event: unknown): event is OrderChangedWebhookEvent<string, unknown>;
+/**
+ * Returns true for semantic commerce notification webhooks.
+ *
+ * Use `notification.intentId` and `notification.dedupeKey` for semantic
+ * idempotency. `deliveryId`, when present, identifies a delivery attempt for
+ * observability and is not the semantic notification identity.
+ */
+declare function isCommerceNotificationWebhookEvent(event: unknown): event is CommerceNotificationWebhookEvent;
+declare function getCommerceNotificationIdempotencyKey(event: Pick<CommerceNotificationWebhookEvent, 'notification'>): string;
+declare function defineCommerceEmailConfig<TConfig extends CommerceEmailConfig>(config: TConfig): TConfig;
+declare function createCommerceEmailWebhookHandler(handlers: CommerceEmailEventHandlers): WebhookHandler<string, unknown>;
+/** Narrows a webhook event to a specific collection. */
+declare function isWebhookCollection<TCollection extends string>(event: unknown, collection: TCollection): event is WebhookEvent<TCollection, unknown>;
+/** Narrows a webhook event to a specific operation. */
+declare function isWebhookOperation<TOperation extends string>(event: unknown, operation: TOperation): event is WebhookEvent<string, unknown> & {
+    operation: TOperation;
+};
+declare const CUSTOMER_PASSWORD_RESET_OPERATION: "password-reset";
+type WebhookKnownOperation = CollectionWebhookOperation | typeof CUSTOMER_PASSWORD_RESET_OPERATION | typeof COMMERCE_NOTIFICATION_OPERATION;
+interface CustomerPasswordResetWebhookData {
+    customerId: string | number;
+    email: string;
+    name: string;
+    resetPasswordToken: string;
+    resetPasswordExpiresAt: string;
+}
+type CustomerPasswordResetWebhookEvent = WebhookEvent<'customers', CustomerPasswordResetWebhookData> & {
+    operation: typeof CUSTOMER_PASSWORD_RESET_OPERATION;
+};
+type CustomerAuthWebhookEvent = CustomerPasswordResetWebhookEvent;
+interface CustomerAuthWebhookHandlers {
+    passwordReset?: (data: CustomerPasswordResetWebhookData, event: CustomerPasswordResetWebhookEvent) => MaybePromise<void>;
+    unhandled?: (event: WebhookEvent<string, unknown>) => MaybePromise<void>;
+}
+declare function isCustomerPasswordResetWebhookEvent(event: WebhookEvent<string, unknown>): event is CustomerPasswordResetWebhookEvent;
+declare function createCustomerAuthWebhookHandler(handlers: CustomerAuthWebhookHandlers): WebhookHandler<string, unknown>;
+declare function handleWebhook<T extends Collection | string = Collection, TData = T extends Collection ? CollectionType<T> : Record<string, unknown>>(request: Request, handler: WebhookHandler<T, TData>, options?: WebhookOptions): Promise<Response>;
+declare function createTypedWebhookHandler<T extends Collection>(collection: T, handler: (event: WebhookEvent<T>) => Promise<void> | void): WebhookHandler<T>;
+
+export { type WebhookOrderChange as A, type WebhookOrderMoved as B, COMMERCE_NOTIFICATION_EVENTS as C, type WebhookOrderScope as D, createCommerceEmailWebhookHandler as E, createCustomerAuthWebhookHandler as F, createTypedWebhookHandler as G, defineCommerceEmailConfig as H, getCommerceNotificationIdempotencyKey as I, handleWebhook as J, isCommerceNotificationWebhookEvent as K, isCustomerPasswordResetWebhookEvent as L, isOrderChangedWebhookEvent as M, isValidWebhookEvent as N, ORDER_CHANGED_EVENT_TYPE as O, isWebhookCollection as P, isWebhookOperation as Q, type WebhookChange as W, COMMERCE_NOTIFICATION_EVENT_TYPE as a, COMMERCE_NOTIFICATION_OPERATION as b, CUSTOMER_PASSWORD_RESET_OPERATION as c, type CollectionWebhookOperation as d, type CommerceEmailChannel as e, type CommerceEmailConfig as f, type CommerceEmailEventConfig as g, type CommerceEmailEventHandlers as h, type CommerceEmailHandlerContext as i, type CommerceNotification as j, type CommerceNotificationData as k, type CommerceNotificationEventName as l, type CommerceNotificationSource as m, type CommerceNotificationSourceCollection as n, type CommerceNotificationWebhookEvent as o, type CustomerAuthWebhookEvent as p, type CustomerAuthWebhookHandlers as q, type CustomerPasswordResetWebhookData as r, type CustomerPasswordResetWebhookEvent as s, type OrderChangedWebhookEvent as t, type WebhookCommerceNotificationChange as u, type WebhookEvent as v, type WebhookHandler as w, type WebhookKnownOperation as x, type WebhookOperation as y, type WebhookOptions as z };