@channel.io/app-sdk-core 0.1.0

package/dist/extensions/interfaces/calendar.d.ts

@@ -0,0 +1,153 @@
+import type { Calendar, EventType, TimeSlot, Attendee, Booking } from "../calendar.js";
+import type { ExtensionContext } from "./oauth.js";
+/**
+ * Calendar Extension Input Types
+ */
+export interface ListCalendarsInput {
+    /** Optional page token for pagination */
+    pageToken?: string;
+}
+export interface ListCalendarsOutput {
+    calendars: Calendar[];
+    nextPageToken?: string;
+}
+export interface ListEventTypesInput {
+    /** Optional calendar ID to filter event types */
+    calendarId?: string;
+}
+export interface ListEventTypesOutput {
+    eventTypes: EventType[];
+}
+export interface GetAvailabilityInput {
+    /** Event type ID to check availability for */
+    eventTypeId: string;
+    /** Start date in ISO format (e.g., "2024-01-01") */
+    startDate: string;
+    /** End date in ISO format (e.g., "2024-01-31") */
+    endDate: string;
+    /** Optional timezone (e.g., "America/New_York") */
+    timezone?: string;
+}
+export interface GetAvailabilityOutput {
+    /** Available time slots */
+    slots: TimeSlot[];
+}
+export interface CreateBookingInput {
+    /** Event type ID to book */
+    eventTypeId: string;
+    /** Start time in ISO format */
+    startTime: string;
+    /** Attendee information */
+    attendee: Attendee;
+    /** Optional notes for the booking */
+    notes?: string;
+    /** Optional timezone */
+    timezone?: string;
+}
+export interface CancelBookingInput {
+    /** Booking ID to cancel */
+    bookingId: string;
+    /** Optional cancellation reason */
+    reason?: string;
+}
+export interface CancelBookingOutput {
+    /** Whether the cancellation was successful */
+    success: boolean;
+    /** Updated booking (if available) */
+    booking?: Booking;
+}
+export interface GetBookingInput {
+    /** Booking ID to retrieve */
+    bookingId: string;
+}
+/**
+ * Calendar Extension Interface
+ *
+ * Implement this interface to create a calendar/scheduling extension.
+ *
+ * @example
+ * ```typescript
+ * @Extension({ name: "calendar", systemVersion: "v1" })
+ * export class MyCalendarExtension implements CalendarExtensionInterface {
+ *   @Func("calendar.listCalendars")
+ *   async listCalendars(ctx, params): Promise<ListCalendarsOutput> {
+ *     return { calendars: [...] };
+ *   }
+ *
+ *   @Func("calendar.listEventTypes")
+ *   async listEventTypes(ctx, params): Promise<ListEventTypesOutput> {
+ *     return { eventTypes: [...] };
+ *   }
+ *
+ *   @Func("calendar.getAvailability")
+ *   async getAvailability(ctx, params): Promise<GetAvailabilityOutput> {
+ *     return { slots: [...] };
+ *   }
+ *
+ *   @Func("calendar.createBooking")
+ *   async createBooking(ctx, params): Promise<Booking> {
+ *     return { id: "...", ... };
+ *   }
+ *
+ *   @Func("calendar.cancelBooking")
+ *   async cancelBooking(ctx, params): Promise<CancelBookingOutput> {
+ *     return { success: true };
+ *   }
+ *
+ *   @Func("calendar.getBooking")
+ *   async getBooking(ctx, params): Promise<Booking> {
+ *     return { id: "...", ... };
+ *   }
+ * }
+ * ```
+ */
+export interface CalendarExtensionInterface {
+    /**
+     * List available calendars
+     *
+     * Function name: "calendar.listCalendars"
+     */
+    listCalendars(ctx: ExtensionContext, params: ListCalendarsInput): Promise<ListCalendarsOutput>;
+    /**
+     * List event types (meeting types)
+     *
+     * Function name: "calendar.listEventTypes"
+     */
+    listEventTypes(ctx: ExtensionContext, params: ListEventTypesInput): Promise<ListEventTypesOutput>;
+    /**
+     * Get available time slots for booking
+     *
+     * Function name: "calendar.getAvailability"
+     */
+    getAvailability(ctx: ExtensionContext, params: GetAvailabilityInput): Promise<GetAvailabilityOutput>;
+    /**
+     * Create a new booking
+     *
+     * Function name: "calendar.createBooking"
+     */
+    createBooking(ctx: ExtensionContext, params: CreateBookingInput): Promise<Booking>;
+    /**
+     * Cancel an existing booking
+     *
+     * Function name: "calendar.cancelBooking"
+     */
+    cancelBooking(ctx: ExtensionContext, params: CancelBookingInput): Promise<CancelBookingOutput>;
+    /**
+     * Get booking details
+     *
+     * Function name: "calendar.getBooking"
+     */
+    getBooking(ctx: ExtensionContext, params: GetBookingInput): Promise<Booking>;
+}
+/**
+ * Calendar Extension Function Names
+ */
+export declare const CalendarFunctionNames: {
+    readonly listCalendars: "calendar.listCalendars";
+    readonly listEventTypes: "calendar.listEventTypes";
+    readonly getAvailability: "calendar.getAvailability";
+    readonly createBooking: "calendar.createBooking";
+    readonly cancelBooking: "calendar.cancelBooking";
+    readonly getBooking: "calendar.getBooking";
+};
+//# sourceMappingURL=calendar.d.ts.map

