@channel.io/app-sdk-server 0.1.0

package/dist/native/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Native Function types for ch-app-store
+ *
+ * This module contains types for PUBLIC native functions only.
+ * Public functions don't require special RBAC claims.
+ */
+/**
+ * Native function client configuration
+ */
+export interface NativeFunctionClientConfig {
+    /** App ID */
+    appId: string;
+    /** App secret */
+    appSecret: string;
+    /** AppStore API base URL (default: https://app-store.channel.io) */
+    appStoreUrl?: string | undefined;
+    /** Enable debug logging */
+    debug?: boolean | undefined;
+}
+/**
+ * Function call context
+ */
+export interface FunctionContext {
+    /** Channel information */
+    channel: {
+        id: string;
+    };
+    /** Caller information */
+    caller: {
+        type: "user" | "manager" | "system";
+        id: string;
+    };
+    /** OAuth token (optional) */
+    authToken?: string;
+    /** API credentials (optional) */
+    apiCredentials?: Record<string, string>;
+}
+/**
+ * Native function request
+ */
+export interface NativeFunctionRequest<TParams = unknown> {
+    method: string;
+    params?: TParams;
+    context?: FunctionContext;
+    systemVersion?: string;
+}
+/**
+ * Native function response
+ */
+export interface NativeFunctionResponse<TResult = unknown> {
+    result?: TResult;
+    error?: NativeFunctionErrorResponse;
+}
+/**
+ * Native function error response structure
+ */
+export interface NativeFunctionErrorResponse {
+    code: number;
+    message: string;
+    data?: unknown;
+    type?: string;
+}
+/**
+ * Issue token params
+ */
+export interface IssueTokenParams {
+    secret: string;
+    channelId?: string;
+}
+/**
+ * Issue token result
+ */
+export interface IssueTokenResult {
+    accessToken: string;
+    refreshToken: string;
+    expiresIn: number;
+    expiresAt?: number;
+}
+/**
+ * Refresh token params
+ */
+export interface RefreshTokenParams {
+    refreshToken: string;
+}
+/**
+ * Command scope
+ */
+export type CommandScope = "front" | "desk";
+/**
+ * ALF mode for commands
+ */
+export type AlfMode = "disable" | "recommend";
+/**
+ * Parameter type for commands
+ */
+export type ParamType = "string" | "float" | "int" | "bool";
+/**
+ * Internationalization for command name
+ */
+export interface CommandNameI18n {
+    name: string;
+}
+/**
+ * Internationalization for command name and description
+ */
+export interface CommandNameDescI18n {
+    /** Name (max 30 chars, no spaces) */
+    name: string;
+    /** Description (max 100 chars) */
+    description: string;
+}
+/**
+ * Parameter definition internationalization
+ */
+export interface CommandParamDefI18n {
+    /** Name (max 20 chars, no spaces) */
+    name: string;
+    /** Description (max 50 chars) */
+    description: string;
+}
+/**
+ * Choice option for command parameters
+ */
+export interface CommandChoice {
+    /** Display name */
+    name: string;
+    /** Value */
+    value: string | number | boolean;
+    /** Internationalization map */
+    nameDescI18nMap?: Record<string, CommandNameDescI18n>;
+}
+/**
+ * Command parameter definition
+ */
+export interface CommandParamDefinition {
+    /** Parameter name (alphanumeric, underscore, hyphen only, max 20 chars) */
+    name: string;
+    /** Parameter type */
+    type: ParamType;
+    /** Whether required */
+    required: boolean;
+    /** Description (max 50 chars) */
+    description?: string;
+    /** Predefined choices (max 10) */
+    choices?: CommandChoice[];
+    /** Internationalization map */
+    nameDescI18nMap?: Record<string, CommandParamDefI18n>;
+    /** Enable auto-complete */
+    autoComplete?: boolean;
+    /** ALF description (max 1500 chars) */
+    alfDescription?: string;
+}
+/**
+ * Command definition
+ */
+export interface CommandDTO {
+    /** Command name (alphanumeric, underscore, hyphen only, 1-30 chars) */
+    name: string;
+    /** Command scope */
+    scope: CommandScope;
+    /** Button display name */
+    buttonName?: string;
+    /** Button name internationalization */
+    buttonNameI18nMap?: Record<string, CommandNameI18n>;
+    /** Description (max 100 chars) */
+    description?: string;
+    /** Name and description internationalization */
+    nameDescI18nMap?: Record<string, CommandNameDescI18n>;
+    /** Function to call when command is executed */
+    actionFunctionName: string;
+    /** Function for auto-complete suggestions */
+    autoCompleteFunctionName?: string;
+    /** ALF mode */
+    alfMode: AlfMode;
+    /** ALF description (max 1500 chars) */
+    alfDescription?: string;
+    /** Parameter definitions (max 10) */
+    paramDefinitions?: CommandParamDefinition[];
+    /** Whether enabled by default */
+    enabledByDefault?: boolean;
+}
+/**
+ * Register commands params
+ */
+export interface RegisterCommandsParams {
+    /** App ID */
+    appId: string;
+    /** Commands to register (max 30) */
+    commands: CommandDTO[];
+}
+/**
+ * Register commands result
+ */
+export interface RegisterCommandsResult {
+    /** Whether registration succeeded */
+    success: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/native/types.d.ts.map

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

package/dist/native/types.js

@@ -0,0 +1,8 @@
+/**
+ * Native Function types for ch-app-store
+ *
+ * This module contains types for PUBLIC native functions only.
+ * Public functions don't require special RBAC claims.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/native/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/native/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/nestjs/channel-app.controller.d.ts

@@ -0,0 +1,22 @@
+import { type FunctionCallRequest } from "@channel.io/app-sdk-core";
+import { ChannelAppService } from "./channel-app.service.js";
+export declare class ChannelAppController {
+    private readonly channelAppService;
+    private readonly logger;
+    constructor(channelAppService: ChannelAppService);
+    /**
+     * Versioned endpoint: PUT /functions/:version
+     * ch-app-store calls this endpoint with systemVersion (e.g., /functions/v1)
+     */
+    handleVersionedFunctions(version: string, body: FunctionCallRequest): Promise<import("@channel.io/app-sdk-core").FunctionCallResponse<unknown>>;
+    /**
+     * Legacy endpoint: POST /functions
+     * For backward compatibility
+     */
+    handleFunctions(body: FunctionCallRequest): Promise<import("@channel.io/app-sdk-core").FunctionCallResponse<unknown>>;
+    /**
+     * Common request handler
+     */
+    private handleRequest;
+}
+//# sourceMappingURL=channel-app.controller.d.ts.map

