@chatarmin/os 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -84,6 +84,32 @@ export interface FeatureCheckInput {
     /** Feature code (e.g., "ai_credit", "whatsapp_messages") */
     featureCode: string;
 }
+/**
+ * Input for updating feature access with partial config merge.
+ */
+export interface FeatureSetAccessInput {
+    /** Company ID to update (either this or externalOrgId required) */
+    companyId?: string;
+    /** Your product's external org ID (either this or companyId required) */
+    externalOrgId?: string;
+    /** Feature code to update */
+    featureCode: string;
+    /** Enable or disable the feature */
+    isEnabled?: boolean;
+    /** Maximum quantity allowed (for quantity-based features) */
+    quantityLimit?: number | null;
+    /** Included quantity before billing kicks in */
+    includedQuantity?: number | null;
+    /**
+     * Custom config values to merge with existing config.
+     * Only specified fields will be updated - other fields remain unchanged.
+     */
+    config?: Record<string, unknown>;
+    /** Source of the access change */
+    source?: "subscription" | "manual" | "trial" | "api";
+    /** When the access expires (null for no expiration) */
+    validUntil?: Date | null;
+}
 /**
  * Input for tracking feature usage.
  */
@@ -490,6 +516,132 @@ export declare class ChatarminOS {
             source: string;
             validUntil: Date | null;
         }[]>;