package/dist/extensions/interfaces/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/extensions/interfaces/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/F;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAElG;;;;OAIG;IACH,eAAe,CACb,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAElC;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnF;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/F;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;CAOxB,CAAC"}

package/dist/extensions/interfaces/calendar.js

@@ -0,0 +1,12 @@
+/**
+ * Calendar Extension Function Names
+ */
+export const CalendarFunctionNames = {
+    listCalendars: "calendar.listCalendars",
+    listEventTypes: "calendar.listEventTypes",
+    getAvailability: "calendar.getAvailability",
+    createBooking: "calendar.createBooking",
+    cancelBooking: "calendar.cancelBooking",
+    getBooking: "calendar.getBooking",
+};
+//# sourceMappingURL=calendar.js.map

package/dist/extensions/interfaces/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../../src/extensions/interfaces/calendar.ts"],"names":[],"mappings":"AAiKA;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,aAAa,EAAE,wBAAwB;IACvC,cAAc,EAAE,yBAAyB;IACzC,eAAe,EAAE,0BAA0B;IAC3C,aAAa,EAAE,wBAAwB;IACvC,aAAa,EAAE,wBAAwB;IACvC,UAAU,EAAE,qBAAqB;CACzB,CAAC"}

package/dist/extensions/interfaces/command.d.ts

@@ -0,0 +1,92 @@
+import type { CommandSuggestion, CommandResult } from "../command.js";
+import type { ExtensionContext } from "./oauth.js";
+/**
+ * Command Extension Input Types
+ */
+export interface GetSuggestionsInput {
+    /** Current command input text (e.g., "/schedule " -> "schedule ") */
+    query: string;
+    /** Chat ID where the command is being used */
+    chatId?: string;
+    /** User ID who is typing the command */
+    userId?: string;
+}
+export interface GetSuggestionsOutput {
+    /** List of command suggestions */
+    suggestions: CommandSuggestion[];
+}
+export interface ExecuteCommandInput {
+    /** Command name (e.g., "schedule") */
+    command: string;
+    /** Arguments passed to the command */
+    args: string[];
+    /** Raw command text */
+    rawText?: string;
+    /** Chat ID where the command was executed */
+    chatId?: string;
+    /** User ID who executed the command */
+    userId?: string;
+}
+/**
+ * Command Extension Interface
+ *
+ * Implement this interface to create a slash command extension.
+ *
+ * @example
+ * ```typescript
+ * @Extension({ name: "command", systemVersion: "v1" })
+ * export class MyCommandExtension implements CommandExtensionInterface {
+ *   @Func("command.getSuggestions")
+ *   @InputSchema(GetSuggestionsInputSchema)
+ *   @OutputSchema(GetSuggestionsOutputSchema)
+ *   async getSuggestions(ctx, params): Promise<GetSuggestionsOutput> {
+ *     if (params.query.startsWith("meet")) {
+ *       return {
+ *         suggestions: [
+ *           { value: "meeting", label: "/meeting", description: "Schedule a meeting" },
+ *         ],
+ *       };
+ *     }
+ *     return { suggestions: [] };
+ *   }
+ *
+ *   @Func("command.execute")
+ *   @InputSchema(ExecuteCommandInputSchema)
+ *   @OutputSchema(CommandResultSchema)
+ *   async execute(ctx, params): Promise<CommandResult> {
+ *     if (params.command === "meeting") {
+ *       return {
+ *         action: "openWam",
+ *         wamName: "meeting-scheduler",
+ *         wamParams: { chatId: params.chatId },
+ *       };
+ *     }
+ *     return { action: "none" };
+ *   }
+ * }
+ * ```
+ */
+export interface CommandExtensionInterface {
+    /**
+     * Get command suggestions as user types
+     *
+     * Function name: "command.getSuggestions"
+     */
+    getSuggestions(ctx: ExtensionContext, params: GetSuggestionsInput): Promise<GetSuggestionsOutput>;
+    /**
+     * Execute a command
+     *
+     * Function name: "command.execute"
+     *
+     * @returns Action to perform (sendMessage, insertText, openWam, openUrl, or none)
+     */
+    execute(ctx: ExtensionContext, params: ExecuteCommandInput): Promise<CommandResult>;
+}
+/**
+ * Command Extension Function Names
+ */
+export declare const CommandFunctionNames: {
+    readonly getSuggestions: "command.getSuggestions";
+    readonly execute: "command.execute";
+};
+//# sourceMappingURL=command.d.ts.map

