@forgecart/sdk 1.2.5 → 1.2.6

package/src/error-utils.ts

@@ -0,0 +1,74 @@
+export interface ExtractedError {
+  code: string;
+  variables: Record<string, string>;
+  classification: string;
+  message?: string;
+}
+
+interface GraphQLErrorLike {
+  response?: {
+    errors?: Array<{
+      message?: string;
+      extensions?: Record<string, unknown>;
+    }>;
+  };
+}
+
+/**
+ * Get the first GraphQL error from an error object.
+ * Uses duck-typing so it works across bundler boundaries where instanceof fails.
+ */
+function getFirstGraphQLError(error: unknown): { message?: string; extensions?: Record<string, unknown> } | null {
+  const err = error as GraphQLErrorLike;
+  const errors = err?.response?.errors;
+  if (!Array.isArray(errors) || errors.length === 0) {
+    return null;
+  }
+  return errors[0] ?? null;
+}
+
+/**
+ * Extract the structured error code from a ClientError.
+ * Returns null if the error has no GraphQL error code.
+ */
+export function extractErrorCode(error: unknown): string | null {
+  const firstError = getFirstGraphQLError(error);
+  if (!firstError?.extensions?.['code']) {
+    return null;
+  }
+  return firstError.extensions['code'] as string;
+}
+
+/**
+ * Extract full structured error info from a ClientError.
+ * Returns null if the error has no GraphQL extensions.
+ */
+export function extractError(error: unknown): ExtractedError | null {
+  const firstError = getFirstGraphQLError(error);
+  if (!firstError?.extensions) {
+    return null;
+  }
+
+  return {
+    code: (firstError.extensions['code'] as string) ?? firstError.message,
+    variables: (firstError.extensions['variables'] as Record<string, string>) ?? {},
+    classification: (firstError.extensions['classification'] as string) ?? 'UNKNOWN',
+    message: (firstError.extensions['message'] as string) ?? undefined,
+  };
+}
+
+/**
+ * Extract the localized error message from a ClientError.
+ * Returns null if the error has no localized message.
+ */
+export function extractErrorMessage(error: unknown): string | null {
+  const firstError = getFirstGraphQLError(error);
+  return (firstError?.extensions?.['message'] as string) ?? null;
+}
+
+/**
+ * Check if an error has a specific error code.
+ */
+export function isErrorCode(error: unknown, code: string): boolean {
+  return extractErrorCode(error) === code;
+}

package/src/hook-event-map.generated.ts

