@krischoichoi/channel-dingtalk 0.6.0

package/lib/index.js.map

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

package/lib/manifest.d.ts

@@ -0,0 +1,23 @@
+export interface DingTalkUpstreamManifest {
+    reference: string;
+    testedVersion: string;
+    versionRange: string;
+    strategy: 'sdk' | 'source';
+}
+/** Official SDK consumed by the upstream driver, when one is used. */
+export interface DingTalkSdkManifest {
+    /** npm package name of the official SDK. */
+    package: string;
+    /** Version the adapter was verified against. */
+    testedVersion: string;
+}
+export interface DingTalkManifest {
+    id: 'dingtalk';
+    adapterVersion: string;
+    upstream: DingTalkUpstreamManifest;
+    sdk: DingTalkSdkManifest | undefined;
+    status: 'tested';
+}
+/** Current manifest: inbound via the official dingtalk-stream SDK. */
+export declare const manifest: DingTalkManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/lib/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC5B;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,GAAG,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,sEAAsE;AACtE,eAAO,MAAM,QAAQ,EAAE,gBActB,CAAC"}

package/lib/manifest.js

@@ -0,0 +1,34 @@
+/**
+ * DingTalk upstream compatibility manifest (M2 + SDK driver).
+ *
+ * Records the upstream reference and tested version so `channels doctor` and
+ * the upgrade pipeline can govern compatibility without re-verifying by hand.
+ *
+ * Strategy: 'sdk' — inbound rides the official `dingtalk-stream` SDK
+ * (WebSocket stream mode). Outbound (message send / AI Card) is not part of
+ * the stream SDK; it uses the message-scoped `sessionWebhook` and DingTalk's
+ * official AI Card OpenAPI through the shared HTTP transport.
+ *
+ * Status 'tested' is justified by the Channel Contract + fixture tests plus
+ * the SDK-mode offline tests (fake stream client) passing — fully offline.
+ * Live verification against a real DingTalk app (AppKey/AppSecret) is a
+ * manual step.
+ */
+import pkg from '../package.json' with { type: 'json' };
+/** Current manifest: inbound via the official dingtalk-stream SDK. */
+export const manifest = {
+    id: 'dingtalk',
+    adapterVersion: pkg.version,
+    upstream: {
+        reference: 'open-dingtalk/dingtalk-stream-sdk-nodejs (https://github.com/open-dingtalk/dingtalk-stream-sdk-nodejs)',
+        testedVersion: '2.1.5',
+        versionRange: '2.1.5',
+        strategy: 'sdk',
+    },
+    sdk: {
+        package: 'dingtalk-stream',
+        testedVersion: '2.1.5',
+    },
+    status: 'tested',
+};
+//# sourceMappingURL=manifest.js.map

package/lib/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAyBxD,sEAAsE;AACtE,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,EAAE,EAAE,UAAU;IACd,cAAc,EAAE,GAAG,CAAC,OAAO;IAC3B,QAAQ,EAAE;QACR,SAAS,EAAE,wGAAwG;QACnH,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,OAAO;QACrB,QAAQ,EAAE,KAAK;KAChB;IACD,GAAG,EAAE;QACH,OAAO,EAAE,iBAAiB;QAC1B,aAAa,EAAE,OAAO;KACvB;IACD,MAAM,EAAE,QAAQ;CACjB,CAAC"}

