@krischoichoi/channel-lark 0.6.0

package/lib/outbound.js

@@ -0,0 +1,93 @@
+import { ChannelSendError } from '@krischoichoi/channel-core';
+import { toTextPayload } from './mapper.js';
+export class OutboundSender {
+    upstream;
+    logger;
+    interactiveCards = new Map();
+    constructor(upstream, logger) {
+        this.upstream = upstream;
+        this.logger = logger;
+    }
+    async send(target, message) {
+        try {
+            if (message.actions?.length) {
+                const payload = toTextPayload(target, message);
+                const response = await this.upstream.sendInteractive(payload.to, payload.content, message.actions);
+                const messageId = messageIdOf(response);
+                if (messageId)
+                    this.interactiveCards.set(messageId, { text: payload.content });
+                return { delivered: true, messageId, raw: response };
+            }
+            const file = firstFileWithData(message.parts);
+            if (file && !message.text) {
+                const response = await this.upstream.sendFile(target.conversationId, toFileRef(file));
+                return { delivered: true, raw: response };
+            }
+            const image = firstImage(message.parts);
+            if (image && !message.text) {
+                const response = await this.upstream.sendMedia(target.conversationId, image);
+                return { delivered: true, raw: response };
+            }
+            const payload = toTextPayload(target, message);
+            const response = await this.upstream.sendText(payload.to, payload.content);
+            return { delivered: true, raw: response };
+        }
+        catch (error) {
+            this.logger.error('[channel-lark] send failed to ' + target.conversationId, error instanceof Error ? error.message : error);
+            throw new ChannelSendError('lark send failed: ' + (error instanceof Error ? error.message : String(error)));
+        }
+    }
+    async edit(target, messageId, message) {
+        try {
+            if (message.actions === undefined && message.text === undefined)
+                return { delivered: true };
+            const known = this.interactiveCards.get(messageId);
+            if (!known) {
+                throw new ChannelSendError('lark cannot edit an interactive card that was not sent by this adapter');
+            }
+            const text = message.text ?? known.text;
+            const actions = message.actions ?? [];
+            const response = await this.upstream.updateInteractive(messageId, text, actions);
+            this.interactiveCards.set(messageId, { text });
+            return { delivered: true, messageId, raw: response };
+        }
+        catch (error) {
+            this.logger.error('[channel-lark] interactive card edit failed for ' + target.conversationId, error instanceof Error ? error.message : error);
+            throw new ChannelSendError('lark interactive card edit failed: ' + (error instanceof Error ? error.message : String(error)));
+        }
+    }
+}
+function messageIdOf(response) {
+    if (!response || typeof response !== 'object')
+        return undefined;
+    const data = response.data;
+    if (!data || typeof data !== 'object')
+        return undefined;
+    const messageId = data.message_id;
+    return typeof messageId === 'string' && messageId.length > 0 ? messageId : undefined;
+}
+/**
+ * The first file part that already carries trusted bytes (localData). A file
+ * part without bytes is not in a state the official outbound can send yet
+ * (no re-download here), so it falls through to the text path.
+ */
+function firstFileWithData(parts) {
+    if (!parts)
+        return undefined;
+    return parts.find((part) => part.type === 'file' && part.localData !== undefined);
+}
+/** Shape a hydrated FilePart into the outbound LarkFileRef. */
+function toFileRef(file) {
+    return {
+        type: 'file',
+        localData: file.localData,
+        name: file.name,
+        mimeType: file.mimeType,
+    };
+}
+function firstImage(parts) {
+    if (!parts)
+        return undefined;
+    return parts.find((part) => part.type === 'image');
+}
+//# sourceMappingURL=outbound.js.map

package/lib/outbound.js.map

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

package/lib/upstream/media-port.d.ts

