@forgecart/sdk 1.2.5 → 1.2.6

package/src/sdk-types.generated.ts

@@ -0,0 +1,79 @@
+/* eslint-disable */
+/**
+ * AUTO-GENERATED FILE — DO NOT EDIT
+ *
+ * This file was generated by @forgecart/client-sdk-generators.
+ * Any manual changes will be overwritten on the next generation run.
+ */
+
+export type ID = string & { readonly __brand?: 'ID' };
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- constructor signature requires any[]
+export type Type<T = unknown> = new (...args: any[]) => T;
+
+export interface ApiExtension {
+  schema?: unknown;
+  resolvers?: Type[];
+}
+
+/** Minimal RequestContext interface for SDK consumers */
+export interface IRequestContext {
+  readonly channelId: string;
+  readonly channelToken: string;
+  readonly apiType: 'admin' | 'shop';
+  readonly languageCode: string;
+  readonly hookDepth: number;
+  /** Cross-process correlation token set by the platform during hook dispatch */
+  readonly transactionToken?: string;
+}
+
+export type HookHandler = (...args: unknown[]) => Promise<void>;
+
+export interface FulfillmentHandlerCapabilities {
+  supportsTracking: boolean;
+  requiresShippingAddress: boolean;
+  autoFulfillOnPayment: boolean;
+  autoDeliver: boolean;
+  autoCreateLabel: boolean;
+  supportsReturn: boolean;
+}
+
+export interface OrderLineInput {
+  orderLineId: ID;
+  variantId: ID;
+  quantity: number;
+}
+
+export interface IFulfillmentHandler {
+  readonly code: string;
+  readonly name: string;
+  getCapabilities(): FulfillmentHandlerCapabilities;
+  groupLines(
+    ctx: IRequestContext,
+    lines: OrderLineInput[],
+  ): Promise<OrderLineInput[][]>;
+  onCreated(ctx: IRequestContext, fulfillment: unknown): Promise<unknown>;
+  onStateTransition(
+    ctx: IRequestContext,
+    fulfillment: unknown,
+    fromState: string,
+    toState: string,
+  ): Promise<unknown>;
+}
+
+export enum SdkErrorCode {
+  SERVICE_NOT_FOUND = 'SERVICE_NOT_FOUND',
+  METHOD_NOT_FOUND = 'METHOD_NOT_FOUND',
+  WEBSOCKET_TIMEOUT = 'WEBSOCKET_TIMEOUT',
+}
+
+export class SdkError extends Error {
+  constructor(
+    public readonly code: SdkErrorCode,
+    public readonly variables: Record<string, string> = {},
+  ) {
+    super(code);
+    this.name = 'SdkError';
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}