package/dist/extensions/interfaces/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/extensions/interfaces/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAElG;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACrF;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC"}

package/dist/extensions/interfaces/command.js

@@ -0,0 +1,8 @@
+/**
+ * Command Extension Function Names
+ */
+export const CommandFunctionNames = {
+    getSuggestions: "command.getSuggestions",
+    execute: "command.execute",
+};
+//# sourceMappingURL=command.js.map

package/dist/extensions/interfaces/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/extensions/interfaces/command.ts"],"names":[],"mappings":"AA0FA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,wBAAwB;IACxC,OAAO,EAAE,iBAAiB;CAClB,CAAC"}

package/dist/extensions/interfaces/customtab.d.ts

@@ -0,0 +1,82 @@
+import type { CustomTabConfig, CustomTabContent } from "../customtab.js";
+import type { ExtensionContext } from "./oauth.js";
+/**
+ * Custom Tab Extension Input Types
+ */
+export interface GetTabConfigInput {
+    /** Optional tab ID to get specific tab config */
+    tabId?: string;
+}
+export interface GetTabConfigOutput {
+    /** Tab configurations */
+    tabs: CustomTabConfig[];
+}
+export interface GetTabContentInput {
+    /** Tab ID */
+    tabId: string;
+    /** User chat ID (if opened from a chat) */
+    chatId?: string;
+    /** User ID */
+    userId?: string;
+}
+/**
+ * Custom Tab Extension Interface
+ *
+ * Implement this interface to create a custom tab in Desk.
+ *
+ * @example
+ * ```typescript
+ * @Extension({ name: "customtab", systemVersion: "v1" })
+ * export class MyCustomTabExtension implements CustomTabExtensionInterface {
+ *   @Func("customtab.getConfig")
+ *   async getConfig(ctx, params): Promise<GetTabConfigOutput> {
+ *     return {
+ *       tabs: [
+ *         {
+ *           name: "Analytics",
+ *           nameI18nMap: {
+ *             ko: { name: "분석" },
+ *             ja: { name: "分析" },
+ *           },
+ *           icon: "chart",
+ *         },
+ *       ],
+ *     };
+ *   }
+ *
+ *   @Func("customtab.getContent")
+ *   async getContent(ctx, params): Promise<CustomTabContent> {
+ *     return {
+ *       wamName: "analytics-dashboard",
+ *       wamParams: { userId: params.userId },
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface CustomTabExtensionInterface {
+    /**
+     * Get custom tab configuration
+     *
+     * Function name: "customtab.getConfig"
+     *
+     * @returns List of tab configurations
+     */
+    getConfig(ctx: ExtensionContext, params: GetTabConfigInput): Promise<GetTabConfigOutput>;
+    /**
+     * Get content for a specific tab
+     *
+     * Function name: "customtab.getContent"
+     *
+     * @returns WAM name and params to render in the tab
+     */
+    getContent(ctx: ExtensionContext, params: GetTabContentInput): Promise<CustomTabContent>;
+}
+/**
+ * Custom Tab Extension Function Names
+ */
+export declare const CustomTabFunctionNames: {
+    readonly getConfig: "customtab.getConfig";
+    readonly getContent: "customtab.getContent";
+};
+//# sourceMappingURL=customtab.d.ts.map

package/dist/extensions/interfaces/customtab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customtab.d.ts","sourceRoot":"","sources":["../../../src/extensions/interfaces/customtab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEzF;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1F;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC"}

package/dist/extensions/interfaces/customtab.js

@@ -0,0 +1,8 @@
+/**
+ * Custom Tab Extension Function Names
+ */
+export const CustomTabFunctionNames = {
+    getConfig: "customtab.getConfig",
+    getContent: "customtab.getContent",
+};
+//# sourceMappingURL=customtab.js.map