@@ -0,0 +1,154 @@
+/** Official per-resource limit, also enforced locally while reading. */
+export declare const LARK_MESSAGE_RESOURCE_MAX_BYTES: number;
+/** The four binary resource kinds the official message.resource API resolves. */
+export type LarkResourceType = 'image' | 'file' | 'audio' | 'video';
+/** Minimal im.v1.messageResource.get payload/result shapes consumed here. */
+export interface LarkMessageResourceGetPayload {
+    params: {
+        type: LarkResourceType | string;
+    };
+    path: {
+        message_id: string;
+        file_key: string;
+    };
+}
+/** The binary-stream result the official SDK returns for resource downloads. */
+export interface LarkMessageResourceResult {
+    /** Persist the downloaded resource to a local file path. */
+    writeFile?(filePath: string): Promise<unknown>;
+    /** The downloaded resource as a Node readable stream. */
+    getReadableStream(): import('node:stream').Readable;
+    /** Response headers (may carry content-type / content-disposition). */
+    headers?: Record<string, unknown>;
+}
+/** Minimal im.v1.image.get payload shape (image download). */
+export interface LarkImageGetPayload {
+    path: {
+        image_key: string;
+    };
+}
+/** Minimal im.v1.image.create payload/result shapes. */
+export interface LarkImageCreatePayload {
+    data: {
+        image_type: 'message' | 'avatar';
+        image: Uint8Array;
+    };
+}
+export interface LarkImageCreateResult {
+    image_key?: string;
+}
+/** Minimal im.v1.file.create payload/result shapes. */
+export interface LarkFileCreatePayload {
+    data: {
+        file_type: 'opus' | 'mp4' | 'pdf' | 'doc' | 'xls' | 'ppt' | 'stream';
+        file_name: string;
+        duration?: number;
+        file: Uint8Array;
+    };
+}
+export interface LarkFileCreateResult {
+    file_key?: string;
+}
+/**
+ * Structural subset of the official SDK Client required by the media port.
+ * The real Client (1.73.1) satisfies this shape; tests inject a fake.
+ * Mirrors the LarkOpenApiClient pattern from openapi-outbound.ts.
+ */
+export interface LarkMediaClient {
+    im: {
+        v1: {
+            messageResource: {
+                get(payload: LarkMessageResourceGetPayload): Promise<LarkMessageResourceResult>;
+            };
+            image: {
+                create(payload: LarkImageCreatePayload): Promise<LarkImageCreateResult | null>;
+            };
+            file: {
+                create(payload: LarkFileCreatePayload): Promise<LarkFileCreateResult | null>;
+            };
+        };
+    };
+}
+/**
+ * Media port contract (plan section 26). The adapter depends on this
+ * interface so it is fully injectable in offline tests.
+ */
+export interface LarkMediaPort {
+    /**
+     * Download a resource (image/file/audio/video) embedded in a message.
+     * resourceKey is the platform image_key/file_key (a resourceRef), resolved
+     * via the official messageResource.get against the owning messageId. The
+     * per-kind `type` mirrors the resource kind the official API documents for
+     * audio/video downloads (plan section 23-A4).
+     */
+    downloadMessageResource(input: {
+        messageId: string;
+        resourceKey: string;
+        type: LarkResourceType;
+        signal?: AbortSignal;
+        /** Hard cap enforced while consuming the SDK stream. */
+        maxBytes?: number;
+    }): Promise<{
+        data: Uint8Array;
+        mimeType?: string;
+        name?: string;
+    }>;
+    /** Upload an image; returns the platform image_key. */
+    uploadImage(input: {
+        data: Uint8Array;
+        signal?: AbortSignal;
+    }): Promise<{
+        imageKey: string;
+    }>;
+    /** Upload a generic file; returns the platform file_key. */
+    uploadFile(input: {
+        data: Uint8Array;
+        name: string;
+        fileType: 'opus' | 'mp4' | 'pdf' | 'doc' | 'xls' | 'ppt' | 'stream';
+        durationMs?: number;
+        signal?: AbortSignal;
+    }): Promise<{
+        fileKey: string;
+    }>;
+}
+export interface LarkMediaPortOptions {
+    /** Official OpenAPI client (real Client or injected fake). */
+    client: LarkMediaClient;
+}
+/**
+ * Official-SDK implementation of the media port. downloadMessageResource is
+ * the M2A image-ingress surface; uploadImage/uploadFile are declared now and
+ * implemented via the official image/file clients so the later outbound-media
+ * milestone (M7A) can reuse them.
+ */
+export declare class LarkOpenApiMediaPort implements LarkMediaPort {
+    private readonly options;
+    constructor(options: LarkMediaPortOptions);
+    downloadMessageResource(input: {
+        messageId: string;
+        resourceKey: string;
+        type: LarkResourceType;
+        signal?: AbortSignal;
+        maxBytes?: number;
+    }): Promise<{
+        data: Uint8Array;
+        mimeType?: string;
+        name?: string;
+    }>;
+    uploadImage(input: {
+        data: Uint8Array;
+        signal?: AbortSignal;
+    }): Promise<{
+        imageKey: string;
+    }>;
+    uploadFile(input: {
+        data: Uint8Array;
+        name: string;
+        fileType: 'opus' | 'mp4' | 'pdf' | 'doc' | 'xls' | 'ppt' | 'stream';
+        durationMs?: number;
+        signal?: AbortSignal;
+    }): Promise<{
+        fileKey: string;
+    }>;
+}
+//# sourceMappingURL=media-port.d.ts.map

