clhq-credits-client 1.1.0-alpha.116

package/.versionrc

@@ -0,0 +1,3 @@
+{
+  "tagPrefix": "clhq-credits-client-"
+}

package/README.md

@@ -0,0 +1,99 @@
+# CLHQ Credits Client
+
+A TypeScript client for invoking the CLHQ Credits Service Lambda functions.
+
+## Installation
+
+```bash
+npm install clhq-credits-client
+# or
+yarn add clhq-credits-client
+```
+
+## Usage
+
+```typescript
+import { CreditsLambdaClient, OperationType } from 'clhq-credits-client';
+
+// Initialize client
+const creditsClient = new CreditsLambdaClient({
+  region: 'ap-southeast-2',
+  stage: 'dev'
+});
+
+// Reserve credits before operation
+const reservation = await creditsClient.reserveCredits({
+  userId: 'user-123',
+  operationType: OperationType.VIDEO_EXPORT_1080P,
+  estimatedCredits: 8,
+  operationId: 'video-export-456'
+});
+
+// Execute operation...
+
+// Finalize credits after completion
+const finalization = await creditsClient.finalizeCredits({
+  reservationId: reservation.reservationId,
+  actualCredits: 8,
+  resultUrl: 'https://s3.amazonaws.com/bucket/video.mp4'
+});
+
+// Or use the convenience method
+const result = await creditsClient.executeWithCredits(
+  () => performVideoExport(), // Your operation
+  {
+    userId: 'user-123',
+    operationType: OperationType.VIDEO_EXPORT_1080P,
+    estimatedCredits: 8,
+    operationId: 'video-export-456'
+  },
+  (exportResult) => ({
+    reservationId: reservation.reservationId,
+    actualCredits: 8,
+    resultUrl: exportResult.url
+  })
+);
+```
+
+## API Methods
+
+### `reserveCredits(params)`
+Reserve credits before starting an operation.
+
+### `finalizeCredits(params)`
+Finalize credit consumption after operation completes.
+
+### `releaseCredits(params)`
+Release reserved credits if operation fails.
+
+### `getBalance(params)`
+Get user's current credit balance.
+
+### `estimateCost(params)`
+Estimate credit cost for an operation.
+
+### `executeWithCredits(operation, reserveParams, finalizeParams)`
+Convenience method that handles the full reserve → execute → finalize flow.
+
+## Operation Types
+
+- `VIDEO_EXPORT_720P`, `VIDEO_EXPORT_1080P`, `VIDEO_EXPORT_4K`
+- `BACKGROUND_REMOVAL`, `AI_IMAGE_GENERATION`, `SUBTITLE_GENERATION`
+- `HLS_TRANSCODING`, `REMOTION_RENDER_*` variants
+- And more...
+
+## Configuration
+
+The client automatically detects AWS region and stage from environment variables:
+
+- `AWS_REGION` (default: 'ap-southeast-2')
+- `STAGE` (default: 'dev')
+
+Or you can pass them explicitly to the constructor.
+
+## Error Handling
+
+The client throws specific errors:
+- `ResourceNotFoundException`: Credits service not available
+- `TooManyRequestsException`: Rate limited
+- Business logic errors from the credits service

package/dist/credits-lambda-client.d.ts

@@ -0,0 +1,45 @@
+import { ReserveCreditsRequest, ReserveCreditsResponse, FinalizeCreditsRequest, FinalizeCreditsResponse, ReleaseCreditsRequest, ReleaseCreditsResponse, GetBalanceRequest, GetBalanceResponse, EstimateCostRequest, EstimateCostResponse } from './types';
+export declare class CreditsLambdaClient {
+    private lambda;
+    private stage;
+    constructor(options?: {
+        region?: string;
+        stage?: string;
+    });
+    /**
+     * Get the Lambda function name for a specific handler
+     */
+    private getFunctionName;
+    /**
+     * Generic method to invoke Lambda functions with proper error handling
+     */
+    private invoke;
+    /**
+     * Reserve credits before starting an operation
+     */
+    reserveCredits(params: ReserveCreditsRequest): Promise<ReserveCreditsResponse>;
+    /**
+     * Finalize credit consumption after operation completes
+     */
+    finalizeCredits(params: FinalizeCreditsRequest): Promise<FinalizeCreditsResponse>;
+    /**
+     * Release reserved credits if operation fails
+     */
+    releaseCredits(params: ReleaseCreditsRequest): Promise<ReleaseCreditsResponse>;
+    /**
+     * Get user's credit balance
+     */
+    getBalance(params: GetBalanceRequest): Promise<GetBalanceResponse>;
+    /**
+     * Estimate credit cost for an operation
+     */
+    estimateCost(params: EstimateCostRequest): Promise<EstimateCostResponse>;
+    /**
+     * Convenience method: Reserve and execute operation with automatic finalization
+     */
+    executeWithCredits<T>(operation: () => Promise<T>, reserveParams: ReserveCreditsRequest, finalizeParams: (result: T) => FinalizeCreditsRequest): Promise<{
+        result: T;
+        creditsUsed: number;
+    }>;
+}
+//# sourceMappingURL=credits-lambda-client.d.ts.map