package/lib/mapper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Pure payload mapping (no I/O): platform raw payloads → Channel Contract,
+ * and outbound Channel messages → dingtalk text payloads.
+ *
+ * Raw payloads only ever ride along in `event.raw` for debugging — core and
+ * the harness bridge never depend on their shape (red line 6).
+ *
+ * DingTalk-ish raw shapes are protocol-level and deliberately simple, e.g.:
+ * ```json
+ * { "type": "text", "msgId": "msg_1", "senderId": "user_123",
+ *   "conversationId": "conv_456", "content": "hello" }
+ * ```
+ */
+import type { AccountId, ChannelId, MessageReceived, InteractionReceived, OutboundMessage } from '@krischoichoi/channel-core';
+export interface DingTalkInboundMeta {
+    channel: ChannelId;
+    accountId: AccountId;
+}
+/** Stable hash for ids when the gateway omits a msgId. */
+export declare function simpleHash(input: string): string;
+/** Map one raw dingtalk message into the stable channel event shape. */
+export declare function mapInbound(raw: unknown, meta: DingTalkInboundMeta): MessageReceived;
+export declare function mapInteraction(raw: unknown, meta: DingTalkInboundMeta): InteractionReceived;
+/** Outbound dingtalk payload; buffered strategy → single text message. */
+export interface DingTalkTextPayload {
+    to: string;
+    type: 'text';
+    content: string;
+}
+/** Convert an outbound channel message into a dingtalk text payload. */
+export declare function toTextPayload(target: {
+    conversationId: string;
+}, message: OutboundMessage): DingTalkTextPayload;
+/** Dedup identity for raw payloads (webhook retries share one msgId/eventId). */
+export declare function dedupKey(raw: unknown): string;
+//# sourceMappingURL=mapper.d.ts.map

package/lib/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EAIT,eAAe,EACf,mBAAmB,EACnB,eAAe,EAEhB,MAAM,4BAA4B,CAAC;AAIpC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;CACtB;AAmDD,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,eAAe,CA4BnF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAyB3F;AAiDD,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,eAAe,GAAG,mBAAmB,CAkC/G;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAG7C"}

package/lib/mapper.js