@@ -0,0 +1,252 @@
+/* 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.
+ */
+
+
+import type { AddIdentityToSegmentInput, Administrator, Asset, AudienceMembership, AudienceSegment, Channel, ChannelPlugin, Collection, Country, CreateAdministratorInput, CreateAssetInput, CreateAudienceSegmentInput, CreateChannelInput, CreateCollectionInput, CreateCountryInput, CreateCustomerGroupInput, CreateCustomerInput, CreateFacetInput, CreateFacetValueInput, CreateFulfillmentInput, CreateProductInput, CreateProductVariantInput, CreatePromotionInput, CreateRoleInput, CreateSellerInput, CreateStockLocationInput, CreateTaxCategoryInput, CreateTaxRateInput, CreateZoneInput, Customer, CustomerGroup, Facet, FacetValue, Fulfillment, HistoryEntry, Order, Product, ProductVariant, Promotion, RegisterCustomerInput, RemoveIdentityFromSegmentInput, Role, Seller, StockLocation, TaxCategory, TaxRate, UpdateAdministratorInput, UpdateAssetInput, UpdateAudienceSegmentInput, UpdateChannelInput, UpdateChannelPluginConfigInput, UpdateCollectionInput, UpdateCountryInput, UpdateCustomerGroupInput, UpdateCustomerInput, UpdateFacetInput, UpdateFacetValueInput, UpdateProductInput, UpdateProductVariantInput, UpdatePromotionInput, UpdateRoleInput, UpdateSellerInput, UpdateStockLocationInput, UpdateTaxCategoryInput, UpdateTaxRateInput, UpdateZoneInput, Zone } from './admin-types.generated';
+import type { TransactionContext } from './client.generated';
+
+export interface AdminHookEventMap {
+  'asset.create.before': CreateAssetInput;
+  'asset.create.after': Asset;
+  'asset.create.async': Asset;
+  'asset.update.before': UpdateAssetInput;
+  'asset.update.after': Asset;
+  'asset.update.async': Asset;
+  'asset.executeSingleAssetDelete.before': void;
+  'asset.executeSingleAssetDelete.after': Asset;
+  'asset.executeSingleAssetDelete.async': Asset;
+  'asset.createFromUrl.before': string;
+  'asset.createFromUrl.after': Asset;
+  'asset.createFromUrl.async': Asset;
+  'administrator.create.before': CreateAdministratorInput;
+  'administrator.create.after': Administrator;
+  'administrator.create.async': Administrator;
+  'administrator.update.before': UpdateAdministratorInput;
+  'administrator.update.after': Administrator;
+  'administrator.update.async': Administrator;
+  'administrator.softDelete.before': string;
+  'administrator.softDelete.after': Administrator;
+  'administrator.softDelete.async': Administrator;
+  'administrator.inviteExistingUser.before': void;
+  'administrator.inviteExistingUser.after': Administrator;
+  'administrator.inviteExistingUser.async': Administrator;
+  'administrator.inviteNewUser.before': void;
+  'administrator.inviteNewUser.after': Administrator;
+  'administrator.inviteNewUser.async': Administrator;
+  'authentication.attemptLogin.before': unknown;
+  'authentication.attemptLogin.after': unknown;
+  'authentication.attemptLogin.async': unknown;
+  'role.create.before': CreateRoleInput;
+  'role.create.after': Role;
+  'role.create.async': Role;
+  'role.update.before': UpdateRoleInput;
+  'role.update.after': Role;
+  'role.update.async': Role;
+  'role.executeRoleDelete.before': void;
+  'role.executeRoleDelete.after': Role;
+  'role.executeRoleDelete.async': Role;
+  'collection.create.before': CreateCollectionInput;
+  'collection.create.after': Collection;
+  'collection.create.async': Collection;
+  'collection.update.before': UpdateCollectionInput;
+  'collection.update.after': Collection;
+  'collection.update.async': Collection;
+  'collection.executeCollectionDelete.before': void;
+  'collection.executeCollectionDelete.after': Collection;
+  'collection.executeCollectionDelete.async': Collection;
+  'facet.create.before': CreateFacetInput;
+  'facet.create.after': Facet;
+  'facet.create.async': Facet;
+  'facet.update.before': UpdateFacetInput;
+  'facet.update.after': Facet;
+  'facet.update.async': Facet;
+  'facet.executeFacetDelete.before': void;
+  'facet.executeFacetDelete.after': Facet;
+  'facet.executeFacetDelete.async': Facet;
+  'facetValue.create.before': CreateFacetValueInput;
+  'facetValue.create.after': FacetValue;
+  'facetValue.create.async': FacetValue;
+  'facetValue.update.before': UpdateFacetValueInput;
+  'facetValue.update.after': FacetValue;
+  'facetValue.update.async': FacetValue;
+  'facetValue.executeFacetValueDelete.before': void;
+  'facetValue.executeFacetValueDelete.after': FacetValue;
+  'facetValue.executeFacetValueDelete.async': FacetValue;
+  'channel.create.before': CreateChannelInput;
+  'channel.create.after': Channel;
+  'channel.create.async': Channel;
+  'channel.update.before': UpdateChannelInput;
+  'channel.update.after': Channel;
+  'channel.update.async': Channel;
+  'channel.delete.before': string;
+  'channel.delete.after': Channel;
+  'channel.delete.async': Channel;
+  'customer.create.before': CreateCustomerInput;
+  'customer.create.after': Customer;
+  'customer.create.async': Customer;
+  'customer.update.before': UpdateCustomerInput;
+  'customer.update.after': Customer;
+  'customer.update.async': Customer;
+  'customer.performSoftDelete.before': string;
+  'customer.performSoftDelete.after': Customer;
+  'customer.performSoftDelete.async': Customer;
+  'customer.registerCustomerAccount.before': RegisterCustomerInput;
+  'customer.registerCustomerAccount.after': Customer;
+  'customer.registerCustomerAccount.async': Customer;
+  'customer.createCustomerForRegistration.before': void;
+  'customer.createCustomerForRegistration.after': Customer;
+  'customer.createCustomerForRegistration.async': Customer;
+  'customerGroup.create.before': CreateCustomerGroupInput;
+  'customerGroup.create.after': CustomerGroup;
+  'customerGroup.create.async': CustomerGroup;
+  'customerGroup.update.before': UpdateCustomerGroupInput;
+  'customerGroup.update.after': CustomerGroup;
+  'customerGroup.update.async': CustomerGroup;
+  'customerGroup.executeCustomerGroupDelete.before': void;
+  'customerGroup.executeCustomerGroupDelete.after': CustomerGroup;
+  'customerGroup.executeCustomerGroupDelete.async': CustomerGroup;
+  'country.create.before': CreateCountryInput;
+  'country.create.after': Country;
+  'country.create.async': Country;
+  'country.update.before': UpdateCountryInput;
+  'country.update.after': Country;
+  'country.update.async': Country;
+  'country.executeCountryDelete.before': void;
+  'country.executeCountryDelete.after': Country;
+  'country.executeCountryDelete.async': Country;
+  'zone.create.before': CreateZoneInput;
+  'zone.create.after': Zone;
+  'zone.create.async': Zone;
+  'zone.update.before': UpdateZoneInput;
+  'zone.update.after': Zone;
+  'zone.update.async': Zone;
+  'zone.delete.before': string;
+  'zone.delete.after': Zone;
+  'zone.delete.async': Zone;
+  'product.create.before': CreateProductInput;
+  'product.create.after': Product;
+  'product.create.async': Product;
+  'product.update.before': UpdateProductInput;
+  'product.update.after': Product;
+  'product.update.async': Product;
+  'product.executeProductDelete.before': void;
+  'product.executeProductDelete.after': Product;
+  'product.executeProductDelete.async': Product;
+  'productVariant.createSingleVariant.before': CreateProductVariantInput;
+  'productVariant.createSingleVariant.after': ProductVariant;
+  'productVariant.createSingleVariant.async': ProductVariant;
+  'productVariant.updateSingleVariant.before': UpdateProductVariantInput;
+  'productVariant.updateSingleVariant.after': ProductVariant;
+  'productVariant.updateSingleVariant.async': ProductVariant;
+  'productVariant.deleteSingleVariant.before': string;
+  'productVariant.deleteSingleVariant.after': ProductVariant;
+  'productVariant.deleteSingleVariant.async': ProductVariant;
+  'promotion.create.before': CreatePromotionInput;
+  'promotion.create.after': Promotion;
+  'promotion.create.async': Promotion;
+  'promotion.update.before': UpdatePromotionInput;
+  'promotion.update.after': Promotion;
+  'promotion.update.async': Promotion;
+  'promotion.executePromotionDelete.before': void;
+  'promotion.executePromotionDelete.after': Promotion;
+  'promotion.executePromotionDelete.async': Promotion;
+  'seller.create.before': CreateSellerInput;
+  'seller.create.after': Seller;
+  'seller.create.async': Seller;
+  'seller.update.before': UpdateSellerInput;
+  'seller.update.after': Seller;
+  'seller.update.async': Seller;
+  'seller.softDelete.before': string;
+  'seller.softDelete.after': Seller;
+  'seller.softDelete.async': Seller;
+  'stockLocation.create.before': CreateStockLocationInput;
+  'stockLocation.create.after': StockLocation;
+  'stockLocation.create.async': StockLocation;
+  'stockLocation.update.before': UpdateStockLocationInput;
+  'stockLocation.update.after': StockLocation;
+  'stockLocation.update.async': StockLocation;
+  'stockLocation.executeStockLocationDelete.before': void;
+  'stockLocation.executeStockLocationDelete.after': StockLocation;
+  'stockLocation.executeStockLocationDelete.async': StockLocation;
+  'taxCategory.create.before': CreateTaxCategoryInput;
+  'taxCategory.create.after': TaxCategory;
+  'taxCategory.create.async': TaxCategory;
+  'taxCategory.update.before': UpdateTaxCategoryInput;
+  'taxCategory.update.after': TaxCategory;
+  'taxCategory.update.async': TaxCategory;
+  'taxCategory.executeTaxCategoryDelete.before': void;
+  'taxCategory.executeTaxCategoryDelete.after': TaxCategory;
+  'taxCategory.executeTaxCategoryDelete.async': TaxCategory;
+  'taxRate.create.before': CreateTaxRateInput;
+  'taxRate.create.after': TaxRate;
+  'taxRate.create.async': TaxRate;
+  'taxRate.update.before': UpdateTaxRateInput;
+  'taxRate.update.after': TaxRate;
+  'taxRate.update.async': TaxRate;
+  'taxRate.delete.before': string;
+  'taxRate.delete.after': TaxRate;
+  'taxRate.delete.async': TaxRate;
+  'fulfillment.createFulfillment.before': CreateFulfillmentInput;
+  'fulfillment.createFulfillment.after': Fulfillment;
+  'fulfillment.createFulfillment.async': Fulfillment;
+  'fulfillment.executeFulfillmentTransition.before': unknown;
+  'fulfillment.executeFulfillmentTransition.after': unknown;
+  'fulfillment.executeFulfillmentTransition.async': unknown;
+  'order.createDraft.before': void;
+  'order.createDraft.after': Order;
+  'order.createDraft.async': Order;
+  'order.create.before': void;
+  'order.create.after': Order;
+  'order.create.async': Order;
+  'payment.executePaymentTransition.before': unknown;
+  'payment.executePaymentTransition.after': unknown;
+  'payment.executePaymentTransition.async': unknown;
+  'channelPlugin.enable.before': string;
+  'channelPlugin.enable.after': ChannelPlugin;
+  'channelPlugin.enable.async': ChannelPlugin;
+  'channelPlugin.disable.before': string;
+  'channelPlugin.disable.after': ChannelPlugin;
+  'channelPlugin.disable.async': ChannelPlugin;
+  'channelPlugin.updateConfiguration.before': UpdateChannelPluginConfigInput;
+  'channelPlugin.updateConfiguration.after': ChannelPlugin;
+  'channelPlugin.updateConfiguration.async': ChannelPlugin;
+  'history.createForOrder.before': unknown;
+  'history.createForOrder.after': HistoryEntry;
+  'history.createForOrder.async': HistoryEntry;
+  'history.createForCustomer.before': unknown;
+  'history.createForCustomer.after': HistoryEntry;
+  'history.createForCustomer.async': HistoryEntry;
+  'history.updateEntry.before': unknown;
+  'history.updateEntry.after': HistoryEntry;
+  'history.updateEntry.async': HistoryEntry;
+  'history.deleteEntry.before': string;
+  'history.deleteEntry.after': HistoryEntry;
+  'history.deleteEntry.async': HistoryEntry;
+  'audienceSegment.create.before': CreateAudienceSegmentInput;
+  'audienceSegment.create.after': AudienceSegment;
+  'audienceSegment.create.async': AudienceSegment;
+  'audienceSegment.update.before': UpdateAudienceSegmentInput;
+  'audienceSegment.update.after': AudienceSegment;
+  'audienceSegment.update.async': AudienceSegment;
+  'audienceSegment.delete.before': string;
+  'audienceSegment.delete.after': AudienceSegment;
+  'audienceSegment.delete.async': AudienceSegment;
+  'audienceMembership.addIdentityToSegment.before': AddIdentityToSegmentInput;
+  'audienceMembership.addIdentityToSegment.after': AudienceMembership;
+  'audienceMembership.addIdentityToSegment.async': AudienceMembership;
+  'audienceMembership.removeIdentityFromSegment.before': RemoveIdentityFromSegmentInput;
+  'audienceMembership.removeIdentityFromSegment.after': AudienceMembership;
+  'audienceMembership.removeIdentityFromSegment.async': AudienceMembership;
+}
+
+export type AdminHookPoint = keyof AdminHookEventMap;
+
+export type AdminHookHandler<K extends AdminHookPoint> =
+  AdminHookEventMap[K] extends void
+    ? (ctx: TransactionContext) => Promise<void>
+    : (ctx: TransactionContext, payload: AdminHookEventMap[K]) => Promise<void>;