package/dist/credits-lambda-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits-lambda-client.d.ts","sourceRoot":"","sources":["../src/credits-lambda-client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAOzD;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;YACW,MAAM;IAsCpB;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAIlC;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;IAInC;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAIlC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIxE;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAIhC;;OAEG;IACG,kBAAkB,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,qBAAqB,EACpC,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,sBAAsB,GACpD,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAyC/C"}

package/dist/credits-lambda-client.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditsLambdaClient = void 0;
+const client_lambda_1 = require("@aws-sdk/client-lambda");
+class CreditsLambdaClient {
+    lambda;
+    stage;
+    constructor(options) {
+        this.lambda = new client_lambda_1.LambdaClient({
+            region: options?.region || process.env.AWS_REGION || 'ap-southeast-2',
+        });
+        this.stage = options?.stage || process.env.STAGE || 'dev';
+    }
+    /**
+     * Get the Lambda function name for a specific handler
+     */
+    getFunctionName(handler) {
+        return `clippy-credits-service-${this.stage}-${handler}`;
+    }
+    /**
+     * Generic method to invoke Lambda functions with proper error handling
+     */
+    async invoke(handler, payload) {
+        const command = new client_lambda_1.InvokeCommand({
+            FunctionName: this.getFunctionName(handler),
+            Payload: Buffer.from(JSON.stringify(payload)),
+        });
+        try {
+            const response = await this.lambda.send(command);
+            if (response.FunctionError) {
+                const errorPayload = JSON.parse(Buffer.from(response.Payload).toString());
+                throw new Error(errorPayload.errorMessage || 'Lambda invocation failed');
+            }
+            const result = JSON.parse(Buffer.from(response.Payload).toString());
+            if (!result.success && result.error) {
+                throw new Error(result.error);
+            }
+            return result;
+        }
+        catch (error) {
+            // Re-throw Lambda invocation errors
+            if (error.name === 'ResourceNotFoundException') {
+                throw new Error(`Credits service not available: ${handler}`);
+            }
+            if (error.name === 'TooManyRequestsException') {
+                throw new Error('Credits service rate limited');
+            }
+            throw error;
+        }
+    }
+    /**
+     * Reserve credits before starting an operation
+     */
+    async reserveCredits(params) {
+        return this.invoke('reserve', params);
+    }
+    /**
+     * Finalize credit consumption after operation completes
+     */
+    async finalizeCredits(params) {
+        return this.invoke('finalize', params);
+    }
+    /**
+     * Release reserved credits if operation fails
+     */
+    async releaseCredits(params) {
+        return this.invoke('release', params);
+    }
+    /**
+     * Get user's credit balance
+     */
+    async getBalance(params) {
+        return this.invoke('balance', params);
+    }
+    /**
+     * Estimate credit cost for an operation
+     */
+    async estimateCost(params) {
+        return this.invoke('estimate', params);
+    }
+    /**
+     * Convenience method: Reserve and execute operation with automatic finalization
+     */
+    async executeWithCredits(operation, reserveParams, finalizeParams) {
+        // Reserve credits
+        const reservation = await this.reserveCredits(reserveParams);
+        if (!reservation.success || !reservation.reservationId) {
+            throw new Error(reservation.error || 'Failed to reserve credits');
+        }
+        try {
+            // Execute the operation
+            const result = await operation();
+            // Finalize credits
+            const finalizeRequest = finalizeParams(result);
+            finalizeRequest.reservationId = reservation.reservationId;
+            const finalization = await this.finalizeCredits(finalizeRequest);
+            if (!finalization.success) {
+                throw new Error(finalization.error || 'Failed to finalize credits');
+            }
+            return {
+                result,
+                creditsUsed: finalization.creditsUsed || 0,
+            };
+        }
+        catch (error) {
+            // Release credits on failure
+            try {
+                await this.releaseCredits({
+                    reservationId: reservation.reservationId,
+                    reason: error instanceof Error ? error.message : 'Operation failed',
+                });
+            }
+            catch (releaseError) {
+                console.warn('Failed to release credits:', releaseError);
+            }
+            throw error;
+        }
+    }
+}
+exports.CreditsLambdaClient = CreditsLambdaClient;
+//# sourceMappingURL=credits-lambda-client.js.map