package/dist/nestjs/channel-app.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-app.controller.d.ts","sourceRoot":"","sources":["../../src/nestjs/channel-app.controller.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,qBACa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAF9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAEnC,iBAAiB,EAAE,iBAAiB;IAEjE;;;OAGG;IAEG,wBAAwB,CACV,OAAO,EAAE,MAAM,EACzB,IAAI,EAAE,mBAAmB;IAKnC;;;OAGG;IAEG,eAAe,CAAS,IAAI,EAAE,mBAAmB;IAIvD;;OAEG;YACW,aAAa;CAqC5B"}

package/dist/nestjs/channel-app.controller.js

@@ -0,0 +1,87 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ChannelAppController_1;
+import { Controller, Post, Put, Body, Param, HttpException, HttpStatus, Logger, } from "@nestjs/common";
+import { FunctionNotFoundError, ValidationError, } from "@channel.io/app-sdk-core";
+import { ChannelAppService } from "./channel-app.service.js";
+let ChannelAppController = ChannelAppController_1 = class ChannelAppController {
+    channelAppService;
+    logger = new Logger(ChannelAppController_1.name);
+    constructor(channelAppService) {
+        this.channelAppService = channelAppService;
+    }
+    /**
+     * Versioned endpoint: PUT /functions/:version
+     * ch-app-store calls this endpoint with systemVersion (e.g., /functions/v1)
+     */
+    async handleVersionedFunctions(version, body) {
+        return this.handleRequest(body, version);
+    }
+    /**
+     * Legacy endpoint: POST /functions
+     * For backward compatibility
+     */
+    async handleFunctions(body) {
+        return this.handleRequest(body);
+    }
+    /**
+     * Common request handler
+     */
+    async handleRequest(body, version) {
+        try {
+            return await this.channelAppService.handleFunctionCall(body, version);
+        }
+        catch (error) {
+            this.logger.error(`Error handling function call: ${body.method}`, error);
+            if (error instanceof FunctionNotFoundError) {
+                throw new HttpException({
+                    error: "FUNCTION_NOT_FOUND",
+                    message: error.message,
+                }, HttpStatus.NOT_FOUND);
+            }
+            if (error instanceof ValidationError) {
+                throw new HttpException({
+                    error: "VALIDATION_ERROR",
+                    message: error.message,
+                    details: error.details,
+                }, HttpStatus.BAD_REQUEST);
+            }
+            // Re-throw unexpected errors
+            throw new HttpException({
+                error: "INTERNAL_ERROR",
+                message: error instanceof Error ? error.message : "Unknown error",
+            }, HttpStatus.INTERNAL_SERVER_ERROR);
+        }
+    }
+};
+__decorate([
+    Put(":version"),
+    __param(0, Param("version")),
+    __param(1, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], ChannelAppController.prototype, "handleVersionedFunctions", null);
+__decorate([
+    Post(),
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ChannelAppController.prototype, "handleFunctions", null);
+ChannelAppController = ChannelAppController_1 = __decorate([
+    Controller("functions"),
+    __metadata("design:paramtypes", [ChannelAppService])
+], ChannelAppController);
+export { ChannelAppController };
+//# sourceMappingURL=channel-app.controller.js.map

package/dist/nestjs/channel-app.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-app.controller.js","sourceRoot":"","sources":["../../src/nestjs/channel-app.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,OAAO,EACL,UAAU,EACV,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,KAAK,EACL,aAAa,EACb,UAAU,EACV,MAAM,GACP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,qBAAqB,EACrB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGtD,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAGF;IAFZ,MAAM,GAAG,IAAI,MAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAEhE,YAA6B,iBAAoC;QAApC,sBAAiB,GAAjB,iBAAiB,CAAmB;IAAG,CAAC;IAErE;;;OAGG;IAEG,AAAN,KAAK,CAAC,wBAAwB,CACV,OAAe,EACzB,IAAyB;QAEjC,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IAEG,AAAN,KAAK,CAAC,eAAe,CAAS,IAAyB;QACrD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,IAAyB,EAAE,OAAgB;QACrE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;YAEzE,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBAC3C,MAAM,IAAI,aAAa,CACrB;oBACE,KAAK,EAAE,oBAAoB;oBAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,EACD,UAAU,CAAC,SAAS,CACrB,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,MAAM,IAAI,aAAa,CACrB;oBACE,KAAK,EAAE,kBAAkB;oBACzB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,EACD,UAAU,CAAC,WAAW,CACvB,CAAC;YACJ,CAAC;YAED,6BAA6B;YAC7B,MAAM,IAAI,aAAa,CACrB;gBACE,KAAK,EAAE,gBAAgB;gBACvB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE,EACD,UAAU,CAAC,qBAAqB,CACjC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AAxDO;IADL,GAAG,CAAC,UAAU,CAAC;IAEb,WAAA,KAAK,CAAC,SAAS,CAAC,CAAA;IAChB,WAAA,IAAI,EAAE,CAAA;;;;oEAGR;AAOK;IADL,IAAI,EAAE;IACgB,WAAA,IAAI,EAAE,CAAA;;;;2DAE5B;AAxBU,oBAAoB;IADhC,UAAU,CAAC,WAAW,CAAC;qCAI0B,iBAAiB;GAHtD,oBAAoB,CAkEhC"}

package/dist/nestjs/channel-app.module.d.ts

@@ -0,0 +1,47 @@
+import { type DynamicModule } from "@nestjs/common";
+import { type ChannelAppModuleOptions, type ChannelAppModuleAsyncOptions } from "./types.js";
+export declare class ChannelAppModule {
+    /**
+     * Register the module with static options
+     *
+     * @example
+     * ```typescript
+     * // Using decorator-based extensions (recommended)
+     * @Module({
+     *   imports: [
+     *     ChannelAppModule.forRoot({
+     *       appId: process.env.APP_ID,
+     *       appSecret: process.env.APP_SECRET,
+     *     }),
+     *   ],
+     *   providers: [CalendarExtension], // Your @Extension decorated classes
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRoot(options: ChannelAppModuleOptions): DynamicModule;
+    /**
+     * Register the module with async options (for dependency injection)
+     *
+     * @example
+     * ```typescript
+     * @Module({
+     *   imports: [
+     *     ConfigModule,
+     *     ChannelAppModule.forRootAsync({
+     *       imports: [ConfigModule],
+     *       inject: [ConfigService],
+     *       useFactory: (config: ConfigService) => ({
+     *         appId: config.get('APP_ID'),
+     *         appSecret: config.get('APP_SECRET'),
+     *       }),
+     *     }),
+     *   ],
+     *   providers: [CalendarExtension], // Your @Extension decorated classes
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRootAsync(options: ChannelAppModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=channel-app.module.d.ts.map

package/dist/nestjs/channel-app.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-app.module.d.ts","sourceRoot":"","sources":["../../src/nestjs/channel-app.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAyB,MAAM,gBAAgB,CAAC;AAK3E,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAElC,MAAM,YAAY,CAAC;AAEpB,qBACa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa;IAkB/D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,4BAA4B,GAAG,aAAa;CAkB1E"}

package/dist/nestjs/channel-app.module.js

@@ -0,0 +1,93 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ChannelAppModule_1;
+import { Module } from "@nestjs/common";
+import { DiscoveryModule } from "@nestjs/core";
+import { ChannelAppController } from "./channel-app.controller.js";
+import { ChannelAppService } from "./channel-app.service.js";
+import { ExtensionDiscoveryService } from "../discovery/extension-discovery.service.js";
+import { CHANNEL_APP_OPTIONS, } from "./types.js";
+let ChannelAppModule = ChannelAppModule_1 = class ChannelAppModule {
+    /**
+     * Register the module with static options
+     *
+     * @example
+     * ```typescript
+     * // Using decorator-based extensions (recommended)
+     * @Module({
+     *   imports: [
+     *     ChannelAppModule.forRoot({
+     *       appId: process.env.APP_ID,
+     *       appSecret: process.env.APP_SECRET,
+     *     }),
+     *   ],
+     *   providers: [CalendarExtension], // Your @Extension decorated classes
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRoot(options) {
+        return {
+            module: ChannelAppModule_1,
+            imports: [DiscoveryModule],
+            controllers: [ChannelAppController],
+            providers: [
+                {
+                    provide: CHANNEL_APP_OPTIONS,
+                    useValue: options,
+                },
+                ExtensionDiscoveryService,
+                ChannelAppService,
+            ],
+            exports: [ChannelAppService, ExtensionDiscoveryService],
+            global: true,
+        };
+    }
+    /**
+     * Register the module with async options (for dependency injection)
+     *
+     * @example
+     * ```typescript
+     * @Module({
+     *   imports: [
+     *     ConfigModule,
+     *     ChannelAppModule.forRootAsync({
+     *       imports: [ConfigModule],
+     *       inject: [ConfigService],
+     *       useFactory: (config: ConfigService) => ({
+     *         appId: config.get('APP_ID'),
+     *         appSecret: config.get('APP_SECRET'),
+     *       }),
+     *     }),
+     *   ],
+     *   providers: [CalendarExtension], // Your @Extension decorated classes
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRootAsync(options) {
+        const asyncProvider = {
+            provide: CHANNEL_APP_OPTIONS,
+            useFactory: options.useFactory,
+            inject: options.inject ?? [],
+        };
+        const result = {
+            module: ChannelAppModule_1,
+            imports: [DiscoveryModule, ...(options.imports ?? [])],
+            controllers: [ChannelAppController],
+            providers: [asyncProvider, ExtensionDiscoveryService, ChannelAppService],
+            exports: [ChannelAppService, ExtensionDiscoveryService],
+            global: true,
+        };
+        return result;
+    }
+};
+ChannelAppModule = ChannelAppModule_1 = __decorate([
+    Module({})
+], ChannelAppModule);
+export { ChannelAppModule };
+//# sourceMappingURL=channel-app.module.js.map

package/dist/nestjs/channel-app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-app.module.js","sourceRoot":"","sources":["../../src/nestjs/channel-app.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAiB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAGL,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGb,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAgC;QAC7C,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,OAAO,EAAE,CAAC,eAAe,CAAC;YAC1B,WAAW,EAAE,CAAC,oBAAoB,CAAC;YACnC,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,mBAAmB;oBAC5B,QAAQ,EAAE,OAAO;iBAClB;gBACD,yBAAyB;gBACzB,iBAAiB;aAClB;YACD,OAAO,EAAE,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;YACvD,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAqC;QACvD,MAAM,aAAa,GAAa;YAC9B,OAAO,EAAE,mBAAmB;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;QAEF,MAAM,MAAM,GAAkB;YAC5B,MAAM,EAAE,kBAAgB;YACxB,OAAO,EAAE,CAAC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACtD,WAAW,EAAE,CAAC,oBAAoB,CAAC;YACnC,SAAS,EAAE,CAAC,aAAa,EAAE,yBAAyB,EAAE,iBAAiB,CAAC;YACxE,OAAO,EAAE,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;YACvD,MAAM,EAAE,IAAI;SACb,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAA;AA7EY,gBAAgB;IAD5B,MAAM,CAAC,EAAE,CAAC;GACE,gBAAgB,CA6E5B"}

package/dist/nestjs/channel-app.service.d.ts

@@ -0,0 +1,44 @@
+import { type OnModuleInit } from "@nestjs/common";
+import { type FunctionCallRequest, type FunctionCallResponse, type GetFunctionsResponse } from "@channel.io/app-sdk-core";
+import { type ChannelAppModuleOptions } from "./types.js";
+import { ExtensionDiscoveryService } from "../discovery/extension-discovery.service.js";
+/**
+ * Version mismatch error for when a function call targets the wrong version
+ */
+export declare class VersionMismatchError extends Error {
+    readonly requestedVersion: string;
+    readonly availableVersions: string[];
+    constructor(requestedVersion: string, availableVersions: string[]);
+}
+export declare class ChannelAppService implements OnModuleInit {
+    private readonly options;
+    private readonly discoveryService?;
+    private readonly logger;
+    constructor(options: ChannelAppModuleOptions, discoveryService?: ExtensionDiscoveryService | undefined);
+    onModuleInit(): Promise<void>;
+    /**
+     * Auto-register all extensions with the AppStore
+     */
+    private autoRegisterExtensions;
+    /**
+     * Get all registered versions
+     */
+    getRegisteredVersions(): string[];
+    /**
+     * Handle incoming function call
+     * @param request The function call request
+     * @param _version Optional version from URL path (e.g., "v1")
+     */
+    handleFunctionCall(request: FunctionCallRequest, _version?: string): Promise<FunctionCallResponse>;
+    /**
+     * Get list of all registered functions
+     */
+    getFunctions(): GetFunctionsResponse;
+    /**
+     * Get app configuration
+     */
+    getAppConfig(): {
+        appId: string;
+    };
+}
+//# sourceMappingURL=channel-app.service.d.ts.map

package/dist/nestjs/channel-app.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-app.service.d.ts","sourceRoot":"","sources":["../../src/nestjs/channel-app.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AACzF,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAE1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,gBAAgB,EAAE,MAAM;aACxB,iBAAiB,EAAE,MAAM,EAAE;gBAD3B,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,EAAE;CAO9C;AAED,qBACa,iBAAkB,YAAW,YAAY;IAKlD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IANpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAI1C,OAAO,EAAE,uBAAuB,EAEhC,gBAAgB,CAAC,EAAE,yBAAyB,YAAA;IAGzD,YAAY;IAwBlB;;OAEG;YACW,sBAAsB;IAwDpC;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAWjC;;;;OAIG;IACG,kBAAkB,CACtB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC;IAyBhC;;OAEG;IACH,YAAY,IAAI,oBAAoB;IA6BpC;;OAEG;IACH,YAAY;;;CAKb"}