package/lib/upstream/media-port.d.ts.map

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

package/lib/upstream/media-port.js

@@ -0,0 +1,168 @@
+/**
+ * Lark media port - Media ingress/egress over the official
+ * @larksuiteoapi/node-sdk OpenAPI Client (Milestone M2A, plan section 26/27).
+ *
+ * The port is the ONLY module in channel-lark that resolves platform media.
+ * downloadMessageResource is the M2A Native Image Ingress path; it goes
+ * strictly through client.im.v1.messageResource.get (official SDK) - never
+ * hand-written /open-apis/im/v1/... URLs, no tenant-token logic. The SDK
+ * returns a binary stream ({ getReadableStream }) which this port normalizes
+ * to a Uint8Array, best-effort copying the content-type header into mimeType.
+ *
+ * Since plan section 23-A4 the port resolves ALL four binary resource kinds:
+ * the official `message.resource` API documents its scope as 音频、视频、图片和文件
+ * ("resource files in the specified message, including audio, video, image
+ * and file", see the SDK-embedded doc statement for im.v1.messageResource.get
+ * in @larksuiteoapi/node-sdk@1.73.1), and the SDK `type` query param is typed
+ * `string` - NOT restricted to image/file. The mapper therefore routes
+ * audio/video file_keys through the same `type: 'audio'` / `type: 'video'`
+ * download seam as image/file. Platform-level limits stay official facts:
+ * <= 100 MB per resource, no stickers, no sub-messages of merged-forward /
+ * card messages (error 234043) - those surface as port failures that the
+ * hydrator maps to a stable ingressFailure.
+ *
+ * uploadImage -> client.im.v1.image.create and uploadFile ->
+ * client.im.v1.file.create are declared now (needed by the outbound-media
+ * milestone M7A later) and implemented because they are straightforward.
+ *
+ * To stay offline-testable this module consumes only a minimal structural
+ * subset of the real SDK Client (mirrors the LarkOpenApiClient split in
+ * openapi-outbound.ts); the real Client satisfies the shape and tests inject
+ * a fake. Credentials are never referenced here - the Client is built
+ * elsewhere from config.
+ *
+ * The SDK messageResource.get signature bound here (1.73.1 types):
+ *   get(payload: { params: { type: string }; path: { message_id: string;
+ *                             file_key: string } }, options?):
+ *     Promise<{ writeFile(fp): Promise<unknown>;
+ *               getReadableStream(): Readable; headers: any }>
+ */
+import { BodyTooLargeError, ChannelError, RemoteMediaAbortedError, concatenate, } from '@krischoichoi/channel-core';
+/** Official per-resource limit, also enforced locally while reading. */
+export const LARK_MESSAGE_RESOURCE_MAX_BYTES = 100 * 1024 * 1024;
+/**
+ * Official-SDK implementation of the media port. downloadMessageResource is
+ * the M2A image-ingress surface; uploadImage/uploadFile are declared now and
+ * implemented via the official image/file clients so the later outbound-media
+ * milestone (M7A) can reuse them.
+ */
+export class LarkOpenApiMediaPort {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async downloadMessageResource(input) {
+        if (input.signal?.aborted)
+            throw new RemoteMediaAbortedError();
+        const result = await this.options.client.im.v1.messageResource.get({
+            params: { type: input.type },
+            path: { message_id: input.messageId, file_key: input.resourceKey },
+        });
+        const data = await streamToUint8Array(result, input.maxBytes ?? LARK_MESSAGE_RESOURCE_MAX_BYTES, input.signal);
+        return { data, mimeType: contentTypeOf(result), name: fileNameOf(result) };
+    }
+    async uploadImage(input) {
+        void input.signal;
+        const result = await this.options.client.im.v1.image.create({
+            data: { image_type: 'message', image: input.data },
+        });
+        const imageKey = result?.image_key;
+        if (!imageKey) {
+            throw new ChannelError('CHANNEL_ERROR', 'lark image upload returned no image_key');
+        }
+        return { imageKey };
+    }
+    async uploadFile(input) {
+        void input.signal;
+        const data = {
+            file_type: input.fileType,
+            file_name: input.name,
+            duration: input.durationMs,
+            file: input.data,
+        };
+        if (input.durationMs === undefined)
+            delete data.duration;
+        const result = await this.options.client.im.v1.file.create({ data });
+        const fileKey = result?.file_key;
+        if (!fileKey) {
+            throw new ChannelError('CHANNEL_ERROR', 'lark file upload returned no file_key');
+        }
+        return { fileKey };
+    }
+}
+/** Consume the official Node stream under a hard cumulative byte cap. */
+async function streamToUint8Array(result, maxBytes, signal) {
+    if (maxBytes <= 0) {
+        throw new BodyTooLargeError(maxBytes, `maxBytes must be positive, got ${maxBytes}`);
+    }
+    if (signal?.aborted)
+        throw new RemoteMediaAbortedError();
+    const stream = result.getReadableStream();
+    const chunks = [];
+    let received = 0;
+    const onAbort = () => stream.destroy(new RemoteMediaAbortedError());
+    signal?.addEventListener('abort', onAbort, { once: true });
+    try {
+        for await (const rawChunk of stream) {
+            if (signal?.aborted)
+                throw new RemoteMediaAbortedError();
+            const chunk = normalizeStreamChunk(rawChunk);
+            if (chunk === undefined) {
+                stream.destroy();
+                throw new ChannelError('CHANNEL_ERROR', 'lark media stream returned a non-binary chunk');
+            }
+            received += chunk.byteLength;
+            if (received > maxBytes) {
+                stream.destroy();
+                throw new BodyTooLargeError(maxBytes);
+            }
+            chunks.push(chunk);
+        }
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw new RemoteMediaAbortedError(undefined, { cause: error });
+        throw error;
+    }
+    finally {
+        signal?.removeEventListener('abort', onAbort);
+    }
+    return concatenate(chunks, received);
+}
+function normalizeStreamChunk(chunk) {
+    if (Buffer.isBuffer(chunk))
+        return chunk;
+    if (typeof chunk === 'string')
+        return Buffer.from(chunk);
+    if (chunk instanceof Uint8Array)
+        return chunk;
+    if (chunk instanceof ArrayBuffer)
+        return new Uint8Array(chunk);
+    if (ArrayBuffer.isView(chunk)) {
+        return new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+    }
+    return undefined;
+}
+/** Best-effort content-type from the SDK response headers. */
+function contentTypeOf(result) {
+    const headers = result.headers;
+    if (!headers)
+        return undefined;
+    const raw = headers['content-type'] ?? headers['Content-Type'];
+    if (typeof raw === 'string')
+        return raw.split(';')[0]?.trim() || undefined;
+    return undefined;
+}
+/** Best-effort filename from the SDK response headers (content-disposition). */
+function fileNameOf(result) {
+    const headers = result.headers;
+    if (!headers)
+        return undefined;
+    const disposition = headers['content-disposition'] ?? headers['Content-Disposition'];
+    if (typeof disposition !== 'string')
+        return undefined;
+    const match = disposition.match(/filename=([^;]+)/i);
+    const value = match?.[1]?.trim().replace(/^"|"$/g, '');
+    return value || undefined;
+}
+//# sourceMappingURL=media-port.js.map