package/dist/credits-lambda-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits-lambda-client.js","sourceRoot":"","sources":["../src/credits-lambda-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { CreditsLambdaClient } from './credits-lambda-client';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditsLambdaClient = void 0;
+// Main client class
+var credits_lambda_client_1 = require("./credits-lambda-client");
+Object.defineProperty(exports, "CreditsLambdaClient", { enumerable: true, get: function () { return credits_lambda_client_1.CreditsLambdaClient; } });
+// All types
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oBAAoB;AACpB,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA;AAE5B,YAAY;AACZ,0CAAwB"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+export declare enum OperationType {
+    VIDEO_EXPORT_720P = "VIDEO_EXPORT_720P",
+    VIDEO_EXPORT_1080P = "VIDEO_EXPORT_1080P",
+    VIDEO_EXPORT_4K = "VIDEO_EXPORT_4K",
+    GIF_EXPORT = "GIF_EXPORT",
+    AUDIO_EXTRACTION = "AUDIO_EXTRACTION",
+    BACKGROUND_REMOVAL = "BACKGROUND_REMOVAL",
+    AI_IMAGE_GENERATION = "AI_IMAGE_GENERATION",
+    AI_TEXT_COMPLETION = "AI_TEXT_COMPLETION",
+    SUBTITLE_GENERATION = "SUBTITLE_GENERATION",
+    HLS_TRANSCODING = "HLS_TRANSCODING",
+    THUMBNAIL_GENERATION = "THUMBNAIL_GENERATION",
+    FILMSTRIP_GENERATION = "FILMSTRIP_GENERATION",
+    REMOTION_RENDER_720P = "REMOTION_RENDER_720P",
+    REMOTION_RENDER_1080P = "REMOTION_RENDER_1080P",
+    REMOTION_RENDER_4K = "REMOTION_RENDER_4K",
+    REMOTION_THUMBNAIL = "REMOTION_THUMBNAIL"
+}
+export interface ReserveCreditsRequest {
+    userId: string;
+    operationType: OperationType;
+    estimatedCredits: number;
+    operationId: string;
+    metadata?: Record<string, any>;
+}
+export interface FinalizeCreditsRequest {
+    reservationId: string;
+    actualCredits: number;
+    resultUrl?: string;
+}
+export interface ReleaseCreditsRequest {
+    reservationId: string;
+    reason?: string;
+}
+export interface GetBalanceRequest {
+    userId: string;
+}
+export interface EstimateCostRequest {
+    userId: string;
+    operationType: OperationType;
+    durationMinutes?: number;
+    durationSeconds?: number;
+    variants?: number;
+    isHighRes?: boolean;
+}
+export interface ReserveCreditsResponse {
+    success: boolean;
+    reservationId?: string;
+    creditsReserved?: number;
+    newAvailableBalance?: number;
+    error?: string;
+}
+export interface FinalizeCreditsResponse {
+    success: boolean;
+    transactionId?: string;
+    creditsUsed?: number;
+    newBalance?: number;
+    refundedCredits?: number;
+    error?: string;
+}
+export interface ReleaseCreditsResponse {
+    success: boolean;
+    creditsReleased?: number;
+    newAvailableBalance?: number;
+    error?: string;
+}
+export interface GetBalanceResponse {
+    success: boolean;
+    totalEarned?: number;
+    totalUsed?: number;
+    currentBalance?: number;
+    expiringCredits?: number;
+    expiringDate?: string;
+    error?: string;
+}
+export interface EstimateCostResponse {
+    success: boolean;
+    estimatedCredits?: number;
+    breakdown?: {
+        baseCost: number;
+        durationCost: number;
+        modifierCost: number;
+    };
+    currentBalance?: number;
+    canProceed?: boolean;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,30 @@
+"use strict";
+// ============================================
+// Operation Types for Credit Calculation
+// ============================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationType = void 0;
+var OperationType;
+(function (OperationType) {
+    // Video exports
+    OperationType["VIDEO_EXPORT_720P"] = "VIDEO_EXPORT_720P";
+    OperationType["VIDEO_EXPORT_1080P"] = "VIDEO_EXPORT_1080P";
+    OperationType["VIDEO_EXPORT_4K"] = "VIDEO_EXPORT_4K";
+    OperationType["GIF_EXPORT"] = "GIF_EXPORT";
+    OperationType["AUDIO_EXTRACTION"] = "AUDIO_EXTRACTION";
+    // AI operations
+    OperationType["BACKGROUND_REMOVAL"] = "BACKGROUND_REMOVAL";
+    OperationType["AI_IMAGE_GENERATION"] = "AI_IMAGE_GENERATION";
+    OperationType["AI_TEXT_COMPLETION"] = "AI_TEXT_COMPLETION";
+    OperationType["SUBTITLE_GENERATION"] = "SUBTITLE_GENERATION";
+    // Media processing
+    OperationType["HLS_TRANSCODING"] = "HLS_TRANSCODING";
+    OperationType["THUMBNAIL_GENERATION"] = "THUMBNAIL_GENERATION";
+    OperationType["FILMSTRIP_GENERATION"] = "FILMSTRIP_GENERATION";
+    // Remotion rendering
+    OperationType["REMOTION_RENDER_720P"] = "REMOTION_RENDER_720P";
+    OperationType["REMOTION_RENDER_1080P"] = "REMOTION_RENDER_1080P";
+    OperationType["REMOTION_RENDER_4K"] = "REMOTION_RENDER_4K";
+    OperationType["REMOTION_THUMBNAIL"] = "REMOTION_THUMBNAIL";
+})(OperationType || (exports.OperationType = OperationType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+CAA+C;AAC/C,yCAAyC;AACzC,+CAA+C;;;AAE/C,IAAY,aAwBX;AAxBD,WAAY,aAAa;IACvB,gBAAgB;IAChB,wDAAuC,CAAA;IACvC,0DAAyC,CAAA;IACzC,oDAAmC,CAAA;IACnC,0CAAyB,CAAA;IACzB,sDAAqC,CAAA;IAErC,gBAAgB;IAChB,0DAAyC,CAAA;IACzC,4DAA2C,CAAA;IAC3C,0DAAyC,CAAA;IACzC,4DAA2C,CAAA;IAE3C,mBAAmB;IACnB,oDAAmC,CAAA;IACnC,8DAA6C,CAAA;IAC7C,8DAA6C,CAAA;IAE7C,qBAAqB;IACrB,8DAA6C,CAAA;IAC7C,gEAA+C,CAAA;IAC/C,0DAAyC,CAAA;IACzC,0DAAyC,CAAA;AAC3C,CAAC,EAxBW,aAAa,6BAAb,aAAa,QAwBxB"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "clhq-credits-client",
+  "version": "1.1.0-alpha.116",
+  "description": "Lambda client for invoking credits service",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "yarn exec tsc -p tsconfig.json",
+    "clean:dist": "rimraf dist",
+    "clean:all": "yarn run clean:dist",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint \"src/**/*.ts\" --fix",
+    "version:upgrade:alpha": "standard-version --prerelease alpha",
+    "release": "npm publish --tag alpha",
+    "release:alpha": "npm publish --tag alpha",
+    "release:prealpha": "",
+    "clean:build": "rimraf .build",
+    "clean:webpack": "rimraf .webpack",
+    "clean:serverless": "rimraf .serverless",
+    "sls:deploy": "sls deploy",
+    "sls:deploy:dev": "env-cmd -f ../../.env.dev sls deploy --stage dev",
+    "sls:remove:dev": "env-cmd -f ../../.env.dev sls remove --stage dev",
+    "sls:offline": "sls offline",
+    "sls:package": "sls package",
+    "sls:package2": "npm run clean:all&& npm run sls:package",
+    "sls:remove": "sls remove"
+  },
+  "dependencies": {
+    "@aws-sdk/client-lambda": "^3.490.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.4",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-lambda": "^3.490.0"
+  }
+}

package/src/credits-lambda-client.ts

@@ -0,0 +1,165 @@
+import { LambdaClient, InvokeCommand } from '@aws-sdk/client-lambda';
+import {
+  ReserveCreditsRequest,
+  ReserveCreditsResponse,
+  FinalizeCreditsRequest,
+  FinalizeCreditsResponse,
+  ReleaseCreditsRequest,
+  ReleaseCreditsResponse,
+  GetBalanceRequest,
+  GetBalanceResponse,
+  EstimateCostRequest,
+  EstimateCostResponse,
+} from './types';
+
+export class CreditsLambdaClient {
+  private lambda: LambdaClient;
+  private stage: string;
+
+  constructor(options?: { region?: string; stage?: string }) {
+    this.lambda = new LambdaClient({
+      region: options?.region || process.env.AWS_REGION || 'ap-southeast-2',
+    });
+    this.stage = options?.stage || process.env.STAGE || 'dev';
+  }
+
+  /**
+   * Get the Lambda function name for a specific handler
+   */
+  private getFunctionName(handler: string): string {
+    return `clippy-credits-service-${this.stage}-${handler}`;
+  }
+
+  /**
+   * Generic method to invoke Lambda functions with proper error handling
+   */
+  private async invoke<TRequest, TResponse>(
+    handler: string,
+    payload: TRequest
+  ): Promise<TResponse> {
+    const command = new InvokeCommand({
+      FunctionName: this.getFunctionName(handler),
+      Payload: Buffer.from(JSON.stringify(payload)),
+    });
+
+    try {
+      const response = await this.lambda.send(command);
+
+      if (response.FunctionError) {
+        const errorPayload = JSON.parse(
+          Buffer.from(response.Payload!).toString()
+        );
+        throw new Error(errorPayload.errorMessage || 'Lambda invocation failed');
+      }
+
+      const result = JSON.parse(Buffer.from(response.Payload!).toString());
+
+      if (!result.success && result.error) {
+        throw new Error(result.error);
+      }
+
+      return result;
+    } catch (error: any) {
+      // Re-throw Lambda invocation errors
+      if (error.name === 'ResourceNotFoundException') {
+        throw new Error(`Credits service not available: ${handler}`);
+      }
+      if (error.name === 'TooManyRequestsException') {
+        throw new Error('Credits service rate limited');
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Reserve credits before starting an operation
+   */
+  async reserveCredits(
+    params: ReserveCreditsRequest
+  ): Promise<ReserveCreditsResponse> {
+    return this.invoke('reserve', params);
+  }
+
+  /**
+   * Finalize credit consumption after operation completes
+   */
+  async finalizeCredits(
+    params: FinalizeCreditsRequest
+  ): Promise<FinalizeCreditsResponse> {
+    return this.invoke('finalize', params);
+  }
+
+  /**
+   * Release reserved credits if operation fails
+   */
+  async releaseCredits(
+    params: ReleaseCreditsRequest
+  ): Promise<ReleaseCreditsResponse> {
+    return this.invoke('release', params);
+  }
+
+  /**
+   * Get user's credit balance
+   */
+  async getBalance(params: GetBalanceRequest): Promise<GetBalanceResponse> {
+    return this.invoke('balance', params);
+  }
+
+  /**
+   * Estimate credit cost for an operation
+   */
+  async estimateCost(
+    params: EstimateCostRequest
+  ): Promise<EstimateCostResponse> {
+    return this.invoke('estimate', params);
+  }
+
+  /**
+   * Convenience method: Reserve and execute operation with automatic finalization
+   */
+  async executeWithCredits<T>(
+    operation: () => Promise<T>,
+    reserveParams: ReserveCreditsRequest,
+    finalizeParams: (result: T) => FinalizeCreditsRequest
+  ): Promise<{ result: T; creditsUsed: number }> {
+    // Reserve credits
+    const reservation = await this.reserveCredits(reserveParams);
+
+    if (!reservation.success || !reservation.reservationId) {
+      throw new Error(reservation.error || 'Failed to reserve credits');
+    }
+
+    try {
+      // Execute the operation
+      const result = await operation();
+
+      // Finalize credits
+      const finalizeRequest = finalizeParams(result);
+      finalizeRequest.reservationId = reservation.reservationId;
+
+      const finalization = await this.finalizeCredits(finalizeRequest);
+
+      if (!finalization.success) {
+        throw new Error(finalization.error || 'Failed to finalize credits');
+      }
+
+      return {
+        result,
+        creditsUsed: finalization.creditsUsed || 0,
+      };
+
+    } catch (error) {
+      // Release credits on failure
+      try {
+        await this.releaseCredits({
+          reservationId: reservation.reservationId,
+          reason: error instanceof Error ? error.message : 'Operation failed',
+        });
+      } catch (releaseError) {
+        console.warn('Failed to release credits:', releaseError);
+      }
+
+      throw error;
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+// Main client class
+export { CreditsLambdaClient } from './credits-lambda-client';
+
+// All types
+export * from './types';

package/src/types.ts

@@ -0,0 +1,116 @@
+// ============================================
+// Operation Types for Credit Calculation
+// ============================================
+
+export enum OperationType {
+  // Video exports
+  VIDEO_EXPORT_720P = 'VIDEO_EXPORT_720P',
+  VIDEO_EXPORT_1080P = 'VIDEO_EXPORT_1080P',
+  VIDEO_EXPORT_4K = 'VIDEO_EXPORT_4K',
+  GIF_EXPORT = 'GIF_EXPORT',
+  AUDIO_EXTRACTION = 'AUDIO_EXTRACTION',
+
+  // AI operations
+  BACKGROUND_REMOVAL = 'BACKGROUND_REMOVAL',
+  AI_IMAGE_GENERATION = 'AI_IMAGE_GENERATION',
+  AI_TEXT_COMPLETION = 'AI_TEXT_COMPLETION',
+  SUBTITLE_GENERATION = 'SUBTITLE_GENERATION',
+
+  // Media processing
+  HLS_TRANSCODING = 'HLS_TRANSCODING',
+  THUMBNAIL_GENERATION = 'THUMBNAIL_GENERATION',
+  FILMSTRIP_GENERATION = 'FILMSTRIP_GENERATION',
+
+  // Remotion rendering
+  REMOTION_RENDER_720P = 'REMOTION_RENDER_720P',
+  REMOTION_RENDER_1080P = 'REMOTION_RENDER_1080P',
+  REMOTION_RENDER_4K = 'REMOTION_RENDER_4K',
+  REMOTION_THUMBNAIL = 'REMOTION_THUMBNAIL',
+}
+
+// ============================================
+// Request Types
+// ============================================
+
+export interface ReserveCreditsRequest {
+  userId: string;
+  operationType: OperationType;
+  estimatedCredits: number;
+  operationId: string;
+  metadata?: Record<string, any>;
+}
+
+export interface FinalizeCreditsRequest {
+  reservationId: string;
+  actualCredits: number;
+  resultUrl?: string;
+}
+
+export interface ReleaseCreditsRequest {
+  reservationId: string;
+  reason?: string;
+}
+
+export interface GetBalanceRequest {
+  userId: string;
+}
+
+export interface EstimateCostRequest {
+  userId: string;
+  operationType: OperationType;
+  durationMinutes?: number;
+  durationSeconds?: number;
+  variants?: number;
+  isHighRes?: boolean;
+}
+
+// ============================================
+// Response Types
+// ============================================
+
+export interface ReserveCreditsResponse {
+  success: boolean;
+  reservationId?: string;
+  creditsReserved?: number;
+  newAvailableBalance?: number;
+  error?: string;
+}
+
+export interface FinalizeCreditsResponse {
+  success: boolean;
+  transactionId?: string;
+  creditsUsed?: number;
+  newBalance?: number;
+  refundedCredits?: number;
+  error?: string;
+}
+
+export interface ReleaseCreditsResponse {
+  success: boolean;
+  creditsReleased?: number;
+  newAvailableBalance?: number;
+  error?: string;
+}
+
+export interface GetBalanceResponse {
+  success: boolean;
+  totalEarned?: number;
+  totalUsed?: number;
+  currentBalance?: number;
+  expiringCredits?: number;
+  expiringDate?: string;
+  error?: string;
+}
+
+export interface EstimateCostResponse {
+  success: boolean;
+  estimatedCredits?: number;
+  breakdown?: {
+    baseCost: number;
+    durationCost: number;
+    modifierCost: number;
+  };
+  currentBalance?: number;
+  canProceed?: boolean;
+  error?: string;
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}