@forgecart/sdk 1.202608121449.0 → 1.202608161317.0

package/README.md

@@ -57,7 +57,7 @@ const order = await client.shop.cart.addItemToOrder({ variantId, quantity: 1 });
 ## Namespaces
 
 - `client.admin` — entry, fieldDefinition, publish, acfSchema, acf, administrator, analyticsGateway, asset, audienceMembership, audienceSegment, auth, automation, settings, channel, chat, collection, country, address, group, customerAnalytics, customer, deployment, designerTask, experiment, facet, fulfillmentRequest, fulfillment, hookDispatch, hook, market, marketingAttribution, marketingEvent, marketingIdentity, mission, onboarding, coupon, draft, modification, note, orderAnalytics, order, payment, manageable, plugin, optionGroup, option, productVariant, product, promotion, role, scheduledJob, search, seller, sellingPlan, shipping, stockAnalytics, stock, storefrontRouteTree, subscriptionAnalytics, subscription, tax, transaction, zone
-- `client.shop` — acf, auth, cart, channel, checkout, collection, country, customer, experiment, facet, hookDispatch, hook, marketingEvent, marketingIdentity, order, payment, product, search, sellingPlan, shipping, subscription
+- `client.shop` — acf, address, auth, cart, channel, checkout, collection, country, customer, experiment, facet, hookDispatch, hook, marketingEvent, marketingIdentity, order, payment, product, search, sellingPlan, shipping, subscription
 
 ## NestJS Integration
 

