@01.software/sdk 0.31.0 → 0.33.0

package/dist/server.d.cts

@@ -1,10 +1,10 @@
-import { S as ServerCollectionClient } from './collection-client-DFXXz0vk.cjs';
-export { C as CollectionClient } from './collection-client-DFXXz0vk.cjs';
-import { B as BaseApi, aN as ServerApiOptions, aQ as StockCheckParams, aR as StockCheckResponse, Y as ListingGroupsParams, ap as ProductListingGroupsResponse, ab as ProductDetailParams, a2 as ProductDetail, bh as ProductDetailPreviewParams, bi as ProductDetailPreviewOptions, bj as ProductUpsertParams, bk as ProductUpsertResponse, k as AddItemParams, aU as UpdateItemParams, aI as RemoveItemParams, l as ApplyDiscountParams, aH as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, G as CreateOrderParams, aV as UpdateOrderParams, aY as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, aT as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, H as CreateReturnParams, aX as UpdateReturnParams, aM as ReturnWithRefundParams, aZ as ValidateDiscountParams, a_ as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bl as ClientServerConfig } from './types-DChFjQGz.cjs';
-import { i as Cart, j as CartItem, O as Order, n as Transaction, o as Fulfillment, p as Return } from './payload-types-Wa4-eC6x.cjs';
+import { S as ServerCollectionClient } from './collection-client-De6eKW1J.cjs';
+export { C as CollectionClient } from './collection-client-De6eKW1J.cjs';
+import { B as BaseApi, aU as ServerApiOptions, aX as StockCheckParams, aY as StockCheckResponse, _ as ListingGroupsParams, av as ProductListingGroupsResponse, ad as ProductDetailParams, ae as ProductDetailResult, bo as ProductDetailPreviewParams, bp as ProductDetailPreviewOptions, a4 as ProductDetail, bq as ProductUpsertParams, br as ProductUpsertResponse, k as AddItemParams, a$ as UpdateItemParams, aO as RemoveItemParams, l as ApplyDiscountParams, aN as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, b0 as UpdateOrderParams, b3 as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, a_ as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, b2 as UpdateReturnParams, aT as ReturnWithRefundParams, b4 as ValidateDiscountParams, b5 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bs as ClientServerConfig } from './types-BZKxss8Y.cjs';
+import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-dkeQyrDC.cjs';
 import './metadata.cjs';
-import './const-AytzliEu.cjs';
-import './types-CmLG-7RL.cjs';
+import './const-sPR2IkCe.cjs';
+import './types-B3YT092I.cjs';
 
 type ModerationApiOptions = ServerApiOptions;
 interface CommunityBan {
@@ -44,7 +44,7 @@ declare class ServerCommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
         previewDetail: (params: ProductDetailPreviewParams, options: ProductDetailPreviewOptions) => Promise<ProductDetail | null>;
         upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
     };
@@ -86,6 +86,97 @@ declare class ServerCommerceClient {
     constructor(options: ServerCommerceClientOptions);
 }
 