package/lib/upstream/media-port.js.map

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

package/lib/upstream.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Lark upstream contract — the platform-neutral surface implemented by the
+ * official `@larksuiteoapi/node-sdk` driver stack.
+ *
+ * The upstream is the OFFICIAL SDK only:
+ * - inbound  — `LarkSdkUpstream` (WSClient + EventDispatcher,
+ *   `im.message.receive_v1` / `card.action.trigger`);
+ * - outbound — `LarkOpenApiOutbound` (im.v1.* messages/media + CardKit 2.0
+ *   card entities and native streaming).
+ *
+ * Every operation in this contract is expressed in official-SDK semantics —
+ * there is no self-hosted gateway and no legacy `/message/*` / `/card/*`
+ * endpoint. Credentials never appear in this module (clients are built
+ * elsewhere from resolved config/credentials).
+ */
+import type { OutboundActionRow } from '@krischoichoi/channel-core';
+/** Minimal media reference for the basic outbound image send. */
+export interface LarkMediaRef {
+    type: 'image';
+    url?: string;
+    dataUri?: string;
+    name?: string;
+    /** Human-readable description; used as the send name when the part has none. */
+    alt?: string;
+}
+/**
+ * Outbound generic-file reference. localData carries the trusted bytes
+ * (preferred; the adapter never re-downloads), url/dataUri are fallbacks. The
+ * file_type sent to the SDK is derived from name by the outbound driver.
+ */
+export interface LarkFileRef {
+    type: 'file';
+    /** Trusted bytes already held by the adapter (preferred over url/dataUri). */
+    localData?: Uint8Array;
+    url?: string;
+    dataUri?: string;
+    /** Human-readable filename; drives the SDK file_name + derived file_type. */
+    name?: string;
+    mimeType?: string;
+}
+/**
+ * Outbound surface of the official OpenAPI client: plain message/media sends,
+ * Card JSON 2.0 interactive cards, and CardKit 2.0 card-entity + native
+ * streaming operations. Implemented by `LarkOpenApiOutbound` and delegated
+ * through `LarkSdkUpstream`; tests inject a fake OpenAPI client.
+ */
+export interface LarkOutbound {
+    /** Send a plain text message (buffered fallback). */
+    sendText(to: string, text: string): Promise<unknown>;
+    /** Send a basic media message (e.g. a plain image). */
+    sendMedia(to: string, media: LarkMediaRef): Promise<unknown>;
+    /** Send a generic file message. */
+    sendFile(to: string, file: LarkFileRef): Promise<unknown>;
+    /**
+     * Send an official Feishu interactive-card button set (Card JSON 2.0
+     * buttons with `behaviors[].value`).
+     */
+    sendInteractive(to: string, text: string, actions: OutboundActionRow[]): Promise<unknown>;
+    /**
+     * Rewrite an already-sent interactive card, for example to remove completed
+     * actions. Card edit boundary:
+     * - PLAIN SENT MESSAGE CARDS (`im.v1.message.create` with the full Card JSON
+     *   2.0 body inline) are rewritten via `im.v1.message.patch`.
+     * - CARDKIT CARD ENTITIES (`cardkit.v1.card.create` → card reference) are
+     *   updated via the CardKit surface (`updateCardElementContent` /
+     *   `finishStreamingCard`, or the `cardkit.v1.card.update`/`batchUpdate`
+     *   client methods) — never by this `message.patch` path.
+     */
+    updateInteractive(cardId: string, text: string, actions: OutboundActionRow[]): Promise<unknown>;
+    /**
+     * Create a CardKit 2.0 card entity from a serialized Card JSON 2.0 spec.
+     * Returns the entity `card_id` used by later element/settings updates.
+     */
+    createCardEntity(cardJson: string): Promise<{
+        cardId: string;
+    }>;
+    /**
+     * Send a card reference (`{ type: "card", data: { card_id } }`) for an
+     * existing CardKit entity. Returns the sent message id. A card entity may
+     * only be sent once.
+     */
+    sendCardEntity(conversationId: string, cardId: string): Promise<{
+        messageId: string;
+    }>;
+    /**
+     * Native streaming update of one card element's content (the official
+     * "typewriter" interface). `sequence` must increase monotonically per card;
+     * `uuid` is the stable request id for idempotency.
+     */
+    updateCardElementContent(cardId: string, elementId: string, content: string, sequence: number, uuid: string): Promise<unknown>;
+    /** Disable streaming mode and write the final summary (preview text). */
+    finishStreamingCard(cardId: string, sequence: number, summary: string): Promise<unknown>;
+    /** Resolve the official chat mode for a card action before ACL admission. */
+    getChatType?(conversationId: string): Promise<'p2p' | 'group' | undefined>;
+    startTyping?(messageId: string): Promise<void>;
+    stopTyping?(messageId: string): Promise<void>;
+}
+/**
+ * A CardKit streaming card that has been created and whose card reference has
+ * been sent. The reply handle owns this state across rollovers.
+ */
+export interface LarkStreamingCardRef {
+    /** CardKit entity id. */
+    cardId: string;
+    /** Message id of the interactive card reference already sent. */
+    messageId: string;
+    /** Stable id of the markdown element inside the card (matches the entity JSON). */
+    elementId: string;
+}
+/** Full upstream driver: official SDK inbound receive + outbound delegate. */
+export interface LarkUpstream extends LarkOutbound {
+    /**
+     * Keep the inbound WS long-connection open and forward each raw inbound
+     * payload to `onMessage` until `signal` aborts. Raw payloads are
+     * unstructured — the mapper owns shape validation.
+     */
+    receive(signal: AbortSignal, onMessage: (raw: unknown) => void): Promise<void>;
+}
+//# sourceMappingURL=upstream.d.ts.map

package/lib/upstream.d.ts.map

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

package/lib/upstream.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=upstream.js.map

package/lib/upstream.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@krischoichoi/channel-lark",
+  "version": "0.6.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krischoichoi/dsh-channels.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Lark / Feishu channel adapter for DeepSeek Harness (threads, editable card streaming, edit strategy)",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rimraf lib"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-credentials": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.4",
+    "@larksuiteoapi/node-sdk": "1.73.1",
+    "@krischoichoi/channel-control": "workspace:*",
+    "@krischoichoi/channel-core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@krischoichoi/channel-testkit": "workspace:*",
+    "rimraf": "^6.0.0"
+  },
+  "license": "MIT"
+}