package/src/index.ts

@@ -1,115 +1,23 @@
-/**
- * @forgecart/sdk - Auto-generated TypeScript SDK
- *
- * This file was automatically generated and should not be manually edited.
- * To regenerate, run: npm run codegen:ts
- *
- * 🤖 Generated with ForgeCart SDK Generator
- */
-
-import { AdminNamespace, AdminSDKConfig } from './admin.js'
-import { ShopNamespace, ShopSDKConfig } from './shop.js'
-
-/**
- * Unified SDK Configuration
- */
-export interface ForgeCartSDKConfig {
-  /** Base API endpoint (e.g., 'https://api.forgecart.com') */
-  endpoint?: string
-  /** Channel token for Vendure multi-tenancy (required) */
-  token: string
-  /** Use HTTP only, skip WebSocket initialization (default: false) */
-  httpOnly?: boolean
-  /** Enable debug logging with request timing (default: false) */
-  debug?: boolean
-  /** Custom HTTP headers */
-  headers?: Record<string, string>
-  /** Custom WebSocket implementation (optional, auto-detected if not provided) */
-  webSocketImpl?: unknown
-}
-
-// Re-export individual namespace configs and classes
-export type { AdminSDKConfig, ShopSDKConfig }
-export { AdminNamespace, ShopNamespace }
-
-/**
- * ForgeCartSDK
- * Unified SDK with categorized operations across multiple namespaces
- *
- * @example
- * ```typescript
- * const sdk = new ForgeCartSDK({
- *   endpoint: 'https://api.forgecart.com',
- *   token: 'your-channel-token',
- * });
- *
- * // Admin namespace → Category → Operations
- * await sdk.admin.products.products({ take: 10 });
- * await sdk.admin.customer.customer({ id: '1' });
- *
- * // Shop namespace → Category → Operations
- * await sdk.shop.products.products({ take: 10 });
- * await sdk.shop.order.addItemToOrder({ productVariantId: '1', quantity: 1 });
- * ```
- */
-export class ForgeCartSDK {
-  readonly admin: AdminNamespace
-  readonly shop: ShopNamespace
-
-  constructor(config: ForgeCartSDKConfig) {
-    // Validate channel token is provided
-    if (!config.token || config.token.trim() === '') {
-      throw new Error('ForgeCartSDK: Channel token is required. Please provide a valid "token" in the configuration.')
-    }
-
-    const baseEndpoint = config.endpoint || 'https://api.forgecart.com'
-    const baseWsEndpoint = baseEndpoint.replace('http', 'ws')
-
-    // Build headers with token
-    const headers: Record<string, string> = {
-      ...config.headers,
-      'forge-token': config.token,
-    }
-
-    const adminConfig: AdminSDKConfig = {
-      endpoint: `${baseEndpoint}/admin-api`,
-      wsEndpoint: `${baseWsEndpoint}/admin-api`,
-      headers,
-      webSocketImpl: config.webSocketImpl,
-      httpOnly: config.httpOnly,
-      debug: config.debug,
-    }
-    this.admin = new AdminNamespace(adminConfig)
-
-    const shopConfig: ShopSDKConfig = {
-      endpoint: `${baseEndpoint}/shop-api`,
-      wsEndpoint: `${baseWsEndpoint}/shop-api`,
-      headers,
-      webSocketImpl: config.webSocketImpl,
-      httpOnly: config.httpOnly,
-      debug: config.debug,
-    }
-    this.shop = new ShopNamespace(shopConfig)
-  }
-
-  setAdminAuthToken(token: string): void {
-    this.admin.setAuthToken(token)
-  }
-
-  clearAdminAuthToken(): void {
-    this.admin.clearAuthToken()
-  }
-
-  setShopAuthToken(token: string): void {
-    this.shop.setAuthToken(token)
-  }
-
-  clearShopAuthToken(): void {
-    this.shop.clearAuthToken()
-  }
-
-  dispose(): void {
-    this.admin.dispose()
-    this.shop.dispose()
-  }
-}
+export { ForgeCartAdminClient } from './client.generated';
+export { ForgeCartShopClient } from './client.generated';
+export { ForgeCartClient, ClientError, QueryObservable } from './client.generated';
+export type { GraphQLErrorResponse } from './client.generated';
+export type { ForgeCartAdminClientConfig } from './client.generated';
+export type { ForgeCartShopClientConfig } from './client.generated';
+export type { ForgeCartClientConfig } from './client.generated';
+export { TransactionContext } from './client.generated';
+export { ForgeCartGraphQLModule } from './client.generated';
+export { AdminNamespace } from './admin.generated';
+export { ShopNamespace } from './shop.generated';
+export type { ID, Type, ApiExtension, IRequestContext, HookHandler } from './sdk-types.generated';
+export type { IFulfillmentHandler, FulfillmentHandlerCapabilities, OrderLineInput } from './sdk-types.generated';
+export { SdkError, SdkErrorCode } from './sdk-types.generated';
+export type { ConfigurationItem, ManageableConfig, IHookRegistry } from './sdk-plugin.generated';
+export { ForgeCartPlugin } from './sdk-plugin.generated';
+export type { HookDispatchEvent, HookSubscription } from './sdk-hook-subscription.generated';
+export { hookDispatchDocument, hookRespondDocument, HookSubscriptionManager } from './sdk-hook-subscription.generated';
+export type { AdminHookEventMap, AdminHookPoint, AdminHookHandler } from './hook-event-map.generated';
+export type { AcfFieldType } from './admin-types.generated';
+export { extractErrorCode, extractError, extractErrorMessage, isErrorCode } from './error-utils';
+export type { ExtractedError } from './error-utils';
+export { Observable, firstValueFrom, lastValueFrom } from 'rxjs';