+type TenantIntrospectionApiOptions = ServerApiOptions;
+type TenantFeatureProgressFeature = 'ecommerce';
+interface TenantFeatureProgressInput {
+    feature: TenantFeatureProgressFeature;
+    includeEvidence?: boolean;
+}
+type TenantFeatureProgressStatus = 'ready' | 'attention' | 'blocked';
+type TenantFeatureProgressItemState = 'complete' | 'incomplete' | 'blocked' | 'attention' | 'optional' | 'unknown' | 'manual' | 'not-applicable';
+type TenantFeatureProgressSeverity = 'required' | 'recommended' | 'optional';
+type TenantFeatureProgressEvidenceValue = string | number | boolean | null;
+interface TenantFeatureProgressItem {
+    id: string;
+    title: string;
+    state: TenantFeatureProgressItemState;
+    severity: TenantFeatureProgressSeverity;
+    summary: string;
+    evidence?: Record<string, TenantFeatureProgressEvidenceValue>;
+}
+interface TenantFeatureProgressGroup {
+    id: string;
+    title: string;
+    summary?: string;
+    items: TenantFeatureProgressItem[];
+}
+interface TenantFeatureProgressResponse {
+    schemaVersion: 1;
+    feature: TenantFeatureProgressFeature;
+    status: TenantFeatureProgressStatus;
+    generatedAt: string;
+    tenant: {
+        id: string;
+        name: string;
+        plan: string;
+    };
+    capability: {
+        effectiveFeatures: string[];
+        planBlocked: string[];
+        closureAdded: string[];
+    };
+    summary: {
+        complete: number;
+        total: number;
+        blocking: number;
+        manual: number;
+        unknown: number;
+    };
+    groups: TenantFeatureProgressGroup[];
+}
+interface CollectionFieldSchema {
+    name: string;
+    path: string;
+    type: string;
+    required?: true;
+    unique?: true;
+    hasMany?: true;
+    relationTo?: string | string[];
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    hidden?: true;
+    systemManaged?: true;
+    writable?: boolean;
+    fields?: CollectionFieldSchema[];
+}
+interface CollectionSchemaResponse {
+    contractVersion: 1;
+    mode: 'effective';
+    collection: {
+        slug: string;
+        timestamps: boolean;
+        alwaysActive: boolean;
+        feature: string | null;
+        systemFields: string[];
+        visibility: {
+            collectionHidden: boolean;
+            hiddenFields: string[];
+        };
+        fields: CollectionFieldSchema[];
+    };
+}
+interface TenantIntrospectionClient {
+    collectionSchema: (collection: string) => Promise<CollectionSchemaResponse>;
+    featureProgress: (params: TenantFeatureProgressInput) => Promise<TenantFeatureProgressResponse>;
+}
+declare class TenantIntrospectionApi extends BaseApi implements TenantIntrospectionClient {
+    constructor(options: TenantIntrospectionApiOptions);
+    collectionSchema(collection: string): Promise<CollectionSchemaResponse>;
+    featureProgress(params: TenantFeatureProgressInput): Promise<TenantFeatureProgressResponse>;
+}
+
 type PreviewDetailParams = {
     collection: string;
     id: string;
@@ -109,6 +200,7 @@ declare class ServerPreviewClient extends BaseApi {
 
 declare class ServerClient {
     commerce: ServerCommerceClient;
+    tenant: TenantIntrospectionClient;
     community: CommunityClient & {
         moderation: {
             banCustomer: (p: BanCustomerParams) => Promise<CommunityBan>;
@@ -134,4 +226,4 @@ declare class ServerClient {
  */
 declare function createServerClient(options: ClientServerConfig): ServerClient;
 
-export { ClientServerConfig, CommunityClient, ModerationApi, type PreviewDetailOptions, type PreviewDetailParams, ServerClient, ServerCollectionClient, ServerCommerceClient, ServerPreviewClient, createServerClient };
+export { ClientServerConfig, type CollectionFieldSchema, type CollectionSchemaResponse, CommunityClient, ModerationApi, type PreviewDetailOptions, type PreviewDetailParams, ServerClient, ServerCollectionClient, ServerCommerceClient, ServerPreviewClient, type TenantFeatureProgressEvidenceValue, type TenantFeatureProgressFeature, type TenantFeatureProgressGroup, type TenantFeatureProgressInput, type TenantFeatureProgressItem, type TenantFeatureProgressItemState, type TenantFeatureProgressResponse, type TenantFeatureProgressSeverity, type TenantFeatureProgressStatus, TenantIntrospectionApi, type TenantIntrospectionApiOptions, type TenantIntrospectionClient, createServerClient };

package/dist/server.d.ts

@@ -1,10 +1,10 @@
-import { S as ServerCollectionClient } from './collection-client-ByzY3hWK.js';
-export { C as CollectionClient } from './collection-client-ByzY3hWK.js';
-import { B as BaseApi, aN as ServerApiOptions, aQ as StockCheckParams, aR as StockCheckResponse, Y as ListingGroupsParams, ap as ProductListingGroupsResponse, ab as ProductDetailParams, a2 as ProductDetail, bh as ProductDetailPreviewParams, bi as ProductDetailPreviewOptions, bj as ProductUpsertParams, bk as ProductUpsertResponse, k as AddItemParams, aU as UpdateItemParams, aI as RemoveItemParams, l as ApplyDiscountParams, aH as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, G as CreateOrderParams, aV as UpdateOrderParams, aY as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, aT as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, H as CreateReturnParams, aX as UpdateReturnParams, aM as ReturnWithRefundParams, aZ as ValidateDiscountParams, a_ as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bl as ClientServerConfig } from './types-BX2mqDf6.js';
-import { i as Cart, j as CartItem, O as Order, n as Transaction, o as Fulfillment, p as Return } from './payload-types-Wa4-eC6x.js';
+import { S as ServerCollectionClient } from './collection-client-B6SlhzIP.js';
+export { C as CollectionClient } from './collection-client-B6SlhzIP.js';
+import { B as BaseApi, aU as ServerApiOptions, aX as StockCheckParams, aY as StockCheckResponse, _ as ListingGroupsParams, av as ProductListingGroupsResponse, ad as ProductDetailParams, ae as ProductDetailResult, bo as ProductDetailPreviewParams, bp as ProductDetailPreviewOptions, a4 as ProductDetail, bq as ProductUpsertParams, br as ProductUpsertResponse, k as AddItemParams, a$ as UpdateItemParams, aO as RemoveItemParams, l as ApplyDiscountParams, aN as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, b0 as UpdateOrderParams, b3 as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, a_ as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, b2 as UpdateReturnParams, aT as ReturnWithRefundParams, b4 as ValidateDiscountParams, b5 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bs as ClientServerConfig } from './types-BHh0YLmq.js';
+import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-dkeQyrDC.js';
 import './metadata.js';
-import './const-BGCP-OJL.js';
-import './types-CVA10VC-.js';
+import './const-DwmSDeWq.js';
+import './types-Cel_4L9t.js';
 
 type ModerationApiOptions = ServerApiOptions;
 interface CommunityBan {
@@ -44,7 +44,7 @@ declare class ServerCommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
         previewDetail: (params: ProductDetailPreviewParams, options: ProductDetailPreviewOptions) => Promise<ProductDetail | null>;
         upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
     };
@@ -86,6 +86,97 @@ declare class ServerCommerceClient {
     constructor(options: ServerCommerceClientOptions);
 }
 
+type TenantIntrospectionApiOptions = ServerApiOptions;
+type TenantFeatureProgressFeature = 'ecommerce';
+interface TenantFeatureProgressInput {
+    feature: TenantFeatureProgressFeature;
+    includeEvidence?: boolean;
+}
+type TenantFeatureProgressStatus = 'ready' | 'attention' | 'blocked';
+type TenantFeatureProgressItemState = 'complete' | 'incomplete' | 'blocked' | 'attention' | 'optional' | 'unknown' | 'manual' | 'not-applicable';
+type TenantFeatureProgressSeverity = 'required' | 'recommended' | 'optional';
+type TenantFeatureProgressEvidenceValue = string | number | boolean | null;
+interface TenantFeatureProgressItem {
+    id: string;
+    title: string;
+    state: TenantFeatureProgressItemState;
+    severity: TenantFeatureProgressSeverity;
+    summary: string;
+    evidence?: Record<string, TenantFeatureProgressEvidenceValue>;
+}
+interface TenantFeatureProgressGroup {
+    id: string;
+    title: string;
+    summary?: string;
+    items: TenantFeatureProgressItem[];
+}
+interface TenantFeatureProgressResponse {
+    schemaVersion: 1;
+    feature: TenantFeatureProgressFeature;
+    status: TenantFeatureProgressStatus;
+    generatedAt: string;
+    tenant: {
+        id: string;
+        name: string;
+        plan: string;
+    };
+    capability: {
+        effectiveFeatures: string[];
+        planBlocked: string[];
+        closureAdded: string[];
+    };
+    summary: {
+        complete: number;
+        total: number;
+        blocking: number;
+        manual: number;
+        unknown: number;
+    };
+    groups: TenantFeatureProgressGroup[];
+}
+interface CollectionFieldSchema {
+    name: string;
+    path: string;
+    type: string;
+    required?: true;
+    unique?: true;
+    hasMany?: true;
+    relationTo?: string | string[];
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    hidden?: true;
+    systemManaged?: true;
+    writable?: boolean;
+    fields?: CollectionFieldSchema[];
+}
+interface CollectionSchemaResponse {
+    contractVersion: 1;
+    mode: 'effective';
+    collection: {
+        slug: string;
+        timestamps: boolean;
+        alwaysActive: boolean;
+        feature: string | null;
+        systemFields: string[];
+        visibility: {
+            collectionHidden: boolean;
+            hiddenFields: string[];
+        };
+        fields: CollectionFieldSchema[];
+    };
+}
+interface TenantIntrospectionClient {
+    collectionSchema: (collection: string) => Promise<CollectionSchemaResponse>;
+    featureProgress: (params: TenantFeatureProgressInput) => Promise<TenantFeatureProgressResponse>;
+}
+declare class TenantIntrospectionApi extends BaseApi implements TenantIntrospectionClient {
+    constructor(options: TenantIntrospectionApiOptions);
+    collectionSchema(collection: string): Promise<CollectionSchemaResponse>;
+    featureProgress(params: TenantFeatureProgressInput): Promise<TenantFeatureProgressResponse>;
+}
+
 type PreviewDetailParams = {
     collection: string;
     id: string;
@@ -109,6 +200,7 @@ declare class ServerPreviewClient extends BaseApi {
 
 declare class ServerClient {
     commerce: ServerCommerceClient;
+    tenant: TenantIntrospectionClient;
     community: CommunityClient & {
         moderation: {
             banCustomer: (p: BanCustomerParams) => Promise<CommunityBan>;
@@ -134,4 +226,4 @@ declare class ServerClient {
  */
 declare function createServerClient(options: ClientServerConfig): ServerClient;
 
-export { ClientServerConfig, CommunityClient, ModerationApi, type PreviewDetailOptions, type PreviewDetailParams, ServerClient, ServerCollectionClient, ServerCommerceClient, ServerPreviewClient, createServerClient };
+export { ClientServerConfig, type CollectionFieldSchema, type CollectionSchemaResponse, CommunityClient, ModerationApi, type PreviewDetailOptions, type PreviewDetailParams, ServerClient, ServerCollectionClient, ServerCommerceClient, ServerPreviewClient, type TenantFeatureProgressEvidenceValue, type TenantFeatureProgressFeature, type TenantFeatureProgressGroup, type TenantFeatureProgressInput, type TenantFeatureProgressItem, type TenantFeatureProgressItemState, type TenantFeatureProgressResponse, type TenantFeatureProgressSeverity, type TenantFeatureProgressStatus, TenantIntrospectionApi, type TenantIntrospectionApiOptions, type TenantIntrospectionClient, createServerClient };

package/dist/server.js

@@ -1401,6 +1401,28 @@ var CartApi = class {
 };
 
 // src/core/api/product-api.ts
+var PRODUCT_DETAIL_UNAVAILABLE_REASONS = /* @__PURE__ */ new Set([
+  "not_found",
+  "not_published",
+  "feature_disabled"
+]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function readProductDetailUnavailableReason(value) {
+  if (!isRecord(value)) return void 0;
+  const directReason = value.reason ?? value.code;
+  if (typeof directReason === "string" && PRODUCT_DETAIL_UNAVAILABLE_REASONS.has(directReason)) {
+    return directReason;
+  }
+  return readProductDetailUnavailableReason(value.body);
+}
+function productDetailResultFromError(error) {
+  if (!(error instanceof SDKError) || error.status !== 404) return void 0;
+  const reason = readProductDetailUnavailableReason(error.details);
+  if (!reason) return void 0;
+  return { found: false, reason };
+}
 var ProductApi = class extends BaseApi {
   constructor(options) {
     super("ProductApi", options);
@@ -1421,15 +1443,24 @@ var ProductApi = class extends BaseApi {
   }
   /**
    * Fetch full product detail by slug or id.
-   * Returns `null` on 404 regardless of reason (`not_found` / `not_published` /
-   * `tenant_mismatch` / `feature_disabled`). For the reason behind a null,
-   * inspect `client.lastRequestId` against backend logs.
+   * Returns a discriminated result so storefronts can distinguish missing,
+   * unpublished, and feature-disabled products.
+   *
+   * Only product-detail 404 responses carrying one of those allowlisted reasons
+   * are mapped to `{ found: false, reason }`. Unknown or uncoded 404s, plus
+   * permission/auth errors such as tenant mismatch, continue to throw typed SDK
+   * errors instead of being collapsed into a storefront absence result.
    */
   async detail(params) {
     try {
-      return await this.request("/api/products/detail", params);
+      const product = await this.request(
+        "/api/products/detail",
+        params
+      );
+      return { found: true, product };
     } catch (err) {
-      if (err instanceof NotFoundError) return null;
+      const notFoundResult = productDetailResultFromError(err);
+      if (notFoundResult) return notFoundResult;
       throw err;
     }
   }
@@ -1496,7 +1527,7 @@ var OrderApi = class extends BaseApi {
   }
   bulkImportFulfillments(params) {
     return this.request(
-      "/api/orders/bulk-import-fulfillments",
+      "/api/fulfillments/bulk-import",
       params
     );
   }
@@ -1625,6 +1656,29 @@ var ServerCommerceClient = class {
   }
 };
 
+// src/core/api/tenant-introspection-api.ts
+var TenantIntrospectionApi = class extends BaseApi {
+  constructor(options) {
+    super("TenantIntrospectionApi", options);
+  }
+  collectionSchema(collection) {
+    return this.request(
+      `/api/tenants/schema/${encodeURIComponent(collection)}`,
+      void 0,
+      { method: "GET" }
+    );
+  }
+  featureProgress(params) {
+    const search = new URLSearchParams({ feature: params.feature });
+    if (params.includeEvidence) search.set("includeEvidence", "true");
+    return this.request(
+      `/api/tenants/feature-progress?${search.toString()}`,
+      void 0,
+      { method: "GET" }
+    );
+  }
+};
+
 // src/core/client/client.server.ts
 var ServerClient = class {
   constructor(options) {
@@ -1658,6 +1712,15 @@ var ServerClient = class {
       onRequestId
     };
     this.commerce = new ServerCommerceClient(serverOptions);
+    const tenantIntrospectionApi = new TenantIntrospectionApi(serverOptions);
+    this.tenant = {
+      collectionSchema: tenantIntrospectionApi.collectionSchema.bind(
+        tenantIntrospectionApi
+      ),
+      featureProgress: tenantIntrospectionApi.featureProgress.bind(
+        tenantIntrospectionApi
+      )
+    };
     const previewApi = new ServerPreviewClient(serverOptions);
     this.preview = {
       detail: previewApi.detail.bind(previewApi)
@@ -1698,6 +1761,7 @@ export {
   ServerCollectionClient,
   ServerCommerceClient,
   ServerPreviewClient,
+  TenantIntrospectionApi,
   createServerClient
 };
 //# sourceMappingURL=server.js.map