@open-dy/vibecoding-sdk-taro 0.0.1-beta.1

package/dist/reference/sdk-api.md

@@ -0,0 +1,43 @@
+# SDK API Reference
+
+<!-- Generated by build/src/sdk-reference/skill-reference.ts. Do not edit. -->
+
+本文档是 SDK API 的入口索引。详细契约按导入路径和 API 拆分到 `sdk-api/`，内容来自 SDK 源码的结构化 JSDoc 与 TypeScript 类型契约。
+
+`?` 表示可选字段；平台运行时对象（例如 `taro`）只展示类型，不展开其内部方法。
+
+## 公开入口索引
+
+以下列表来自 SDK `package.json` 的 `exports`。适配器、UI、ESLint、类型和静态资源入口保留在索引中，避免把别名误认为独立运行时实现。
+
+| 导入路径 | 用途 | 详细文档 |
+| --- | --- | --- |
+| `@open-dy/vibecoding-sdk-taro` | 根入口：类型与聚合导出。 | — |
+| `@open-dy/vibecoding-sdk-taro/runtime` | SDK 公开 API。 | [查看](sdk-api/runtime/index.md) |
+| `@open-dy/vibecoding-sdk-taro/interest-card/runtime/microapp` | 兴趣卡普通小程序适配器，复用 runtime 入口。 | [查看](sdk-api/runtime/index.md) |
+| `@open-dy/vibecoding-sdk-taro/interest-card/eslint/taro` | 公开导出入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/interest-card/types/taro` | 公开导出入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/ui` | React UI 组件入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/ui/*` | React UI 组件入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/ui/theme.css` | UI 样式资源入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/ui/tailwind.css` | UI 样式资源入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card` | 公开导出入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/build/taro` | SDK 公开 API。 | [查看](sdk-api/build/taro/index.md) |
+| `@open-dy/vibecoding-sdk-taro/types/taro` | 平台类型声明入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/reference/sdk-api.md` | 已生成的机器可读或 Markdown 参考文档。 | — |
+| `@open-dy/vibecoding-sdk-taro/reference/sdk-api.json` | 已生成的机器可读或 Markdown 参考文档。 | — |
+| `@open-dy/vibecoding-sdk-taro/reference/llms.txt` | 已生成的机器可读或 Markdown 参考文档。 | — |
+| `@open-dy/vibecoding-sdk-taro/reference/sdk-api/*` | 已生成的机器可读或 Markdown 参考文档。 | — |
+| `@open-dy/vibecoding-sdk-taro/eslint/taro` | 场景化 ESLint 配置入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/eslint/server` | 场景化 ESLint 配置入口。 | — |
+| `@open-dy/vibecoding-sdk-taro/build` | 构建能力聚合入口；详细契约见 build/taro 和 build/opencard。 | [查看](sdk-api/build/taro/index.md) |
+
+## 文档目录
+
+- [runtime](sdk-api/runtime/index.md)
+  - `createMicroappClient`
+  - `CreateMicroappClientOptions`
+- [build/taro](sdk-api/build/taro/index.md)
+  - `BuildContext`
+  - `CreateMicroappTaroConfigOptions`
+  - `createMicroappTaroConfig`

package/dist/runtime/client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @desc 配置普通小程序 Network 的平台渠道。
+ * @example
+ * ```ts
+ * const options = { platformChannel: 'ext' as const }
+ * ```
+ * @ai-intent 配置普通小程序 Network 的平台渠道。
+ * @ai-when 需要让普通小程序请求携带内场或外场渠道标识时。
+ * @ai-avoid 不要在业务页面直接拼接渠道请求头。
+ * @ai-example { platformChannel: 'ext' }
+ */
+export interface CreateMicroappClientOptions {
+    /** @desc 平台渠道：空字符串为内场，ext 为外场；默认空字符串。 */
+    platformChannel?: '' | 'ext';
+}
+/**
+ * 网络请求模块
+ * 封装 Taro.request、Taro.uploadFile、Taro.downloadFile，自动添加项目域名前缀
+ * 如果请求的 url 以 http:// 或 https:// 开头，则不会添加域名前缀
+ *
+ * IMPORTANT: 项目已经全局注入 PROJECT_DOMAIN
+ * IMPORTANT: 除非你需要添加全局参数，如给所有请求加上 header，否则不能修改此文件
+ */
+export declare function createMicroappClient(taro: Taro.TaroStatic, options?: CreateMicroappClientOptions): {
+    request: <T = any, U = any>(option: import("@tarojs/taro").request.Option<T, U>) => import("@tarojs/taro").RequestTask<T>;
+    requestClosedDomain: <T = any, U = any>(option: import("@tarojs/taro").request.Option<T, U>) => import("@tarojs/taro").RequestTask<T>;
+    uploadFile: (option: Omit<Taro.uploadFile.Option, "url" | "name"> & {
+        url?: string;
+        name?: string;
+    }) => ReturnType<typeof Taro.uploadFile>;
+    uploadFileClosedDomain: (option: Omit<Taro.uploadFile.Option, "url" | "name"> & {
+        url?: string;
+        name?: string;
+    }) => ReturnType<typeof Taro.uploadFile>;
+    downloadFile: (option: Omit<Taro.downloadFile.Option, "url"> & {
+        url?: string;
+    }) => ReturnType<typeof Taro.downloadFile>;
+    downloadFileClosedDomain: (option: Omit<Taro.downloadFile.Option, "url"> & {
+        url?: string;
+    }) => ReturnType<typeof Taro.downloadFile>;
+    streamSse: (option: {
+        url: string;
+        method?: string;
+        data?: unknown;
+        header?: Record<string, unknown>;
+        onMessage(frame: string): void;
+        onError?(error: Error): void;
+        onComplete?(): void;
+    }) => Promise<{
+        close: () => void;
+    }>;
+    streamSseClosedDomain: (option: {
+        url: string;
+        method?: string;
+        data?: unknown;
+        header?: Record<string, unknown>;
+        onMessage(frame: string): void;
+        onError?(error: Error): void;
+        onComplete?(): void;
+    }) => Promise<{
+        close: () => void;
+    }>;
+};