@@ -0,0 +1,175 @@
+import { ChannelError, textParts } from '@krischoichoi/channel-core';
+import { z } from 'zod';
+const dingtalkRawSchema = z.object({
+    type: z.string().optional(),
+    msgId: z.string().optional(),
+    eventId: z.string().optional(),
+    senderId: z.string().optional(),
+    conversationId: z.string().optional(),
+    conversationType: z.string().optional(),
+    content: z.string().optional(),
+    mentionedBot: z.boolean().optional(),
+}).passthrough();
+function parseDingTalkRaw(raw) {
+    const parsed = dingtalkRawSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new ChannelError('CHANNEL_ERROR', 'dingtalk inbound payload is invalid');
+    }
+    return parsed.data;
+}
+/** True only for genuine http(s) locators. */
+function isHttpUrl(locator) {
+    return typeof locator === 'string' && /^https?:\/\//i.test(locator);
+}
+/** Stable hash for ids when the gateway omits a msgId. */
+export function simpleHash(input) {
+    let hash = 0;
+    for (let i = 0; i < input.length; i += 1) {
+        hash = (hash * 31 + input.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash).toString(36);
+}
+/** Map one raw dingtalk message into the stable channel event shape. */
+export function mapInbound(raw, meta) {
+    const value = parseDingTalkRaw(raw);
+    const sender = (value.senderId ?? 'unknown');
+    // DingTalk payloads carry a conversation id; fall back to the sender when
+    // the gateway omits it (direct/one-off payloads).
+    const conversationId = (value.conversationId ?? sender);
+    const messageId = value.msgId
+        ? value.msgId
+        : `dt-${simpleHash(`${sender}:${value.content ?? ''}:${value.type ?? 'unknown'}`)}`;
+    return {
+        type: 'message.received',
+        channel: meta.channel,
+        accountId: meta.accountId,
+        conversation: {
+            id: conversationId,
+            type: value.conversationType === '2' ? 'group' : 'dm',
+        },
+        sender: { id: sender },
+        message: {
+            id: messageId,
+            content: partsFor(value),
+            createdAt: Date.now(),
+            ...(value.mentionedBot !== undefined ? { activation: { mentionedBot: value.mentionedBot } } : {}),
+        },
+        raw,
+    };
+}
+export function mapInteraction(raw, meta) {
+    const parsed = z.object({
+        type: z.literal('interaction'),
+        senderId: z.string().min(1),
+        conversationId: z.string().min(1),
+        conversationType: z.string().optional(),
+        interactionId: z.string().min(1),
+        action: z.string().min(1),
+        value: z.unknown().optional(),
+    }).passthrough().safeParse(raw);
+    if (!parsed.success)
+        throw new ChannelError('CHANNEL_ERROR', 'dingtalk interaction payload is invalid');
+    return {
+        type: 'interaction.received',
+        channel: meta.channel,
+        accountId: meta.accountId,
+        conversation: {
+            id: parsed.data.conversationId,
+            type: parsed.data.conversationType === '2' ? 'group' : 'dm',
+        },
+        sender: { id: parsed.data.senderId },
+        interactionId: parsed.data.interactionId,
+        action: parsed.data.action,
+        value: parsed.data.value,
+        raw,
+    };
+}
+function partsFor(raw) {
+    switch (raw.type) {
+        case 'text':
+            return textParts(raw.content ?? '');
+        case 'image':
+        case 'picture': {
+            // Official robot picture messages carry an opaque picMediaId/downloadCode
+            // (NOT a URL): resourceRef holds the opaque handle, url only a genuine
+            // http(s) URL. Resolving resourceRef is the upstream's job.
+            const url = isHttpUrl(raw.picUrl) ? raw.picUrl : undefined;
+            const opaque = raw.picMediaId ?? raw.picDownloadCode ?? (raw.picUrl ? raw.picUrl : undefined);
+            return [{ type: 'image', ...(url ? { url } : opaque ? { resourceRef: opaque } : {}), alt: raw.title }];
+        }
+        case 'richText': {
+            const parts = textParts(raw.content ?? '');
+            for (const image of raw.richTextImages ?? []) {
+                const url = isHttpUrl(image.pictureUrl) ? image.pictureUrl : undefined;
+                const resourceRef = image.downloadCode ? `downloadCode:${image.downloadCode}` : undefined;
+                parts.push({ type: 'image', ...(url ? { url } : resourceRef ? { resourceRef } : {}) });
+            }
+            return parts.length > 0
+                ? parts
+                : [{ type: 'unsupported', reason: "empty dingtalk richText message" }];
+        }
+        case 'audio':
+        case 'voice': {
+            const url = isHttpUrl(raw.mediaUrl) ? raw.mediaUrl : undefined;
+            const opaque = raw.downloadCode ?? (raw.mediaUrl ? raw.mediaUrl : undefined);
+            return [{ type: 'audio', ...(url ? { url } : opaque ? { resourceRef: opaque } : {}), durationMs: raw.durationMs }];
+        }
+        case 'video': {
+            const url = isHttpUrl(raw.mediaUrl) ? raw.mediaUrl : undefined;
+            const opaque = raw.downloadCode ?? (raw.mediaUrl ? raw.mediaUrl : undefined);
+            return [{ type: 'video', ...(url ? { url } : opaque ? { resourceRef: opaque } : {}), durationMs: raw.durationMs }];
+        }
+        case 'file': {
+            const url = isHttpUrl(raw.mediaUrl) ? raw.mediaUrl : undefined;
+            const opaque = raw.downloadCode ?? (raw.mediaUrl ? raw.mediaUrl : undefined);
+            return [{ type: 'file', ...(url ? { url } : opaque ? { resourceRef: opaque } : {}), name: raw.title }];
+        }
+        case 'link':
+            return textParts(raw.title ?? raw.content ?? '');
+        default:
+            return [{ type: 'unsupported', reason: `unknown dingtalk type '${raw.type ?? 'undefined'}'` }];
+    }
+}
+/** Convert an outbound channel message into a dingtalk text payload. */
+export function toTextPayload(target, message) {
+    const segments = [];
+    if (message.text)
+        segments.push(message.text);
+    if (message.parts) {
+        for (const part of message.parts) {
+            switch (part.type) {
+                case 'text':
+                    segments.push(part.text);
+                    break;
+                case 'image':
+                    segments.push(part.alt ? `[image: ${part.alt}]` : '[image]');
+                    break;
+                case 'audio':
+                    segments.push('[audio]');
+                    break;
+                case 'video':
+                    segments.push('[video]');
+                    break;
+                case 'file':
+                    segments.push(part.name ? `[file: ${part.name}]` : '[file]');
+                    break;
+                case 'location':
+                    segments.push(`[location: ${part.latitude},${part.longitude}]`);
+                    break;
+                case 'card':
+                    segments.push(`[card: ${part.kind}]`);
+                    break;
+                case 'unsupported':
+                    segments.push('[unsupported content]');
+                    break;
+            }
+        }
+    }
+    return { to: target.conversationId, type: 'text', content: segments.join('') };
+}
+/** Dedup identity for raw payloads (webhook retries share one msgId/eventId). */
+export function dedupKey(raw) {
+    const value = parseDingTalkRaw(raw);
+    return value.msgId ?? value.eventId ?? `dt-${simpleHash(JSON.stringify(value))}`;
+}
+//# sourceMappingURL=mapper.js.map

package/lib/mapper.js.map

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

package/lib/media-mime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal raster-image MIME sniffing for media bytes downloaded from the
+ * DingTalk download API.
+ *
+ * This is NOT a platform protocol: it is a local content-sniffing helper so
+ * the Harness `saveImage()` seam receives a valid raster `ImageMediaType`
+ * (the message-converter only commits an image when a raster MIME is known).
+ * The official connector does the same thing (ext derives from the response
+ * content-type); here we sniff magic bytes because the shared transport
+ * returns raw bytes without headers.
+ */
+/** Raster MIME sniffed from the leading magic bytes, if recognized. */
+export declare function sniffImageMime(data: Uint8Array): 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif' | undefined;
+//# sourceMappingURL=media-mime.d.ts.map

package/lib/media-mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-mime.d.ts","sourceRoot":"","sources":["../src/media-mime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAgBpH"}

package/lib/media-mime.js

@@ -0,0 +1,32 @@
+/**
+ * Minimal raster-image MIME sniffing for media bytes downloaded from the
+ * DingTalk download API.
+ *
+ * This is NOT a platform protocol: it is a local content-sniffing helper so
+ * the Harness `saveImage()` seam receives a valid raster `ImageMediaType`
+ * (the message-converter only commits an image when a raster MIME is known).
+ * The official connector does the same thing (ext derives from the response
+ * content-type); here we sniff magic bytes because the shared transport
+ * returns raw bytes without headers.
+ */
+/** Raster MIME sniffed from the leading magic bytes, if recognized. */
+export function sniffImageMime(data) {
+    if (data.byteLength < 8)
+        return undefined;
+    // PNG: 89 50 4E 47 0D 0A 1A 0A
+    if (data[0] === 0x89 && data[1] === 0x50 && data[2] === 0x4e && data[3] === 0x47)
+        return 'image/png';
+    // JPEG: FF D8 FF
+    if (data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff)
+        return 'image/jpeg';
+    // GIF: 'GIF8'
+    if (data[0] === 0x47 && data[1] === 0x49 && data[2] === 0x46 && data[3] === 0x38)
+        return 'image/gif';
+    // WebP: 'RIFF' .... 'WEBP'
+    if (data[0] === 0x52 && data[1] === 0x49 && data[2] === 0x46 && data[3] === 0x46 &&
+        data[8] === 0x57 && data[9] === 0x45 && data[10] === 0x42 && data[11] === 0x50) {
+        return 'image/webp';
+    }
+    return undefined;
+}
+//# sourceMappingURL=media-mime.js.map

package/lib/media-mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-mime.js","sourceRoot":"","sources":["../src/media-mime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,+BAA+B;IAC/B,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IACrG,iBAAiB;IACjB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAClF,cAAc;IACd,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IACrG,2BAA2B;IAC3B,IACE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAC5E,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAC9E,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/official-upstream.d.ts

@@ -0,0 +1,143 @@
+/***
+ * Official DingTalk OpenAPI port implementation.
+ *
+ * Positioned as `DingTalkOpenApiPortImpl`: it is the thin
+ * implementation of `DingTalkOpenApiPort`, and it also implements the
+ * `DingTalkUpstream` outbound surface so `DingTalkStreamUpstream` can keep
+ * delegating to it unchanged. Stream-mode reply messages carry a short-lived
+ * sessionWebhook used ONLY for the current inbound reply; AI Cards
+ * and proactive sends use the documented DingTalk OpenAPI with an application
+ * access token. Neither path requires the legacy local gateway.
+ *
+ * Behavior oracle / payload contract:
+ *   `@dingtalk-real-ai/dingtalk-connector@0.8.24`.
+ * Every port method records its official-behavior basis in
+ * `DingTalkOpenApiPortImpl.OFFICIAL_BASIS` (and its own docblock). Methods with
+ * no official-behavior basis are marked `@upstream-gap` / `@deprecated` with a
+ * reason (delete any protocol with no official basis).
+ */
+import type { ChannelTarget, OutboundActionRow } from '@krischoichoi/channel-core';
+import type { CardCreateResult, DingTalkUpstream } from './upstream.js';
+import type { HttpTransport } from './transport.js';
+import type { RemoteMediaFetchLike } from './image-hydrator.js';
+import type { DingTalkOpenApiPort, DingTalkOpenApiCredentials, MediaSendInput, MediaUploadInput, MediaUploadResult, ProactiveTextInput, ResolvedMedia, RobotMessageSendResult } from './openapi-port.js';
+export interface DingTalkOfficialUpstreamOptions extends DingTalkOpenApiCredentials {
+    transport: HttpTransport;
+    /** Shared host safety boundary for short-lived DingTalk download URLs. */
+    secureFetch?: RemoteMediaFetchLike;
+}
+/**
+ * Official DingTalk OpenAPI port implementation (rename of the former
+ * `DingTalkOfficialUpstream`). Implements the small `DingTalkOpenApiPort`
+ * plus the `DingTalkUpstream` outbound surface it always had.
+ *
+ * The legacy name `DingTalkOfficialUpstream` is preserved as an alias below so
+ * existing import/call sites and tests keep compiling unchanged.
+ */
+export declare class DingTalkOpenApiPortImpl implements DingTalkOpenApiPort, DingTalkUpstream {
+    private readonly options;
+    private readonly now;
+    private cachedToken?;
+    private readonly inputingCards;
+    private readonly secureFetch;
+    constructor(options: DingTalkOfficialUpstreamOptions);
+    receive(): Promise<void>;
+    /** Reply path: sessionWebhook is ONLY for the current inbound reply. */
+    sendText(target: ChannelTarget, text: string): Promise<unknown>;
+    /**
+     * Get (and cache) the application access token. Official behavior basis:
+     * DingTalk OpenAPI `POST /v1.0/oauth2/accessToken` (the official connector's
+     * token acquisition, mirrored here).
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Proactive plain-text robot send: official proactive API,
+     * never sessionWebhook. Official behavior basis: DingTalk robot message send
+     * (`POST /v1.0/robot/groupMessages/send` for groups;
+     * `POST /v1.0/robot/oToMessages/batchSend` for single chat), msgKey `sampleText`,
+     * msgParam `{ "content": ... }` — mirrors the official connector's proactive
+     * robot message path. Payload contract from the official connector.
+     */
+    sendProactiveText(input: ProactiveTextInput): Promise<RobotMessageSendResult>;
+    /**
+     * Upload a media file. Official behavior basis:
+     * DingTalk media upload `POST /media/upload?access_token=...&type=image|file`
+     * as used by the connector. Standard `FormData` delegates multipart framing
+     * to fetch instead of reproducing a platform protocol in this package.
+     */
+    uploadMedia(input: MediaUploadInput): Promise<MediaUploadResult>;
+    /**
+     * Send an uploaded mediaId as a robot image/file message.
+     * Official behavior basis: DingTalk robot message send with msgKey
+     * `sampleImageMsg` with `{ photoURL: mediaId }` for images, and
+     * `sampleFile` with `{ mediaId, fileName, fileType }` for files, matching
+     * the connector's verified proactive paths.
+     */
+    sendMedia(input: MediaSendInput): Promise<RobotMessageSendResult>;
+    sendInteractiveCard(input: {
+        target: ChannelTarget;
+        templateId: string;
+        text: string;
+        actions: OutboundActionRow[];
+        textParam: string;
+        actionsParam: string;
+    }): Promise<{
+        messageId?: string;
+        outTrackId: string;
+        raw?: unknown;
+    }>;
+    updateInteractiveCard(input: {
+        outTrackId: string;
+        text: string;
+        actions: OutboundActionRow[];
+        textParam: string;
+        actionsParam: string;
+    }): Promise<unknown>;
+    createCard(target: ChannelTarget, _text: string): Promise<CardCreateResult>;
+    updateCard(cardId: string, text: string): Promise<unknown>;
+    finishCard(cardId: string, text?: string): Promise<unknown>;
+    failCard(cardId: string, reason?: string): Promise<unknown>;
+    /**
+     * Resolve an opaque DingTalk media handle (mediaId / downloadCode) into
+     * trusted bytes. Official behavior basis: the connector's
+     * `downloadMediaByCode` / `getFileDownloadUrl` — POST
+     * `/v1.0/robot/messageFiles/download` with `{ downloadCode, robotCode }`
+     * and the application access token returns `{ downloadUrl }`; the URL is
+     * then fetched as raw bytes (responseType arraybuffer). A genuine http(s)
+     * `ref` is fetched directly. Fails closed with a typed error when an opaque
+     * ref lacks the per-message `downloadCode` context.
+     */
+    resolveMedia(ref: string, options?: {
+        signal?: AbortSignal;
+        name?: string;
+        downloadCode?: string;
+        robotCode?: string;
+    }): Promise<ResolvedMedia>;
+    /**
+     * Resolve an opaque DingTalk media handle into a download URL. Official
+     * behavior basis: the connector's `getFileDownloadUrl` — POST
+     * `/v1.0/robot/messageFiles/download` with `{ downloadCode, robotCode }`
+     * and `x-acs-dingtalk-access-token`. A genuine http(s) ref is returned
+     * as-is. Returns `undefined` (fail closed) when an opaque ref lacks the
+     * downloadCode context.
+     */
+    getMediaDownloadUrl(ref: string, options?: {
+        signal?: AbortSignal;
+        downloadCode?: string;
+        robotCode?: string;
+    }): Promise<string | undefined>;
+    private ensureCardInputing;
+    private targetData;
+    private cardDelivery;
+}
+/**
+ * Official-behavior basis for every port method: maps a port method
+ * name to the corresponding official connector implementation location / behavior
+ * oracle, or an explicit `@upstream-gap` / `@deprecated` marker with a reason.
+ * The port-inventory test asserts every interface method has a non-empty entry
+ * here (shape + marker presence).
+ */
+export declare const OFFICIAL_BASIS: Record<string, string>;
+/** Legacy alias (rename): `DingTalkOfficialUpstream` -> `DingTalkOpenApiPortImpl`. */
+export declare const DingTalkOfficialUpstream: typeof DingTalkOpenApiPortImpl;
+//# sourceMappingURL=official-upstream.d.ts.map

package/lib/official-upstream.d.ts.map

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