package/dist/extensions/interfaces/customtab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customtab.js","sourceRoot":"","sources":["../../../src/extensions/interfaces/customtab.ts"],"names":[],"mappings":"AAgFA;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,qBAAqB;IAChC,UAAU,EAAE,sBAAsB;CAC1B,CAAC"}

package/dist/extensions/interfaces/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Extension Function Interfaces
+ *
+ * These interfaces define the required function signatures for each extension type.
+ * Use these as a guide when implementing your extension classes.
+ *
+ * @example
+ * ```typescript
+ * import { Extension, Func, Ctx, Input, InputSchema, OutputSchema } from "@channel.io/app-sdk-server";
+ * import type { CalendarExtensionInterface } from "@channel.io/app-sdk-core";
+ *
+ * @Extension({ name: "calendar", systemVersion: "v1" })
+ * export class MyCalendarExtension implements CalendarExtensionInterface {
+ *   // IDE will show required methods and their signatures
+ * }
+ * ```
+ */
+export * from "./oauth.js";
+export * from "./apikey.js";
+export * from "./calendar.js";
+export * from "./command.js";
+export * from "./widget.js";
+export * from "./customtab.js";
+export * from "./alftask.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/extensions/interfaces/index.js

@@ -0,0 +1,25 @@
+/**
+ * Extension Function Interfaces
+ *
+ * These interfaces define the required function signatures for each extension type.
+ * Use these as a guide when implementing your extension classes.
+ *
+ * @example
+ * ```typescript
+ * import { Extension, Func, Ctx, Input, InputSchema, OutputSchema } from "@channel.io/app-sdk-server";
+ * import type { CalendarExtensionInterface } from "@channel.io/app-sdk-core";
+ *
+ * @Extension({ name: "calendar", systemVersion: "v1" })
+ * export class MyCalendarExtension implements CalendarExtensionInterface {
+ *   // IDE will show required methods and their signatures
+ * }
+ * ```
+ */
+export * from "./oauth.js";
+export * from "./apikey.js";
+export * from "./calendar.js";
+export * from "./command.js";
+export * from "./widget.js";
+export * from "./customtab.js";
+export * from "./alftask.js";
+//# sourceMappingURL=index.js.map

package/dist/extensions/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/extensions/interfaces/oauth.d.ts

@@ -0,0 +1,78 @@
+import type { OAuthConfig, CredentialValidationResult } from "../oauth.js";
+/**
+ * Base context for all extension functions
+ */
+export interface ExtensionContext {
+    channel: {
+        id: string;
+    };
+    caller: {
+        type: "user" | "manager" | "system";
+        id: string;
+    };
+    authToken?: string;
+    apiCredentials?: Record<string, string>;
+}
+/**
+ * OAuth Extension Interface
+ *
+ * Implement this interface to create an OAuth-based authentication extension.
+ *
+ * @example
+ * ```typescript
+ * @Extension({ name: "oauth", systemVersion: "v1" })
+ * export class MyOAuthExtension implements OAuthExtensionInterface {
+ *   @Func("oauth.getConfig")
+ *   @OutputSchema(OAuthConfigSchema)
+ *   async getConfig(ctx: ExtensionContext): Promise<OAuthConfig> {
+ *     return {
+ *       authorizationUrl: "https://example.com/oauth/authorize",
+ *       tokenUrl: "https://example.com/oauth/token",
+ *       scopes: ["read", "write"],
+ *       clientId: "your-client-id",
+ *     };
+ *   }
+ *
+ *   @Func("oauth.validateCredential")
+ *   @InputSchema(ValidateCredentialInputSchema)
+ *   @OutputSchema(CredentialValidationResultSchema)
+ *   async validateCredential(
+ *     ctx: ExtensionContext,
+ *     params: { accessToken: string }
+ *   ): Promise<CredentialValidationResult> {
+ *     // Validate the access token
+ *     return { valid: true };
+ *   }
+ * }
+ * ```
+ */
+export interface OAuthExtensionInterface {
+    /**
+     * Get OAuth configuration for authorization flow
+     *
+     * Function name: "oauth.getConfig"
+     *
+     * @returns OAuth configuration including authorization URL, token URL, and scopes
+     */
+    getConfig(ctx: ExtensionContext): Promise<OAuthConfig>;
+    /**
+     * Validate an OAuth credential (access token)
+     *
+     * Function name: "oauth.validateCredential"
+     *
+     * @param ctx - Extension context
+     * @param params - Contains the access token to validate
+     * @returns Validation result with expiration info
+     */
+    validateCredential(ctx: ExtensionContext, params: {
+        accessToken: string;
+    }): Promise<CredentialValidationResult>;
+}
+/**
+ * OAuth Extension Function Names
+ */
+export declare const OAuthFunctionNames: {
+    readonly getConfig: "oauth.getConfig";
+    readonly validateCredential: "oauth.validateCredential";
+};
+//# sourceMappingURL=oauth.d.ts.map