package/dist/runtime/client.js

@@ -0,0 +1,194 @@
+import { mergeClosedDomainRequestHeader } from './closed-domain-request-header.js';
+import { canUseDouyinContainer, downloadByDouyinContainer, isDouyinMiniProgram, isDouyinPreviewEnv, isWebPreviewEnv, requestByDouyinContainer, requestSSEByDouyinContainer, uploadByDouyinContainer, } from './douyin-container-request.js';
+import { mergeCachedDouyinLoginHeaders, requestByDouyinLogin, requestSSEByDouyinLogin, requestSSEByFetch, setDouyinLoginPlatformChannel, uploadByDouyinLogin, downloadByDouyinLogin, } from './douyin-login-request.js';
+import { mergeIframeIdentityHeaders } from '../internal/runtime/iframe-auth/index.js';
+import { appendGetQuery, createUrl } from './network-url.js';
+/**
+ * 网络请求模块
+ * 封装 Taro.request、Taro.uploadFile、Taro.downloadFile，自动添加项目域名前缀
+ * 如果请求的 url 以 http:// 或 https:// 开头，则不会添加域名前缀
+ *
+ * IMPORTANT: 项目已经全局注入 PROJECT_DOMAIN
+ * IMPORTANT: 除非你需要添加全局参数，如给所有请求加上 header，否则不能修改此文件
+ */
+export function createMicroappClient(taro, options = {}) {
+    setDouyinLoginPlatformChannel(options.platformChannel ?? '');
+    const mergeExternalPlatformChannelHeader = (header) => {
+        if (options.platformChannel !== 'ext')
+            return header;
+        return {
+            ...header,
+            'ai-platform-channel': 'ext',
+        };
+    };
+    // 保留原模板的登录态复用；非 Web 预览的可信 iframe 身份可以覆盖它。
+    const mergeRequestIdentityHeaders = (header) => {
+        const loginHeaders = mergeCachedDouyinLoginHeaders(header);
+        return isWebPreviewEnv()
+            ? loginHeaders
+            : mergeIframeIdentityHeaders(taro, loginHeaders);
+    };
+    const request = (option => {
+        const method = option.method ?? 'GET';
+        if (/^http(s)?:\/\//.test(option.url)) {
+            return taro.request(option);
+        }
+        const externalPlatformHeader = mergeExternalPlatformChannelHeader(option.header);
+        const fallbackHeader = mergeRequestIdentityHeaders(externalPlatformHeader);
+        const logResponse = (url, res) => {
+            console.log(`[Network] ${method} ${url} ${res.statusCode}`, res.data);
+        };
+        if (isDouyinMiniProgram() &&
+            !isWebPreviewEnv() &&
+            !isDouyinPreviewEnv() &&
+            canUseDouyinContainer()) {
+            const header = mergeRequestIdentityHeaders(externalPlatformHeader);
+            const promise = requestByDouyinContainer({
+                ...option,
+                method,
+                header,
+            });
+            promise.then(res => logResponse(option.url, res)).catch(() => { });
+            return promise;
+        }
+        const promise = requestByDouyinLogin({
+            ...option,
+            method,
+            header: fallbackHeader,
+        }).catch(() => {
+            const { url, data, ...rest } = option;
+            const finalUrl = appendGetQuery(createUrl(url), data, method);
+            return taro.request({
+                ...rest,
+                url: finalUrl,
+                method,
+                header: fallbackHeader,
+                ...(method.toUpperCase() === 'GET' ? {} : { data }),
+            });
+        });
+        promise.then(res => logResponse(option.url, res)).catch(() => { });
+        return promise;
+    });
+    /** 显式追加封闭域请求标记；不读取卡片模式，也不改变请求目标或云服务 SERVICE_ID。 */
+    const requestClosedDomain = (option => {
+        return request({
+            ...option,
+            header: mergeClosedDomainRequestHeader(option.header),
+        });
+    });
+    const uploadFile = ((option) => {
+        if (!option.url) {
+            option.url = '';
+        }
+        if (/^http(s)?:\/\//.test(option.url)) {
+            return taro.uploadFile(option);
+        }
+        option.header = mergeExternalPlatformChannelHeader(option.header);
+        if (!option.name) {
+            option.name = 'file';
+        }
+        if (isDouyinMiniProgram() &&
+            !isWebPreviewEnv() &&
+            !isDouyinPreviewEnv() &&
+            canUseDouyinContainer() &&
+            !/^http(s)?:\/\//.test(option.url)) {
+            return uploadByDouyinContainer(option);
+        }
+        return uploadByDouyinLogin(option);
+    });
+    const uploadFileClosedDomain = option => {
+        return uploadFile({
+            ...option,
+            header: mergeClosedDomainRequestHeader(option.header),
+        });
+    };
+    const downloadFile = ((option) => {
+        if (!option.url) {
+            option.url = '';
+        }
+        if (/^http(s)?:\/\//.test(option.url)) {
+            return taro.downloadFile(option);
+        }
+        option.header = mergeExternalPlatformChannelHeader(option.header);
+        if (isDouyinMiniProgram() &&
+            !isWebPreviewEnv() &&
+            !isDouyinPreviewEnv() &&
+            canUseDouyinContainer() &&
+            !/^http(s)?:\/\//.test(option.url)) {
+            return downloadByDouyinContainer(option);
+        }
+        return downloadByDouyinLogin(option);
+    });
+    const downloadFileClosedDomain = option => {
+        return downloadFile({
+            ...option,
+            header: mergeClosedDomainRequestHeader(option.header),
+        });
+    };
+    const streamSse = async (option) => {
+        const method = (option.method ?? "POST");
+        const externalPlatformHeader = /^http(s)?:\/\//.test(option.url)
+            ? option.header
+            : mergeExternalPlatformChannelHeader(option.header);
+        const fallbackHeader = mergeRequestIdentityHeaders(externalPlatformHeader);
+        let eventSourceTask;
+        if (isDouyinMiniProgram() &&
+            !isWebPreviewEnv() &&
+            !isDouyinPreviewEnv() &&
+            canUseDouyinContainer() &&
+            !/^http(s)?:\/\//.test(option.url)) {
+            const header = mergeRequestIdentityHeaders(externalPlatformHeader);
+            eventSourceTask = await requestSSEByDouyinContainer({
+                ...option,
+                method,
+                header,
+            });
+        }
+        else {
+            try {
+                eventSourceTask = await requestSSEByDouyinLogin({
+                    ...option,
+                    method,
+                    header: fallbackHeader,
+                });
+            }
+            catch {
+                const { url, data, ...rest } = option;
+                const finalUrl = appendGetQuery(createUrl(url), data, method);
+                eventSourceTask = await requestSSEByFetch({
+                    ...rest,
+                    url: finalUrl,
+                    method,
+                    header: fallbackHeader,
+                    ...(method?.toUpperCase() === "GET" ? {} : { data }),
+                });
+            }
+        }
+        eventSourceTask.onMessage((chunk) => {
+            option.onMessage(chunk.data);
+        });
+        eventSourceTask.onClose(() => {
+            option.onComplete?.();
+        });
+        return {
+            close: eventSourceTask.close,
+        };
+    };
+    const streamSseClosedDomain = async (option) => {
+        return streamSse({
+            ...option,
+            header: mergeClosedDomainRequestHeader(option.header),
+        });
+    };
+    return {
+        request,
+        requestClosedDomain,
+        uploadFile,
+        uploadFileClosedDomain,
+        downloadFile,
+        downloadFileClosedDomain,
+        streamSse,
+        streamSseClosedDomain,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/runtime/client.js.map

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

package/dist/runtime/closed-domain-request-header.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 仅追加 `X-Closed-Domain: 1`，不改请求目标。
+ */
+export declare const mergeClosedDomainRequestHeader: (header?: Record<string, unknown>) => Record<string, unknown>;

package/dist/runtime/closed-domain-request-header.js

@@ -0,0 +1,8 @@
+/**
+ * 仅追加 `X-Closed-Domain: 1`，不改请求目标。
+ */
+export const mergeClosedDomainRequestHeader = (header) => ({
+    ...header,
+    'X-Closed-Domain': '1',
+});
+//# sourceMappingURL=closed-domain-request-header.js.map

package/dist/runtime/closed-domain-request-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closed-domain-request-header.js","sourceRoot":"","sources":["../../src/runtime/closed-domain-request-header.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,MAAgC,EACP,EAAE,CAAC,CAAC;IAC7B,GAAG,MAAM;IACT,iBAAiB,EAAE,GAAG;CACvB,CAAC,CAAA"}

package/dist/runtime/default-client.d.ts

@@ -0,0 +1,57 @@
+import Taro from '@tarojs/taro';
+import { type CreateMicroappClientOptions } from './client.js';
+/**
+ * @desc 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。
+ * @params {CreateMicroappClientOptions} [options] 平台渠道配置；默认使用内场渠道。
+ * @return {ReturnType<typeof createMicroappClient>} 提供普通网络方法，以及显式追加 X-Closed-Domain 标记的对应方法；标记方法不改变请求目标或云服务 SERVICE_ID。
+ * @remarks 业务优先从模板的 @/network 导入 Network；HTTP(S) 绝对地址直接交给 Taro。
+ * @example
+ * ```ts
+ * const Network = createMicroappClient({ platformChannel: 'ext' })
+ * const response = await Network.request({ url: '/api/products', method: 'GET' })
+ * ```
+ * @ai-intent 创建绑定默认 Taro 实例的普通小程序 Network。
+ * @ai-when 业务代码需要统一调用普通小程序的 request、uploadFile、downloadFile 或 streamSse 时。
+ * @ai-avoid 不要在页面中直接调用 Taro.request，也不要传入 OpenCard 的 taro 实例。
+ * @ai-example const Network = createMicroappClient({ platformChannel: 'ext' })
+ */
+export declare function createMicroappClient(options?: CreateMicroappClientOptions): {
+    request: <T = any, U = any>(option: Taro.request.Option<T, U>) => Taro.RequestTask<T>;
+    requestClosedDomain: <T = any, U = any>(option: Taro.request.Option<T, U>) => Taro.RequestTask<T>;
+    uploadFile: (option: Omit<Taro.uploadFile.Option, "url" | "name"> & {
+        url?: string;
+        name?: string;
+    }) => ReturnType<typeof Taro.uploadFile>;
+    uploadFileClosedDomain: (option: Omit<Taro.uploadFile.Option, "url" | "name"> & {
+        url?: string;
+        name?: string;
+    }) => ReturnType<typeof Taro.uploadFile>;
+    downloadFile: (option: Omit<Taro.downloadFile.Option, "url"> & {
+        url?: string;
+    }) => ReturnType<typeof Taro.downloadFile>;
+    downloadFileClosedDomain: (option: Omit<Taro.downloadFile.Option, "url"> & {
+        url?: string;
+    }) => ReturnType<typeof Taro.downloadFile>;
+    streamSse: (option: {
+        url: string;
+        method?: string;
+        data?: unknown;
+        header?: Record<string, unknown>;
+        onMessage(frame: string): void;
+        onError?(error: Error): void;
+        onComplete?(): void;
+    }) => Promise<{
+        close: () => void;
+    }>;
+    streamSseClosedDomain: (option: {
+        url: string;
+        method?: string;
+        data?: unknown;
+        header?: Record<string, unknown>;
+        onMessage(frame: string): void;
+        onError?(error: Error): void;
+        onComplete?(): void;
+    }) => Promise<{
+        close: () => void;
+    }>;
+};

package/dist/runtime/default-client.js

@@ -0,0 +1,21 @@
+import Taro from '@tarojs/taro';
+import { createMicroappClient as createMicroappClientWithTaro, } from './client.js';
+/**
+ * @desc 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。
+ * @params {CreateMicroappClientOptions} [options] 平台渠道配置；默认使用内场渠道。
+ * @return {ReturnType<typeof createMicroappClient>} 提供普通网络方法，以及显式追加 X-Closed-Domain 标记的对应方法；标记方法不改变请求目标或云服务 SERVICE_ID。
+ * @remarks 业务优先从模板的 @/network 导入 Network；HTTP(S) 绝对地址直接交给 Taro。
+ * @example
+ * ```ts
+ * const Network = createMicroappClient({ platformChannel: 'ext' })
+ * const response = await Network.request({ url: '/api/products', method: 'GET' })
+ * ```
+ * @ai-intent 创建绑定默认 Taro 实例的普通小程序 Network。
+ * @ai-when 业务代码需要统一调用普通小程序的 request、uploadFile、downloadFile 或 streamSse 时。
+ * @ai-avoid 不要在页面中直接调用 Taro.request，也不要传入 OpenCard 的 taro 实例。
+ * @ai-example const Network = createMicroappClient({ platformChannel: 'ext' })
+ */
+export function createMicroappClient(options = {}) {
+    return createMicroappClientWithTaro(Taro, options);
+}
+//# sourceMappingURL=default-client.js.map

package/dist/runtime/default-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-client.js","sourceRoot":"","sources":["../../src/runtime/default-client.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,cAAc,CAAA;AAC/B,OAAO,EACL,oBAAoB,IAAI,4BAA4B,GAErD,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EAAE;IAEzC,OAAO,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACpD,CAAC"}

package/dist/runtime/default-iframe-auth.d.ts

@@ -0,0 +1,8 @@
+import type { IframeTaroRuntime } from '../internal/runtime/iframe-auth/index.js';
+/**
+ * @desc 同步普通小程序 iframe 身份并返回监听清理函数。
+ * @params {IframeTaroRuntime | null | undefined} taro 当前 Taro 运行时实例。
+ * @return {() => void} 清理身份消息监听的函数。
+ * @example const cleanup = syncIframeAuth(Taro)
+ */
+export declare const syncIframeAuth: (taro: IframeTaroRuntime | null | undefined) => (() => void) | undefined;

package/dist/runtime/default-iframe-auth.js

@@ -0,0 +1,10 @@
+import { clearDouyinLoginAuth } from './douyin-login-request.js';
+import { subscribeIframeAuth } from '../internal/runtime/iframe-auth/index.js';
+/**
+ * @desc 同步普通小程序 iframe 身份并返回监听清理函数。
+ * @params {IframeTaroRuntime | null | undefined} taro 当前 Taro 运行时实例。
+ * @return {() => void} 清理身份消息监听的函数。
+ * @example const cleanup = syncIframeAuth(Taro)
+ */
+export const syncIframeAuth = (taro) => subscribeIframeAuth(taro, clearDouyinLoginAuth);
+//# sourceMappingURL=default-iframe-auth.js.map

package/dist/runtime/default-iframe-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-iframe-auth.js","sourceRoot":"","sources":["../../src/runtime/default-iframe-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAA;AAE3E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAA0C,EAC1C,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAA"}

package/dist/runtime/douyin-container-request.d.ts

@@ -0,0 +1,11 @@
+import Taro from "@tarojs/taro";
+export declare const isDouyinMiniProgram: () => boolean;
+export declare const isDouyinPreviewEnv: () => boolean;
+export declare const isDouyinTestEnv: () => boolean;
+export declare const getDouyinCloud: () => DouyinCloudInstance | null;
+export declare const canUseDouyinContainer: () => boolean;
+export declare const requestByDouyinContainer: (option: Taro.request.Option<any, any>) => ReturnType<typeof Taro.request>;
+export declare const isWebPreviewEnv: () => boolean;
+export declare const requestSSEByDouyinContainer: (option: Taro.request.Option<any, any>) => Promise<EventSourceTask>;
+export declare const uploadByDouyinContainer: (option: Taro.uploadFile.Option) => Taro.RequestTask<unknown>;
+export declare const downloadByDouyinContainer: (option: Taro.downloadFile.Option) => Taro.RequestTask<unknown> | Taro.DownloadTask.DownloadTaskPromise;