@01.software/sdk 0.31.0 → 0.32.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-CORhppPb.cjs';
+export { C as CollectionClient } from './collection-client-CORhppPb.cjs';
+import { B as BaseApi, aQ as ServerApiOptions, aT as StockCheckParams, aU as StockCheckResponse, _ as ListingGroupsParams, as as ProductListingGroupsResponse, ad as ProductDetailParams, a4 as ProductDetail, bk as ProductDetailPreviewParams, bl as ProductDetailPreviewOptions, bm as ProductUpsertParams, bn as ProductUpsertResponse, k as AddItemParams, aX as UpdateItemParams, aL as RemoveItemParams, l as ApplyDiscountParams, aK as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, aY as UpdateOrderParams, a$ as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, aW as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, a_ as UpdateReturnParams, aP as ReturnWithRefundParams, b0 as ValidateDiscountParams, b1 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bo as ClientServerConfig } from './types-CAkWqIr6.cjs';
+import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-DVK1QCeU.cjs';
 import './metadata.cjs';
-import './const-AytzliEu.cjs';
-import './types-CmLG-7RL.cjs';
+import './const-Brk2Ff0q.cjs';
+import './types-ByMrR_Z_.cjs';
 
 type ModerationApiOptions = ServerApiOptions;
 interface CommunityBan {
@@ -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-DPGXnhoF.js';
+export { C as CollectionClient } from './collection-client-DPGXnhoF.js';
+import { B as BaseApi, aQ as ServerApiOptions, aT as StockCheckParams, aU as StockCheckResponse, _ as ListingGroupsParams, as as ProductListingGroupsResponse, ad as ProductDetailParams, a4 as ProductDetail, bk as ProductDetailPreviewParams, bl as ProductDetailPreviewOptions, bm as ProductUpsertParams, bn as ProductUpsertResponse, k as AddItemParams, aX as UpdateItemParams, aL as RemoveItemParams, l as ApplyDiscountParams, aK as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, aY as UpdateOrderParams, a$ as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, aW as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, a_ as UpdateReturnParams, aP as ReturnWithRefundParams, b0 as ValidateDiscountParams, b1 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bo as ClientServerConfig } from './types-CYMSBkJC.js';
+import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-DVK1QCeU.js';
 import './metadata.js';
-import './const-BGCP-OJL.js';
-import './types-CVA10VC-.js';
+import './const-DcY2_z9O.js';
+import './types-DUPC7Xn6.js';
 
 type ModerationApiOptions = ServerApiOptions;
 interface CommunityBan {
@@ -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

@@ -1422,7 +1422,7 @@ 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,
+   * `feature_disabled`). For the reason behind a null,
    * inspect `client.lastRequestId` against backend logs.
    */
   async detail(params) {
@@ -1625,6 +1625,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 +1681,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 +1730,7 @@ export {
   ServerCollectionClient,
   ServerCommerceClient,
   ServerPreviewClient,
+  TenantIntrospectionApi,
   createServerClient
 };
 //# sourceMappingURL=server.js.map