package/dist/extensions/interfaces/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/extensions/interfaces/oauth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEvD;;;;;;;;OAQG;IACH,kBAAkB,CAChB,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAC9B,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC"}

package/dist/extensions/interfaces/oauth.js

@@ -0,0 +1,8 @@
+/**
+ * OAuth Extension Function Names
+ */
+export const OAuthFunctionNames = {
+    getConfig: "oauth.getConfig",
+    validateCredential: "oauth.validateCredential",
+};
+//# sourceMappingURL=oauth.js.map

package/dist/extensions/interfaces/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/extensions/interfaces/oauth.ts"],"names":[],"mappings":"AAsEA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,iBAAiB;IAC5B,kBAAkB,EAAE,0BAA0B;CACtC,CAAC"}

package/dist/extensions/interfaces/widget.d.ts

@@ -0,0 +1,87 @@
+import type { WidgetConfig, WidgetActionResult } from "../widget.js";
+import type { ExtensionContext } from "./oauth.js";
+/**
+ * Widget Extension Input Types
+ */
+export interface GetWidgetConfigInput {
+    /** Widget ID */
+    widgetId?: string;
+    /** Scope where widget is displayed ("front" or "desk") */
+    scope?: "front" | "desk";
+}
+export interface GetWidgetConfigOutput {
+    /** Widget configurations */
+    widgets: WidgetConfig[];
+}
+export interface WidgetActionInput {
+    /** Widget ID */
+    widgetId: string;
+    /** Action name */
+    action: string;
+    /** Action parameters */
+    params?: Record<string, unknown>;
+    /** User ID who triggered the action */
+    userId?: string;
+    /** Chat ID where the action was triggered (if applicable) */
+    chatId?: string;
+}
+/**
+ * Widget Extension Interface
+ *
+ * Implement this interface to create a widget extension for Front or Desk.
+ *
+ * @example
+ * ```typescript
+ * @Extension({ name: "widget", systemVersion: "v1" })
+ * export class MyWidgetExtension implements WidgetExtensionInterface {
+ *   @Func("widget.getConfig")
+ *   async getConfig(ctx, params): Promise<GetWidgetConfigOutput> {
+ *     return {
+ *       widgets: [
+ *         {
+ *           name: "Quick Actions",
+ *           description: "Frequently used actions",
+ *           scope: "desk",
+ *           widgetType: "wam",
+ *         },
+ *       ],
+ *     };
+ *   }
+ *
+ *   @Func("widget.action")
+ *   async action(ctx, params): Promise<WidgetActionResult> {
+ *     if (params.action === "refresh") {
+ *       // Handle refresh action
+ *       return { success: true, message: "Refreshed" };
+ *     }
+ *     return { success: false, message: "Unknown action" };
+ *   }
+ * }
+ * ```
+ */
+export interface WidgetExtensionInterface {
+    /**
+     * Get widget configuration
+     *
+     * Function name: "widget.getConfig"
+     *
+     * @returns List of widget configurations
+     */
+    getConfig(ctx: ExtensionContext, params: GetWidgetConfigInput): Promise<GetWidgetConfigOutput>;
+    /**
+     * Handle widget action
+     *
+     * Function name: "widget.action"
+     *
+     * @returns Action result with success status
+     */
+    action(ctx: ExtensionContext, params: WidgetActionInput): Promise<WidgetActionResult>;
+}
+/**
+ * Widget Extension Function Names
+ */
+export declare const WidgetFunctionNames: {
+    readonly getConfig: "widget.getConfig";
+    readonly action: "widget.action";
+};
+//# sourceMappingURL=widget.d.ts.map

package/dist/extensions/interfaces/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../../../src/extensions/interfaces/widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE/F;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC"}

package/dist/extensions/interfaces/widget.js

@@ -0,0 +1,8 @@
+/**
+ * Widget Extension Function Names
+ */
+export const WidgetFunctionNames = {
+    getConfig: "widget.getConfig",
+    action: "widget.action",
+};
+//# sourceMappingURL=widget.js.map

package/dist/extensions/interfaces/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../../../src/extensions/interfaces/widget.ts"],"names":[],"mappings":"AAqFA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,kBAAkB;IAC7B,MAAM,EAAE,eAAe;CACf,CAAC"}