package/src/sdk-hook-subscription.generated.ts

@@ -0,0 +1,93 @@
+/* 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.
+ */
+
+import { Observable, firstValueFrom } from 'rxjs';
+import type { IRequestContext } from './sdk-types.generated';
+
+export interface HookDispatchEvent {
+  id: string;
+  hookPoint: string;
+  transactionToken: string;
+  subscriberId: string;
+  args: unknown[];
+}
+
+export const hookDispatchDocument = `
+  subscription OnHookDispatch($hookPoints: [String!]!) {
+    hookDispatched(hookPoints: $hookPoints) {
+      id
+      hookPoint
+      transactionToken
+      subscriberId
+      args
+    }
+  }
+`;
+
+export const hookRespondDocument = `
+  mutation RespondToHook($input: RespondToHookDispatchInput!) {
+    respondToHookDispatch(input: $input)
+  }
+`;
+
+export interface HookSubscription {
+  unsubscribe(): void;
+  readonly closed: Promise<void>;
+}
+
+export class HookSubscriptionManager<TContext = unknown> {
+  constructor(
+    private readonly subscribeFn: (hookPoints: string[]) => Observable<{ hookDispatched: HookDispatchEvent }>,
+    private readonly respondFn: (id: string, subscriberId: string, error?: string) => Observable<unknown>,
+    private readonly createContext: (transactionToken: string) => TContext,
+  ) {}
+
+  on(
+    hookPoints: string[],
+    handler: (ctx: TContext, payload?: unknown) => Promise<void>,
+  ): HookSubscription {
+    let resolveClose: (() => void) | undefined;
+    const closed = new Promise<void>((resolve) => { resolveClose = resolve; });
+
+    const subscription = this.subscribeFn(hookPoints).subscribe({
+      next: async (value) => {
+        const event = value.hookDispatched;
+        const suffix = event.hookPoint.split('.').pop();
+        const ctx = this.createContext(event.transactionToken);
+        const payload = Array.isArray(event.args) && event.args.length > 0
+          ? event.args[0]
+          : undefined;
+        try {
+          await handler(ctx, payload);
+          if (suffix === 'before' || suffix === 'after') {
+            await firstValueFrom(this.respondFn(event.id, event.subscriberId));
+          }
+        } catch (error: unknown) {
+          if (suffix === 'before' || suffix === 'after') {
+            await firstValueFrom(this.respondFn(
+              event.id,
+              event.subscriberId,
+              error instanceof Error ? error.message : String(error),
+            ));
+          }
+        }
+      },
+      error: () => {
+        resolveClose?.();
+      },
+      complete: () => {
+        resolveClose?.();
+      },
+    });
+
+    return {
+      unsubscribe: () => { subscription.unsubscribe(); },
+      closed,
+    };
+  }
+}