package/dist/admin-client.generated.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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 { AdminNamespace } from './admin.generated';
+import type * as Admin from './admin.generated';
+import type { AdminExternalAuthResult, ErrorHandler, ForgeCartAdminClientConfig, LoginSession, QueryObservable } from './client.generated';
+import type { HookSubscription } from './sdk-hook-subscription.generated';
+import type { AdminHookPoint, AdminHookHandler } from './hook-event-map.generated';
+import type { ShopNamespace } from './shop.generated';
+import type { ForgeCartShopClient } from './shop-client.generated';
+export declare class TransactionContext {
+    private readonly _admin;
+    private readonly _shop;
+    constructor(admin: AdminNamespace, shop?: ShopNamespace);
+    get admin(): AdminNamespace;
+    get shop(): ShopNamespace;
+}
+export declare class ForgeCartAdminClient {
+    private readonly client;
+    private readonly _namespace;
+    constructor(config: ForgeCartAdminClientConfig);
+    setAuthToken(token: string): void;
+    getAuthToken(): string | null;
+    clearAuthToken(): void;
+    setCurrencyCode(currencyCode: string): void;
+    clearCurrencyCode(): void;
+    setLanguageCode(languageCode: string): void;
+    clearLanguageCode(): void;
+    setTransactionToken(token: string): void;
+    clearTransactionToken(): void;
+    setErrorHandler(handler: ErrorHandler): void;
+    dispose(): void;
+    query<T>(document: string, variables?: Record<string, unknown>): QueryObservable<T>;
+    mutate<T>(document: string, variables?: Record<string, unknown>): QueryObservable<T>;
+    private shopPeer;
+    setShopPeer(shop: ForgeCartShopClient): void;
+    createScopedNamespace(transactionToken: string): AdminNamespace;
+    withTransaction<T>(fn: (ctx: TransactionContext) => Promise<T>): Promise<T>;
+    private hookManager;
+    on<K extends AdminHookPoint>(hookPoints: K[], handler: AdminHookHandler<K>): HookSubscription;
+    login(emailAddress: string, password: string): Promise<LoginSession>;
+    loginWithExternalStrategy(strategyCode: string, data: Record<string, unknown>): Promise<AdminExternalAuthResult>;
+    logout(): Promise<void>;
+    get acf(): Admin.AcfCategory;
+    get acfSchema(): Admin.AcfSchemaCategory;
+    get administrator(): Admin.AdministratorCategory;
+    get analyticsGateway(): Admin.AnalyticsGatewayCategory;
+    get asset(): Admin.AssetCategory;
+    get audienceMembership(): Admin.AudienceMembershipCategory;
+    get audienceSegment(): Admin.AudienceSegmentCategory;
+    get auth(): Admin.AuthCategory;
+    get automation(): Admin.AutomationCategory;
+    get channel(): Admin.ChannelCategory;
+    get chat(): Admin.ChatCategory;
+    get collection(): Admin.CollectionCategory;
+    get country(): Admin.CountryCategory;
+    get customer(): Admin.CustomerCategory;
+    get customerAnalytics(): Admin.CustomerAnalyticsCategory;
+    get deployment(): Admin.DeploymentCategory;
+    get designerTask(): Admin.DesignerTaskCategory;
+    get experiment(): Admin.ExperimentCategory;
+    get facet(): Admin.FacetCategory;
+    get fulfillment(): Admin.FulfillmentCategory;
+    get fulfillmentRequest(): Admin.FulfillmentRequestCategory;
+    get hook(): Admin.HookCategory;
+    get hookDispatch(): Admin.HookDispatchCategory;
+    get market(): Admin.MarketCategory;
+    get marketingAttribution(): Admin.MarketingAttributionCategory;
+    get marketingEvent(): Admin.MarketingEventCategory;
+    get marketingIdentity(): Admin.MarketingIdentityCategory;
+    get mission(): Admin.MissionCategory;
+    get onboarding(): Admin.OnboardingCategory;
+    get order(): Admin.OrderCategory;
+    get orderAnalytics(): Admin.OrderAnalyticsCategory;
+    get payment(): Admin.PaymentCategory;
+    get plugin(): Admin.PluginCategory;
+    get product(): Admin.ProductCategory;
+    get productVariant(): Admin.ProductVariantCategory;
+    get promotion(): Admin.PromotionCategory;
+    get role(): Admin.RoleCategory;
+    get scheduledJob(): Admin.ScheduledJobCategory;
+    get search(): Admin.SearchCategory;
+    get seller(): Admin.SellerCategory;
+    get sellingPlan(): Admin.SellingPlanCategory;
+    get shipping(): Admin.ShippingCategory;
+    get stock(): Admin.StockCategory;
+    get stockAnalytics(): Admin.StockAnalyticsCategory;
+    get storefrontRouteTree(): Admin.StorefrontRouteTreeCategory;
+    get subscription(): Admin.SubscriptionCategory;
+    get subscriptionAnalytics(): Admin.SubscriptionAnalyticsCategory;
+    get tax(): Admin.TaxCategory;
+    get transaction(): Admin.TransactionCategory;
+    get zone(): Admin.ZoneCategory;
+}

package/dist/admin-client.generated.js

