@simpleapps-com/augur-api 0.3.3 → 0.4.0

package/dist/cjs/services/p21-pim/client.d.ts

@@ -7,31 +7,94 @@ import { type AISuggestionParams, type SuggestDisplayDescResponse, type SuggestW
  * Provides access to extended inventory data, AI-powered content generation,
  * and podcast management capabilities.
  *
+ * @fullPath api.p21Pim
+ * @service p21-pim
+ * @domain product-information-management
+ * @discoverable true
+ * @searchTerms ['pim', 'product information', 'inventory extensions', 'ai suggestions', 'podcasts']
+ * @relatedEndpoints ['items', 'nexus', 'orders']
+ * @commonPatterns ['Manage inventory extensions', 'Generate AI descriptions', 'Handle podcast content']
+ *
  * @example
  * ```typescript
  * const api = new AugurAPI({ bearerToken: 'your-jwt', siteId: 'your-site' });
  *
+ * // Health check
+ * const health = await api.p21Pim.healthCheck.get();
+ *
  * // List inventory extensions
  * const extensions = await api.p21Pim.invMastExt.list({ limit: 20 });
  *
- * // Generate AI descriptions
- * const suggestions = await api.p21Pim.items.suggestDisplayDescription(12345);
+ * // Get specific extension
+ * const extension = await api.p21Pim.invMastExt.get(12345);
+ *
+ * // Generate AI suggestions
+ * const displaySuggestions = await api.p21Pim.items.suggestDisplayDesc.get(12345);
+ * const webSuggestions = await api.p21Pim.items.suggestWebDesc.get(12345);
  *
  * // Manage podcasts
  * const podcasts = await api.p21Pim.podcasts.list();
+ * const podcast = await api.p21Pim.podcasts.get(789);
  * ```
  */
 export declare class P21PimClient extends BaseServiceClient {
     constructor(http: HTTPClient, baseUrl?: string);
+    /**
+     * Health Check endpoint
+     *
+     * @fullPath api.p21Pim.healthCheck.get
+     * @service p21-pim
+     * @domain monitoring
+     * @discoverable true
+     * @searchTerms ['health', 'status', 'monitoring', 'availability']
+     * @relatedEndpoints ['core.healthCheck', 'nexus.healthCheck']
+     * @commonPatterns ['Monitor service health', 'Check service availability']
+     *
+     * Monitor service health and availability.
+     * Note: Only requires x-site-id header, no Bearer token needed.
+     */
+    healthCheck: {
+        /**
+         * Get service health status
+         *
+         * @fullPath api.p21Pim.healthCheck.get
+         * @returns Service health status and availability information
+         */
+        get: () => Promise<{
+            params: Record<string, unknown> | unknown[];
+            data: {
+                siteHash: string;
+                siteId: string;
+            };
+            options: Record<string, unknown> | unknown[];
+            status: number;
+            message: string;
+            count: number;
+            total: number;
+            totalResults: number;
+        }>;
+    };
     /**
      * Inventory Master Extensions operations
      *
+     * @fullPath api.p21Pim.invMastExt
+     * @service p21-pim
+     * @domain inventory-management
+     * @discoverable true
+     * @searchTerms ['inventory', 'extensions', 'master data', 'upc', 'ean', 'brand']
+     * @relatedEndpoints ['items.invMast', 'nexus.invMast']
+     * @commonPatterns ['Manage inventory extensions', 'Handle product metadata']
+     *
      * Manage extended inventory master data including UPC/EAN codes,
      * brand information, and SEO metadata.
      */
     invMastExt: {
         /**
          * List inventory master extensions with filtering and pagination
+         *
+         * @fullPath api.p21Pim.invMastExt.list
+         * @param params Query parameters for filtering and pagination
+         * @returns Paginated list of inventory master extensions
          */
         list: (params?: {
             edgeCache?: 3 | 2 | 4 | 1 | "1" | 5 | 8 | "2" | "3" | "4" | "5" | "8" | undefined;
@@ -51,10 +114,10 @@ export declare class P21PimClient extends BaseServiceClient {
                 upcOrEanId?: string | null | undefined;
                 brandName?: string | null | undefined;
                 attributeGroupUid?: number | null | undefined;
+                partNumber?: string | null | undefined;
                 upcOrEanPrefix?: string | null | undefined;
                 upcOrEanItem?: string | null | undefined;
                 manufacturerName?: string | null | undefined;
-                partNumber?: string | null | undefined;
                 metaTitle?: string | null | undefined;
                 metaDescription?: string | null | undefined;
                 metaKeywords?: string | null | undefined;
@@ -68,6 +131,10 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Get a specific inventory master extension by UID
+         *
+         * @fullPath api.p21Pim.invMastExt.get
+         * @param invMastExtUid Inventory master extension UID (must match OpenAPI parameter name)
+         * @returns Single inventory master extension record
          */
         get: (id: string | number, params?: import("../../core/base-client").CacheParams | undefined) => Promise<{
             params: Record<string, unknown> | unknown[];
@@ -83,10 +150,10 @@ export declare class P21PimClient extends BaseServiceClient {
                 upcOrEanId?: string | null | undefined;
                 brandName?: string | null | undefined;
                 attributeGroupUid?: number | null | undefined;
+                partNumber?: string | null | undefined;
                 upcOrEanPrefix?: string | null | undefined;
                 upcOrEanItem?: string | null | undefined;
                 manufacturerName?: string | null | undefined;
-                partNumber?: string | null | undefined;
                 metaTitle?: string | null | undefined;
                 metaDescription?: string | null | undefined;
                 metaKeywords?: string | null | undefined;
@@ -100,6 +167,10 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Create a new inventory master extension record
+         *
+         * @fullPath api.p21Pim.invMastExt.create
+         * @param data Extension data for creation
+         * @returns Created inventory master extension
          */
         create: (data: {
             invMastUid: number;
@@ -117,10 +188,10 @@ export declare class P21PimClient extends BaseServiceClient {
                 upcOrEanId?: string | null | undefined;
                 brandName?: string | null | undefined;
                 attributeGroupUid?: number | null | undefined;
+                partNumber?: string | null | undefined;
                 upcOrEanPrefix?: string | null | undefined;
                 upcOrEanItem?: string | null | undefined;
                 manufacturerName?: string | null | undefined;
-                partNumber?: string | null | undefined;
                 metaTitle?: string | null | undefined;
                 metaDescription?: string | null | undefined;
                 metaKeywords?: string | null | undefined;
@@ -134,6 +205,11 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Update an existing inventory master extension
+         *
+         * @fullPath api.p21Pim.invMastExt.update
+         * @param invMastExtUid Inventory master extension UID (must match OpenAPI parameter name)
+         * @param data Extension data for update
+         * @returns Updated inventory master extension
          */
         update: (id: string | number, data: {
             statusCd?: number | undefined;
@@ -141,10 +217,10 @@ export declare class P21PimClient extends BaseServiceClient {
             upcOrEanId?: string | null | undefined;
             brandName?: string | null | undefined;
             attributeGroupUid?: number | null | undefined;
+            partNumber?: string | null | undefined;
             upcOrEanPrefix?: string | null | undefined;
             upcOrEanItem?: string | null | undefined;
             manufacturerName?: string | null | undefined;
-            partNumber?: string | null | undefined;
             metaTitle?: string | null | undefined;
             metaDescription?: string | null | undefined;
             metaKeywords?: string | null | undefined;
@@ -162,10 +238,10 @@ export declare class P21PimClient extends BaseServiceClient {
                 upcOrEanId?: string | null | undefined;
                 brandName?: string | null | undefined;
                 attributeGroupUid?: number | null | undefined;
+                partNumber?: string | null | undefined;
                 upcOrEanPrefix?: string | null | undefined;
                 upcOrEanItem?: string | null | undefined;
                 manufacturerName?: string | null | undefined;
-                partNumber?: string | null | undefined;
                 metaTitle?: string | null | undefined;
                 metaDescription?: string | null | undefined;
                 metaKeywords?: string | null | undefined;
@@ -179,6 +255,10 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Soft delete an inventory master extension (sets status_cd to 700)
+         *
+         * @fullPath api.p21Pim.invMastExt.delete
+         * @param invMastExtUid Inventory master extension UID (must match OpenAPI parameter name)
+         * @returns Deleted inventory master extension confirmation
          */
         delete: (id: string | number) => Promise<{
             params: Record<string, unknown> | unknown[];
@@ -194,10 +274,10 @@ export declare class P21PimClient extends BaseServiceClient {
                 upcOrEanId?: string | null | undefined;
                 brandName?: string | null | undefined;
                 attributeGroupUid?: number | null | undefined;
+                partNumber?: string | null | undefined;
                 upcOrEanPrefix?: string | null | undefined;
                 upcOrEanItem?: string | null | undefined;
                 manufacturerName?: string | null | undefined;
-                partNumber?: string | null | undefined;
                 metaTitle?: string | null | undefined;
                 metaDescription?: string | null | undefined;
                 metaKeywords?: string | null | undefined;
@@ -213,34 +293,82 @@ export declare class P21PimClient extends BaseServiceClient {
     /**
      * AI-Powered Item Services
      *
+     * @fullPath api.p21Pim.items
+     * @service p21-pim
+     * @domain ai-content-generation
+     * @discoverable true
+     * @searchTerms ['ai', 'suggestions', 'descriptions', 'content generation', 'llm']
+     * @relatedEndpoints ['items.invMast', 'gregorovich.chatGpt']
+     * @commonPatterns ['Generate product descriptions', 'AI content creation']
+     *
      * Generate AI-powered product descriptions using advanced language models.
      */
     items: {
         /**
-         * Generate marketing-focused display descriptions (255 character limit)
+         * Suggest Display Description operations
          *
-         * @param invMastUid - Inventory master UID
-         * @param params - Optional parameters including limit and model selection
-         * @returns Array of suggestions or false if no suggestions available
+         * @fullPath api.p21Pim.items.suggestDisplayDesc
          */
-        suggestDisplayDescription: (invMastUid: number, params?: AISuggestionParams) => Promise<SuggestDisplayDescResponse>;
+        suggestDisplayDesc: {
+            /**
+             * Generate marketing-focused display descriptions (255 character limit)
+             *
+             * @fullPath api.p21Pim.items.suggestDisplayDesc.get
+             * @service p21-pim
+             * @domain ai-content-generation
+             * @discoverable true
+             * @searchTerms ['ai', 'display', 'descriptions', 'marketing', 'suggestions']
+             * @relatedEndpoints ['items.suggestWebDesc']
+             * @commonPatterns ['Generate marketing descriptions', 'AI display content']
+             * @param invMastUid Inventory master UID (must match OpenAPI parameter name)
+             * @param params Optional parameters including limit and model selection
+             * @returns Array of display description suggestions
+             */
+            get: (invMastUid: number, params?: AISuggestionParams) => Promise<SuggestDisplayDescResponse>;
+        };
         /**
-         * Generate detailed web descriptions (4000 character limit)
+         * Suggest Web Description operations
          *
-         * @param invMastUid - Inventory master UID
-         * @param params - Optional parameters including limit and model selection
-         * @returns Array of web description suggestions
+         * @fullPath api.p21Pim.items.suggestWebDesc
          */
-        suggestWebDescription: (invMastUid: number, params?: AISuggestionParams) => Promise<SuggestWebDescResponse>;
+        suggestWebDesc: {
+            /**
+             * Generate detailed web descriptions (4000 character limit)
+             *
+             * @fullPath api.p21Pim.items.suggestWebDesc.get
+             * @service p21-pim
+             * @domain ai-content-generation
+             * @discoverable true
+             * @searchTerms ['ai', 'web', 'descriptions', 'detailed', 'suggestions']
+             * @relatedEndpoints ['items.suggestDisplayDesc']
+             * @commonPatterns ['Generate web descriptions', 'AI detailed content']
+             * @param invMastUid Inventory master UID (must match OpenAPI parameter name)
+             * @param params Optional parameters including limit and model selection
+             * @returns Array of web description suggestions
+             */
+            get: (invMastUid: number, params?: AISuggestionParams) => Promise<SuggestWebDescResponse>;
+        };
     };
     /**
      * Podcast Management
      *
+     * @fullPath api.p21Pim.podcasts
+     * @service p21-pim
+     * @domain content-management
+     * @discoverable true
+     * @searchTerms ['podcasts', 'content', 'transcripts', 'media']
+     * @relatedEndpoints ['joomla.content', 'gregorovich.documents']
+     * @commonPatterns ['Manage podcast content', 'Handle media transcripts']
+     *
      * Manage podcast content with full transcript support.
      */
     podcasts: {
         /**
          * List podcasts with filtering and search capabilities
+         *
+         * @fullPath api.p21Pim.podcasts.list
+         * @param params Query parameters for filtering and pagination
+         * @returns Paginated list of podcasts
          */
         list: (params?: {
             edgeCache?: 3 | 2 | 4 | 1 | "1" | 5 | 8 | "2" | "3" | "4" | "5" | "8" | undefined;
@@ -270,6 +398,10 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Get a specific podcast by UID
+         *
+         * @fullPath api.p21Pim.podcasts.get
+         * @param podcastsUid Podcast UID (must match OpenAPI parameter name)
+         * @returns Single podcast record
          */
         get: (id: string | number, params?: import("../../core/base-client").CacheParams | undefined) => Promise<{
             params: Record<string, unknown> | unknown[];
@@ -293,6 +425,10 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Create a new podcast record
+         *
+         * @fullPath api.p21Pim.podcasts.create
+         * @param data Podcast data for creation
+         * @returns Created podcast record
          */
         create: (data: {
             transcript: string;
@@ -320,6 +456,11 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Update an existing podcast record
+         *
+         * @fullPath api.p21Pim.podcasts.update
+         * @param podcastsUid Podcast UID (must match OpenAPI parameter name)
+         * @param data Podcast data for update
+         * @returns Updated podcast record
          */
         update: (id: string | number, data: {
             path?: string | null | undefined;
@@ -348,6 +489,10 @@ export declare class P21PimClient extends BaseServiceClient {
         }>;
         /**
          * Soft delete a podcast record
+         *
+         * @fullPath api.p21Pim.podcasts.delete
+         * @param podcastsUid Podcast UID (must match OpenAPI parameter name)
+         * @returns Deleted podcast confirmation
          */
         delete: (id: string | number) => Promise<{
             params: Record<string, unknown> | unknown[];
@@ -370,24 +515,5 @@ export declare class P21PimClient extends BaseServiceClient {
             totalResults: number;
         }>;
     };
-    /**
-     * Health check endpoint
-     *
-     * Monitor service health and availability.
-     * Note: Only requires x-site-id header, no Bearer token needed.
-     */
-    getHealthCheck: () => Promise<{
-        params: Record<string, unknown> | unknown[];
-        data: {
-            siteHash: string;
-            siteId: string;
-        };
-        options: Record<string, unknown> | unknown[];
-        status: number;
-        message: string;
-        count: number;
-        total: number;
-        totalResults: number;
-    }>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/cjs/services/p21-pim/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/services/p21-pim/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAeL,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC5B,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,SAAQ,iBAAiB;gBACrC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,MAAwC;IAI/E;;;;;OAKG;IACH,UAAU;QACR;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEH;IAEF;;;;OAIG;IACH,KAAK;QACH;;;;;;WAMG;gDAEW,MAAM,WACT,kBAAkB,KAC1B,OAAO,CAAC,0BAA0B,CAAC;QAYtC;;;;;;WAMG;4CAEW,MAAM,WACT,kBAAkB,KAC1B,OAAO,CAAC,sBAAsB,CAAC;MAWlC;IAEF;;;;OAIG;IACH,QAAQ;QACN;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;;;;;;;;MAEH;IAEF;;;;;OAKG;IACH,cAAc;;;;;;;;;;;;OAA2D;CAC1E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/services/p21-pim/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAeL,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC5B,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,YAAa,SAAQ,iBAAiB;gBACrC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,MAAwC;IAI/E;;;;;;;;;;;;;OAaG;IACH,WAAW;QACT;;;;;WAKG;;;;;;;;;;;;;;MAEH;IAEF;;;;;;;;;;;;;OAaG;IACH,UAAU;QACR;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAMH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAKH;IAEF;;;;;;;;;;;;OAYG;IACH,KAAK;QACH;;;;WAIG;;YAED;;;;;;;;;;;;;eAaG;8BAEW,MAAM,WACT,kBAAkB,KAC1B,OAAO,CAAC,0BAA0B,CAAC;;QAaxC;;;;WAIG;;YAED;;;;;;;;;;;;;eAaG;8BAEW,MAAM,WACT,kBAAkB,KAC1B,OAAO,CAAC,sBAAsB,CAAC;;MAYpC;IAEF;;;;;;;;;;;;OAYG;IACH,QAAQ;QACN;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;QAGH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;QAGH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;QAGH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;QAOH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;MAEH;CACH"}

package/dist/cjs/services/p21-pim/client.js

@@ -9,122 +9,248 @@ const schemas_1 = require("./schemas");
  * Provides access to extended inventory data, AI-powered content generation,
  * and podcast management capabilities.
  *
+ * @fullPath api.p21Pim
+ * @service p21-pim
+ * @domain product-information-management
+ * @discoverable true
+ * @searchTerms ['pim', 'product information', 'inventory extensions', 'ai suggestions', 'podcasts']
+ * @relatedEndpoints ['items', 'nexus', 'orders']
+ * @commonPatterns ['Manage inventory extensions', 'Generate AI descriptions', 'Handle podcast content']
+ *
  * @example
  * ```typescript
  * const api = new AugurAPI({ bearerToken: 'your-jwt', siteId: 'your-site' });
  *
+ * // Health check
+ * const health = await api.p21Pim.healthCheck.get();
+ *
  * // List inventory extensions
  * const extensions = await api.p21Pim.invMastExt.list({ limit: 20 });
  *
- * // Generate AI descriptions
- * const suggestions = await api.p21Pim.items.suggestDisplayDescription(12345);
+ * // Get specific extension
+ * const extension = await api.p21Pim.invMastExt.get(12345);
+ *
+ * // Generate AI suggestions
+ * const displaySuggestions = await api.p21Pim.items.suggestDisplayDesc.get(12345);
+ * const webSuggestions = await api.p21Pim.items.suggestWebDesc.get(12345);
  *
  * // Manage podcasts
  * const podcasts = await api.p21Pim.podcasts.list();
+ * const podcast = await api.p21Pim.podcasts.get(789);
  * ```
  */
 class P21PimClient extends base_client_1.BaseServiceClient {
     constructor(http, baseUrl = 'https://p21-pim.augur-api.com') {
         super('p21-pim', http, baseUrl);
+        /**
+         * Health Check endpoint
+         *
+         * @fullPath api.p21Pim.healthCheck.get
+         * @service p21-pim
+         * @domain monitoring
+         * @discoverable true
+         * @searchTerms ['health', 'status', 'monitoring', 'availability']
+         * @relatedEndpoints ['core.healthCheck', 'nexus.healthCheck']
+         * @commonPatterns ['Monitor service health', 'Check service availability']
+         *
+         * Monitor service health and availability.
+         * Note: Only requires x-site-id header, no Bearer token needed.
+         */
+        this.healthCheck = {
+            /**
+             * Get service health status
+             *
+             * @fullPath api.p21Pim.healthCheck.get
+             * @returns Service health status and availability information
+             */
+            get: this.createHealthCheckMethod(schemas_1.HealthCheckResponseSchema),
+        };
         /**
          * Inventory Master Extensions operations
          *
+         * @fullPath api.p21Pim.invMastExt
+         * @service p21-pim
+         * @domain inventory-management
+         * @discoverable true
+         * @searchTerms ['inventory', 'extensions', 'master data', 'upc', 'ean', 'brand']
+         * @relatedEndpoints ['items.invMast', 'nexus.invMast']
+         * @commonPatterns ['Manage inventory extensions', 'Handle product metadata']
+         *
          * Manage extended inventory master data including UPC/EAN codes,
          * brand information, and SEO metadata.
          */
         this.invMastExt = {
             /**
              * List inventory master extensions with filtering and pagination
+             *
+             * @fullPath api.p21Pim.invMastExt.list
+             * @param params Query parameters for filtering and pagination
+             * @returns Paginated list of inventory master extensions
              */
             list: this.createListMethod('/inv-mast-ext', schemas_1.InventoryMasterExtensionListParamsSchema, schemas_1.InventoryMasterExtensionListResponseSchema),
             /**
              * Get a specific inventory master extension by UID
+             *
+             * @fullPath api.p21Pim.invMastExt.get
+             * @param invMastExtUid Inventory master extension UID (must match OpenAPI parameter name)
+             * @returns Single inventory master extension record
              */
-            get: this.createGetMethod('/inv-mast-ext/{id}', schemas_1.InventoryMasterExtensionResponseSchema),
+            get: this.createGetMethod('/inv-mast-ext/{invMastExtUid}', schemas_1.InventoryMasterExtensionResponseSchema),
             /**
              * Create a new inventory master extension record
+             *
+             * @fullPath api.p21Pim.invMastExt.create
+             * @param data Extension data for creation
+             * @returns Created inventory master extension
              */
             create: this.createCreateMethod('/inv-mast-ext', schemas_1.InventoryMasterExtensionCreateParamsSchema, schemas_1.InventoryMasterExtensionResponseSchema),
             /**
              * Update an existing inventory master extension
+             *
+             * @fullPath api.p21Pim.invMastExt.update
+             * @param invMastExtUid Inventory master extension UID (must match OpenAPI parameter name)
+             * @param data Extension data for update
+             * @returns Updated inventory master extension
              */
-            update: this.createUpdateMethod('/inv-mast-ext/{id}', schemas_1.InventoryMasterExtensionUpdateParamsSchema, schemas_1.InventoryMasterExtensionResponseSchema),
+            update: this.createUpdateMethod('/inv-mast-ext/{invMastExtUid}', schemas_1.InventoryMasterExtensionUpdateParamsSchema, schemas_1.InventoryMasterExtensionResponseSchema),
             /**
              * Soft delete an inventory master extension (sets status_cd to 700)
+             *
+             * @fullPath api.p21Pim.invMastExt.delete
+             * @param invMastExtUid Inventory master extension UID (must match OpenAPI parameter name)
+             * @returns Deleted inventory master extension confirmation
              */
-            delete: this.createDeleteMethod('/inv-mast-ext/{id}', schemas_1.InventoryMasterExtensionResponseSchema),
+            delete: this.createDeleteMethod('/inv-mast-ext/{invMastExtUid}', schemas_1.InventoryMasterExtensionResponseSchema),
         };
         /**
          * AI-Powered Item Services
          *
+         * @fullPath api.p21Pim.items
+         * @service p21-pim
+         * @domain ai-content-generation
+         * @discoverable true
+         * @searchTerms ['ai', 'suggestions', 'descriptions', 'content generation', 'llm']
+         * @relatedEndpoints ['items.invMast', 'gregorovich.chatGpt']
+         * @commonPatterns ['Generate product descriptions', 'AI content creation']
+         *
          * Generate AI-powered product descriptions using advanced language models.
          */
         this.items = {
             /**
-             * Generate marketing-focused display descriptions (255 character limit)
+             * Suggest Display Description operations
              *
-             * @param invMastUid - Inventory master UID
-             * @param params - Optional parameters including limit and model selection
-             * @returns Array of suggestions or false if no suggestions available
+             * @fullPath api.p21Pim.items.suggestDisplayDesc
              */
-            suggestDisplayDescription: async (invMastUid, params) => {
-                return this.executeRequest({
-                    method: 'GET',
-                    path: `/items/${invMastUid}/suggest-display-desc`,
-                    paramsSchema: schemas_1.AISuggestionParamsSchema,
-                    responseSchema: schemas_1.SuggestDisplayDescResponseSchema,
-                }, params || {});
+            suggestDisplayDesc: {
+                /**
+                 * Generate marketing-focused display descriptions (255 character limit)
+                 *
+                 * @fullPath api.p21Pim.items.suggestDisplayDesc.get
+                 * @service p21-pim
+                 * @domain ai-content-generation
+                 * @discoverable true
+                 * @searchTerms ['ai', 'display', 'descriptions', 'marketing', 'suggestions']
+                 * @relatedEndpoints ['items.suggestWebDesc']
+                 * @commonPatterns ['Generate marketing descriptions', 'AI display content']
+                 * @param invMastUid Inventory master UID (must match OpenAPI parameter name)
+                 * @param params Optional parameters including limit and model selection
+                 * @returns Array of display description suggestions
+                 */
+                get: async (invMastUid, params) => {
+                    return this.executeRequest({
+                        method: 'GET',
+                        path: `/items/${invMastUid}/suggest-display-desc`,
+                        paramsSchema: schemas_1.AISuggestionParamsSchema,
+                        responseSchema: schemas_1.SuggestDisplayDescResponseSchema,
+                    }, params || {});
+                },
             },
             /**
-             * Generate detailed web descriptions (4000 character limit)
+             * Suggest Web Description operations
              *
-             * @param invMastUid - Inventory master UID
-             * @param params - Optional parameters including limit and model selection
-             * @returns Array of web description suggestions
+             * @fullPath api.p21Pim.items.suggestWebDesc
              */
-            suggestWebDescription: async (invMastUid, params) => {
-                return this.executeRequest({
-                    method: 'GET',
-                    path: `/items/${invMastUid}/suggest-web-desc`,
-                    paramsSchema: schemas_1.AISuggestionParamsSchema,
-                    responseSchema: schemas_1.SuggestWebDescResponseSchema,
-                }, params || {});
+            suggestWebDesc: {
+                /**
+                 * Generate detailed web descriptions (4000 character limit)
+                 *
+                 * @fullPath api.p21Pim.items.suggestWebDesc.get
+                 * @service p21-pim
+                 * @domain ai-content-generation
+                 * @discoverable true
+                 * @searchTerms ['ai', 'web', 'descriptions', 'detailed', 'suggestions']
+                 * @relatedEndpoints ['items.suggestDisplayDesc']
+                 * @commonPatterns ['Generate web descriptions', 'AI detailed content']
+                 * @param invMastUid Inventory master UID (must match OpenAPI parameter name)
+                 * @param params Optional parameters including limit and model selection
+                 * @returns Array of web description suggestions
+                 */
+                get: async (invMastUid, params) => {
+                    return this.executeRequest({
+                        method: 'GET',
+                        path: `/items/${invMastUid}/suggest-web-desc`,
+                        paramsSchema: schemas_1.AISuggestionParamsSchema,
+                        responseSchema: schemas_1.SuggestWebDescResponseSchema,
+                    }, params || {});
+                },
             },
         };
         /**
          * Podcast Management
          *
+         * @fullPath api.p21Pim.podcasts
+         * @service p21-pim
+         * @domain content-management
+         * @discoverable true
+         * @searchTerms ['podcasts', 'content', 'transcripts', 'media']
+         * @relatedEndpoints ['joomla.content', 'gregorovich.documents']
+         * @commonPatterns ['Manage podcast content', 'Handle media transcripts']
+         *
          * Manage podcast content with full transcript support.
          */
         this.podcasts = {
             /**
              * List podcasts with filtering and search capabilities
+             *
+             * @fullPath api.p21Pim.podcasts.list
+             * @param params Query parameters for filtering and pagination
+             * @returns Paginated list of podcasts
              */
             list: this.createListMethod('/podcasts', schemas_1.PodcastListParamsSchema, schemas_1.PodcastListResponseSchema),
             /**
              * Get a specific podcast by UID
+             *
+             * @fullPath api.p21Pim.podcasts.get
+             * @param podcastsUid Podcast UID (must match OpenAPI parameter name)
+             * @returns Single podcast record
              */
-            get: this.createGetMethod('/podcasts/{id}', schemas_1.PodcastResponseSchema),
+            get: this.createGetMethod('/podcasts/{podcastsUid}', schemas_1.PodcastResponseSchema),
             /**
              * Create a new podcast record
+             *
+             * @fullPath api.p21Pim.podcasts.create
+             * @param data Podcast data for creation
+             * @returns Created podcast record
              */
             create: this.createCreateMethod('/podcasts', schemas_1.PodcastCreateParamsSchema, schemas_1.PodcastResponseSchema),
             /**
              * Update an existing podcast record
+             *
+             * @fullPath api.p21Pim.podcasts.update
+             * @param podcastsUid Podcast UID (must match OpenAPI parameter name)
+             * @param data Podcast data for update
+             * @returns Updated podcast record
              */
-            update: this.createUpdateMethod('/podcasts/{id}', schemas_1.PodcastUpdateParamsSchema, schemas_1.PodcastResponseSchema),
+            update: this.createUpdateMethod('/podcasts/{podcastsUid}', schemas_1.PodcastUpdateParamsSchema, schemas_1.PodcastResponseSchema),
             /**
              * Soft delete a podcast record
+             *
+             * @fullPath api.p21Pim.podcasts.delete
+             * @param podcastsUid Podcast UID (must match OpenAPI parameter name)
+             * @returns Deleted podcast confirmation
              */
-            delete: this.createDeleteMethod('/podcasts/{id}', schemas_1.PodcastResponseSchema),
+            delete: this.createDeleteMethod('/podcasts/{podcastsUid}', schemas_1.PodcastResponseSchema),
         };
-        /**
-         * Health check endpoint
-         *
-         * Monitor service health and availability.
-         * Note: Only requires x-site-id header, no Bearer token needed.
-         */
-        this.getHealthCheck = this.createHealthCheckMethod(schemas_1.HealthCheckResponseSchema);
     }
 }
 exports.P21PimClient = P21PimClient;