+        /**
+         * Update feature access for a company with partial config merge.
+         *
+         * This allows you to update individual feature configs without
+         * replacing all config values. Only the fields you specify in
+         * `config` will be updated - other fields remain unchanged.
+         *
+         * @param input - Update parameters
+         * @returns Updated feature access information
+         *
+         * @example Update by company ID
+         * ```typescript
+         * await os.features.setAccess({
+         *   companyId: 'comp_xxx',
+         *   featureCode: 'ai_credit',
+         *   isEnabled: true,
+         *   config: {
+         *     included_quantity: 500,
+         *     max_quantity: 1000
+         *   }
+         * })
+         * ```
+         *
+         * @example Update by your product's external org ID
+         * ```typescript
+         * await os.features.setAccess({
+         *   externalOrgId: 'org_abc123',
+         *   featureCode: 'ai_credit',
+         *   config: { tier_level: 'premium' }
+         * })
+         * ```
+         *
+         * @example Partial config update (only updates specified fields)
+         * ```typescript
+         * // Existing config: { tier_level: 'basic', max_seats: 5 }
+         * await os.features.setAccess({
+         *   companyId: 'comp_xxx',
+         *   featureCode: 'team_seats',
+         *   config: { max_seats: 10 }  // tier_level remains 'basic'
+         * })
+         * // New config: { tier_level: 'basic', max_seats: 10 }
+         * ```
+         */
+        setAccess: (input: FeatureSetAccessInput) => Promise<{
+            success: boolean;
+            featureCode: string;
+            companyId: string;
+            isEnabled: boolean;
+            quantityLimit: number | null;
+            includedQuantity: number | null;
+            configValues: Record<string, unknown>;
+            source: string;
+            validUntil: Date | null;
+            created: boolean;
+            updated: boolean;
+        }>;
+        /**
+         * Get all feature access using your product's external org ID.
+         *
+         * Convenience method when you know the external org ID but not
+         * the ChatarminOS company ID.
+         *
+         * @param externalOrgId - Your product's organization ID
+         * @returns All features with their access status and config values
+         *
+         * @example
+         * ```typescript
+         * const result = await os.features.getAccessByExternalOrgId('org_abc123')
+         *
+         * console.log(`Company: ${result.companyId}`)
+         * for (const f of result.features) {
+         *   console.log(`${f.featureCode}: ${f.isEnabled}`)
+         *   console.log(`  Config:`, f.configValues)
+         * }
+         * ```
+         */
+        getAccessByExternalOrgId: (externalOrgId: string) => Promise<{
+            companyId: string;
+            externalOrgId: string;
+            features: {
+                featureCode: string;
+                featureName: string;
+                description: string | null;
+                hasQuantity: boolean;
+                isEnabled: boolean;
+                quantityLimit: number | null;
+                includedQuantity: number;
+                configValues: Record<string, unknown>;
+                source: string;
+                validUntil: Date | null;
+            }[];
+        }>;
+        /**
+         * Check specific feature access using your product's external org ID.
+         *
+         * @param externalOrgId - Your product's organization ID
+         * @param featureCode - Feature code to check
+         * @returns Detailed feature access including config values
+         *
+         * @example
+         * ```typescript
+         * const access = await os.features.checkByExternalOrgId(
+         *   'org_abc123',
+         *   'ai_credit'
+         * )
+         *
+         * if (access.canUse) {
+         *   console.log(`Remaining: ${access.remaining}`)
+         *   console.log(`Config:`, access.configValues)
+         * }
+         * ```
+         */
+        checkByExternalOrgId: (externalOrgId: string, featureCode: string) => Promise<{
+            featureCode: string;
+            companyId: string;
+            externalOrgId: string;
+            isEnabled: boolean;
+            hasQuantity: boolean;
+            currentUsage: number;
+            quantityLimit: number | null;
+            includedQuantity: number;
+            remaining: number | null;
+            isAtLimit: boolean;
+            canUse: boolean;
+            configValues: Record<string, unknown>;
+        }>;
     };
     /**
      * Billing, usage tracking, and subscription management.
@@ -862,6 +1014,18 @@ export declare class ChatarminOS {
             id: string;
             code: string;
             name: string;
+            description: string | null;
+            baseFee: {
+                catalogPriceId: string | null;
+                stripe: {
+                    priceId: string;
+                    productId: string | null;
+                    productName: string | null;
+                    unitAmount: number | null;
+                    currency: string | null;
+                    interval: string | null;
+                };
+            } | null;
             features: {
                 id: string;
                 code: string;
@@ -944,38 +1108,57 @@ export declare class ChatarminOS {
          * Get detailed tier information by code.
          *
          * Returns full tier details including:
+         * - Base fee price (if configured)
          * - Features with config values
-         * - Stripe price IDs for subscription creation
+         * - Stripe price IDs for subscription creation (base fee + feature prices)
          * - Stripe product info
          *
          * @param tierCode - Tier code (e.g., "free", "pro")
-         * @returns Tier with features and Stripe prices
+         * @returns Tier with features, base fee, and Stripe prices
          *
          * @example
          * ```typescript
          * const tier = await os.tiers.get('pro')
          *
+         * // Check base fee (for features without individual prices)
+         * if (tier.baseFee) {
+         *   console.log(`Base fee: ${tier.baseFee.stripe.priceId}`)
+         *   console.log(`Amount: ${tier.baseFee.stripe.unitAmount / 100}€`)
+         * }
+         *
          * // Access features
          * for (const feature of tier.features) {
          *   console.log(feature.code, feature.configValues)
          * }
          *
          * // Get Stripe prices for subscription creation
+         * // Includes base fee + all feature prices
          * console.log(tier.stripePriceIds)
-         * // ['price_xxx', 'price_yyy']
+         * // ['price_base', 'price_feature1', 'price_feature2']
          *
-         * // Feature-level Stripe info
-         * const aiFeature = tier.features.find(f => f.code === 'ai_credit')
-         * if (aiFeature?.stripe) {
-         *   console.log(aiFeature.stripe.priceId)
-         *   console.log(aiFeature.stripe.unitAmount) // in cents
-         * }
+         * // Create Stripe subscription with all prices
+         * const sub = await stripe.subscriptions.create({
+         *   customer: stripeCustomerId,
+         *   items: tier.stripePriceIds.map(price => ({ price }))
+         * })
          * ```
          */
         get: (tierCode: string) => Promise<{
             id: string;
             code: string;
             name: string;
+            description: string | null;
+            baseFee: {
+                catalogPriceId: string | null;
+                stripe: {
+                    priceId: string;
+                    productId: string | null;
+                    productName: string | null;
+                    unitAmount: number | null;
+                    currency: string | null;
+                    interval: string | null;
+                };
+            } | null;
             features: {
                 id: string;
                 code: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAQ/C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAA;IACrB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,KAAK,EAAE;QACL,oCAAoC;QACpC,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,2CAA2C;QAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,yCAAyC;QACzC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAClB,CAAA;IACD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAA;IAChE,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,YAAY,EAAE,MAAM,CAAA;QACpB,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,oBAAoB,EAAE,MAAM,CAAA;IAC5B,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,oCAAoC;QACpC,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,2CAA2C;QAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,yCAAyC;QACzC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAClB,CAAA;IAED;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAE7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAA;IAEjB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAA;IAEnB;;;;;OAKG;IACH,UAAU,EAAE,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAAA;IAEnD,8DAA8D;IAC9D,aAAa,CAAC,EAAE;QACd,yCAAyC;QACzC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,qDAAqD;QACrD,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,sCAAsC;QACtC,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,yCAAyC;QACzC,WAAW,CAAC,EAAE,OAAO,CAAA;KACtB,CAAA;CACF;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAgD;IAE9D;;;;;;;;;;;;;;;OAeG;gBACS,MAAM,EAAE,iBAAiB;IAoBrC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,SAAS;QAGT;;;;;;;;;;;;;;;;;;;;;;WAsBG;kCACuB;YAAE,aAAa,EAAE,MAAM,CAAA;SAAE;;;;;;;QAGnD;;;;;;;;;;;;;;;;;;;;;;WAsBG;wBACa,kBAAkB;;;;;;QAGlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAmCG;2BACgB,cAAc,KAAG,OAAO,CAAC,eAAe,CAAC;MAG/D;IAMD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,QAAQ;QAGR;;;;;;;;;;;;;;;;;;;;;;;;;;;WA2BG;uBACY,iBAAiB;;;;;;;;;;;QAEhC;;;;;;;;;;;;;;;;;;;;;WAqBG;gCACqB,MAAM;;;;;;;;;;;MAGjC;IAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,IAAI,OAAO;QAGP;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA4BG;4BACiB,eAAe;;;;;;;;;;;QAGnC;;;;;;;;;;;;;;;;;;;;;;;WAuBG;+BACoB,kBAAkB;;;;;;;;;;;QAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;WA0BG;kCACuB,qBAAqB;;;;;;;;;;;;;;;QAG/C;;;;;;;;;;;;;;;;;;;;;;;;WAwBG;+BACoB,MAAM;;;;;;;;;;;;;;;;MAGhC;IAMD;;;;;;;;;;;;;;;OAeG;IACH,IAAI,KAAK;QAGL;;;;;;;;;;;;;;;;;WAiBG;wBACa;YACd,SAAS,EAAE,MAAM,CAAA;YACjB,aAAa,EAAE,MAAM,CAAA;YACrB,cAAc,CAAC,EAAE,MAAM,CAAA;SACxB;;;;;;;;;;;;;MASJ;IAMD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,aAAa;QAGb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA6BG;2BACgB,MAAM,WAAW,cAAc;;;;;QAOlD;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;;;;;QAIH;;;;;;;;;;;;;;;;;;;;;;;WAuBG;4BACiB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;MAG7B;IAMD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,KAAK;QAGL;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;;;;;QAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA+BG;wBACa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;QAGtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8BG;0BACe,MAAM,WAAW,cAAc;;;;;MAOpD;IAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuFG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CA0E3D;AAGD,YAAY,EAAE,SAAS,EAAE,CAAA;AAGzB,eAAe,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -272,6 +272,95 @@ export class ChatarminOS {
              * ```
              */
             listAccess: (companyId) => client.features.getAccess.query({ companyId }),
+            /**
+             * Update feature access for a company with partial config merge.
+             *
+             * This allows you to update individual feature configs without
+             * replacing all config values. Only the fields you specify in
+             * `config` will be updated - other fields remain unchanged.
+             *
+             * @param input - Update parameters
+             * @returns Updated feature access information
+             *
+             * @example Update by company ID
+             * ```typescript
+             * await os.features.setAccess({
+             *   companyId: 'comp_xxx',
+             *   featureCode: 'ai_credit',
+             *   isEnabled: true,
+             *   config: {
+             *     included_quantity: 500,
+             *     max_quantity: 1000
+             *   }
+             * })
+             * ```
+             *
+             * @example Update by your product's external org ID
+             * ```typescript
+             * await os.features.setAccess({
+             *   externalOrgId: 'org_abc123',
+             *   featureCode: 'ai_credit',
+             *   config: { tier_level: 'premium' }
+             * })
+             * ```
+             *
+             * @example Partial config update (only updates specified fields)
+             * ```typescript
+             * // Existing config: { tier_level: 'basic', max_seats: 5 }
+             * await os.features.setAccess({
+             *   companyId: 'comp_xxx',
+             *   featureCode: 'team_seats',
+             *   config: { max_seats: 10 }  // tier_level remains 'basic'
+             * })
+             * // New config: { tier_level: 'basic', max_seats: 10 }
+             * ```
+             */
+            setAccess: (input) => client.features.updateAccess.mutate(input),
+            /**
+             * Get all feature access using your product's external org ID.
+             *
+             * Convenience method when you know the external org ID but not
+             * the ChatarminOS company ID.
+             *
+             * @param externalOrgId - Your product's organization ID
+             * @returns All features with their access status and config values
+             *
+             * @example
+             * ```typescript
+             * const result = await os.features.getAccessByExternalOrgId('org_abc123')
+             *
+             * console.log(`Company: ${result.companyId}`)
+             * for (const f of result.features) {
+             *   console.log(`${f.featureCode}: ${f.isEnabled}`)
+             *   console.log(`  Config:`, f.configValues)
+             * }
+             * ```
+             */
+            getAccessByExternalOrgId: (externalOrgId) => client.features.getAccessByExternalOrgId.query({ externalOrgId }),
+            /**
+             * Check specific feature access using your product's external org ID.
+             *
+             * @param externalOrgId - Your product's organization ID
+             * @param featureCode - Feature code to check
+             * @returns Detailed feature access including config values
+             *
+             * @example
+             * ```typescript
+             * const access = await os.features.checkByExternalOrgId(
+             *   'org_abc123',
+             *   'ai_credit'
+             * )
+             *
+             * if (access.canUse) {
+             *   console.log(`Remaining: ${access.remaining}`)
+             *   console.log(`Config:`, access.configValues)
+             * }
+             * ```
+             */
+            checkByExternalOrgId: (externalOrgId, featureCode) => client.features.checkByExternalOrgId.query({
+                externalOrgId,
+                featureCode,
+            }),
         };
     }
     // ==========================================================================
@@ -631,32 +720,39 @@ export class ChatarminOS {
              * Get detailed tier information by code.
              *
              * Returns full tier details including:
+             * - Base fee price (if configured)
              * - Features with config values
-             * - Stripe price IDs for subscription creation
+             * - Stripe price IDs for subscription creation (base fee + feature prices)
              * - Stripe product info
              *
              * @param tierCode - Tier code (e.g., "free", "pro")
-             * @returns Tier with features and Stripe prices
+             * @returns Tier with features, base fee, and Stripe prices
              *
              * @example
              * ```typescript
              * const tier = await os.tiers.get('pro')
              *
+             * // Check base fee (for features without individual prices)
+             * if (tier.baseFee) {
+             *   console.log(`Base fee: ${tier.baseFee.stripe.priceId}`)
+             *   console.log(`Amount: ${tier.baseFee.stripe.unitAmount / 100}€`)
+             * }
+             *
              * // Access features
              * for (const feature of tier.features) {
              *   console.log(feature.code, feature.configValues)
              * }
              *
              * // Get Stripe prices for subscription creation
+             * // Includes base fee + all feature prices
              * console.log(tier.stripePriceIds)
-             * // ['price_xxx', 'price_yyy']
+             * // ['price_base', 'price_feature1', 'price_feature2']
              *
-             * // Feature-level Stripe info
-             * const aiFeature = tier.features.find(f => f.code === 'ai_credit')
-             * if (aiFeature?.stripe) {
-             *   console.log(aiFeature.stripe.priceId)
-             *   console.log(aiFeature.stripe.unitAmount) // in cents
-             * }
+             * // Create Stripe subscription with all prices
+             * const sub = await stripe.subscriptions.create({
+             *   customer: stripeCustomerId,
+             *   items: tier.stripePriceIds.map(price => ({ price }))
+             * })
              * ```
              */
             get: (tierCode) => client.tiers.getByCode.query({ code: tierCode }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatarmin/os",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Type-safe SDK for ChatarminOS - Customer & Subscription Management",
   "type": "module",
   "publishConfig": {
@@ -24,11 +24,11 @@
     "typecheck": "tsc --noEmit --skipLibCheck",
     "test": "tsx test-sdk.ts",
     "prepublishOnly": "pnpm build",
-    "publish": "./scripts/publish.sh",
-    "publish:patch": "./scripts/publish.sh patch",
-    "publish:minor": "./scripts/publish.sh minor",
-    "publish:major": "./scripts/publish.sh major",
-    "publish:dry": "npm publish --dry-run"
+    "release": "./scripts/publish.sh",
+    "release:patch": "./scripts/publish.sh patch",
+    "release:minor": "./scripts/publish.sh minor",
+    "release:major": "./scripts/publish.sh major",
+    "release:dry": "npm publish --dry-run"
   },
   "keywords": [
     "chatarmin",