@@ -0,0 +1,295 @@
+"use strict";
+/* 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForgeCartAdminClient = exports.TransactionContext = void 0;
+const rxjs_1 = require("rxjs");
+const admin_generated_1 = require("./admin.generated");
+const client_generated_1 = require("./client.generated");
+const sdk_hook_subscription_generated_1 = require("./sdk-hook-subscription.generated");
+class TransactionContext {
+    _admin;
+    _shop;
+    constructor(admin, shop) {
+        this._admin = admin;
+        this._shop = shop;
+    }
+    get admin() {
+        return this._admin;
+    }
+    get shop() {
+        if (!this._shop) {
+            throw new Error('SHOP_NAMESPACE_NOT_AVAILABLE');
+        }
+        return this._shop;
+    }
+}
+exports.TransactionContext = TransactionContext;
+class ForgeCartAdminClient {
+    client;
+    _namespace;
+    constructor(config) {
+        const headers = { 'forgecart-token': config.channelToken, ...config.headers };
+        if (config.adminSecret) {
+            headers['forgecart-secret'] = config.adminSecret;
+        }
+        this.client = new client_generated_1.BaseGraphQLClient(config.endpoint, headers, config.uploadEndpoint, {
+            wsEndpoint: config.wsEndpoint,
+            currencyCode: config.currencyCode,
+            languageCode: config.languageCode,
+        });
+        this._namespace = new admin_generated_1.AdminNamespace(this.client);
+    }
+    setAuthToken(token) {
+        this.client.setAuthToken(token);
+    }
+    getAuthToken() {
+        return this.client.getAuthToken();
+    }
+    clearAuthToken() {
+        this.client.clearAuthToken();
+    }
+    setCurrencyCode(currencyCode) {
+        this.client.setCurrencyCode(currencyCode);
+    }
+    clearCurrencyCode() {
+        this.client.clearCurrencyCode();
+    }
+    setLanguageCode(languageCode) {
+        this.client.setLanguageCode(languageCode);
+    }
+    clearLanguageCode() {
+        this.client.clearLanguageCode();
+    }
+    setTransactionToken(token) {
+        this.client.setTransactionToken(token);
+    }
+    clearTransactionToken() {
+        this.client.clearTransactionToken();
+    }
+    setErrorHandler(handler) {
+        this.client.setErrorHandler(handler);
+    }
+    dispose() {
+        this.client.dispose();
+    }
+    query(document, variables) {
+        return this.client.query(document, variables);
+    }
+    mutate(document, variables) {
+        return this.client.mutate(document, variables);
+    }
+    shopPeer = null;
+    setShopPeer(shop) {
+        this.shopPeer = shop;
+    }
+    createScopedNamespace(transactionToken) {
+        return new admin_generated_1.AdminNamespace(this.client.fork(transactionToken));
+    }
+    async withTransaction(fn) {
+        const result = await (0, rxjs_1.firstValueFrom)(this.transaction.beginTransaction());
+        const token = result.beginTransaction.token;
+        const adminNs = this.createScopedNamespace(token);
+        const shopNs = this.shopPeer?.createScopedNamespace(token);
+        const ctx = new TransactionContext(adminNs, shopNs);
+        try {
+            const value = await fn(ctx);
+            await (0, rxjs_1.firstValueFrom)(this.transaction.commitTransaction({ token }));
+            return value;
+        }
+        catch (error) {
+            await (0, rxjs_1.firstValueFrom)(this.transaction.rollbackTransaction({ token })).catch(() => { });
+            throw error;
+        }
+    }
+    hookManager = null;
+    on(hookPoints, handler) {
+        if (!this.hookManager) {
+            this.hookManager = new sdk_hook_subscription_generated_1.HookSubscriptionManager((hp) => this.client.subscribe(sdk_hook_subscription_generated_1.hookDispatchDocument, { hookPoints: hp }), (id, subscriberId, error) => this.client.mutate(sdk_hook_subscription_generated_1.hookRespondDocument, { input: { id, subscriberId, error } }), (token) => {
+                const adminNs = this.createScopedNamespace(token);
+                const shopNs = this.shopPeer?.createScopedNamespace(token);
+                return new TransactionContext(adminNs, shopNs);
+            });
+        }
+        return this.hookManager.on(hookPoints, handler);
+    }
+    async login(emailAddress, password) {
+        const result = await (0, rxjs_1.firstValueFrom)(this.auth.login({ input: { emailAddress, password } }));
+        this.client.setAuthToken(result.login.token);
+        if (this.shopPeer) {
+            this.shopPeer.setAuthToken(result.login.token);
+        }
+        return result.login;
+    }
+    async loginWithExternalStrategy(strategyCode, data) {
+        const result = await (0, rxjs_1.firstValueFrom)(this.auth.authenticateWithExternalStrategy({ input: { strategyCode, data } }));
+        this.client.setAuthToken(result.authenticateWithExternalStrategy.session.token);
+        if (this.shopPeer) {
+            this.shopPeer.setAuthToken(result.authenticateWithExternalStrategy.session.token);
+        }
+        return result.authenticateWithExternalStrategy;
+    }
+    async logout() {
+        await (0, rxjs_1.firstValueFrom)(this.auth.logout());
+        this.client.clearAuthToken();
+        if (this.shopPeer) {
+            this.shopPeer.clearAuthToken();
+        }
+    }
+    get acf() {
+        return this._namespace.acf;
+    }
+    get acfSchema() {
+        return this._namespace.acfSchema;
+    }
+    get administrator() {
+        return this._namespace.administrator;
+    }
+    get analyticsGateway() {
+        return this._namespace.analyticsGateway;
+    }
+    get asset() {
+        return this._namespace.asset;
+    }
+    get audienceMembership() {
+        return this._namespace.audienceMembership;
+    }
+    get audienceSegment() {
+        return this._namespace.audienceSegment;
+    }
+    get auth() {
+        return this._namespace.auth;
+    }
+    get automation() {
+        return this._namespace.automation;
+    }
+    get channel() {
+        return this._namespace.channel;
+    }
+    get chat() {
+        return this._namespace.chat;
+    }
+    get collection() {
+        return this._namespace.collection;
+    }
+    get country() {
+        return this._namespace.country;
+    }
+    get customer() {
+        return this._namespace.customer;
+    }
+    get customerAnalytics() {
+        return this._namespace.customerAnalytics;
+    }
+    get deployment() {
+        return this._namespace.deployment;
+    }
+    get designerTask() {
+        return this._namespace.designerTask;
+    }
+    get experiment() {
+        return this._namespace.experiment;
+    }
+    get facet() {
+        return this._namespace.facet;
+    }
+    get fulfillment() {
+        return this._namespace.fulfillment;
+    }
+    get fulfillmentRequest() {
+        return this._namespace.fulfillmentRequest;
+    }
+    get hook() {
+        return this._namespace.hook;
+    }
+    get hookDispatch() {
+        return this._namespace.hookDispatch;
+    }
+    get market() {
+        return this._namespace.market;
+    }
+    get marketingAttribution() {
+        return this._namespace.marketingAttribution;
+    }
+    get marketingEvent() {
+        return this._namespace.marketingEvent;
+    }
+    get marketingIdentity() {
+        return this._namespace.marketingIdentity;
+    }
+    get mission() {
+        return this._namespace.mission;
+    }
+    get onboarding() {
+        return this._namespace.onboarding;
+    }
+    get order() {
+        return this._namespace.order;
+    }
+    get orderAnalytics() {
+        return this._namespace.orderAnalytics;
+    }
+    get payment() {
+        return this._namespace.payment;
+    }
+    get plugin() {
+        return this._namespace.plugin;
+    }
+    get product() {
+        return this._namespace.product;
+    }
+    get productVariant() {
+        return this._namespace.productVariant;
+    }
+    get promotion() {
+        return this._namespace.promotion;
+    }
+    get role() {
+        return this._namespace.role;
+    }
+    get scheduledJob() {
+        return this._namespace.scheduledJob;
+    }
+    get search() {
+        return this._namespace.search;
+    }
+    get seller() {
+        return this._namespace.seller;
+    }
+    get sellingPlan() {
+        return this._namespace.sellingPlan;
+    }
+    get shipping() {
+        return this._namespace.shipping;
+    }
+    get stock() {
+        return this._namespace.stock;
+    }
+    get stockAnalytics() {
+        return this._namespace.stockAnalytics;
+    }
+    get storefrontRouteTree() {
+        return this._namespace.storefrontRouteTree;
+    }
+    get subscription() {
+        return this._namespace.subscription;
+    }
+    get subscriptionAnalytics() {
+        return this._namespace.subscriptionAnalytics;
+    }
+    get tax() {
+        return this._namespace.tax;
+    }
+    get transaction() {
+        return this._namespace.transaction;
+    }
+    get zone() {
+        return this._namespace.zone;
+    }
+}
+exports.ForgeCartAdminClient = ForgeCartAdminClient;