package/src/sdk-plugin.generated.ts

@@ -0,0 +1,59 @@
+/* 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.
+ */
+
+import type { Type, ApiExtension, HookHandler } from './sdk-types.generated';
+
+export interface ConfigurationItem {
+  readonly code: string;
+  readonly label: string;
+  readonly description?: string;
+  readonly type: 'string' | 'number' | 'boolean' | 'json';
+  readonly defaultValue?: unknown;
+}
+
+export interface ManageableConfig {
+  readonly description: string;
+  readonly imageUrl?: string;
+  readonly tags: string[];
+  readonly configurationItems: ConfigurationItem[];
+}
+
+export interface IHookRegistry {
+  on(
+    hookPoint: string,
+    handler: HookHandler,
+    priority?: number,
+  ): void;
+}
+
+export abstract class ForgeCartPlugin {
+  abstract readonly code: string;
+  abstract readonly name: string;
+  abstract readonly version: string;
+
+  readonly entities: Type[] = [];
+  readonly services: Type[] = [];
+  readonly resolvers: Type[] = [];
+  readonly controllers: Type[] = [];
+  readonly adminApiExtensions?: ApiExtension;
+  readonly shopApiExtensions?: ApiExtension;
+
+  register(_hooks: IHookRegistry): void {
+    // no-op default
+  }
+  onBootstrap(): Promise<void> {
+    // no-op default
+    return Promise.resolve();
+  }
+  onShutdown(): Promise<void> {
+    // no-op default
+    return Promise.resolve();
+  }
+
+  readonly manageable?: ManageableConfig;
+}