@open-dy/vibecoding-sdk-taro 0.0.1-beta.5 → 0.0.1

package/src/internal/runtime/iframe-auth/identity.ts

@@ -0,0 +1,236 @@
+export type IframeTaroRuntime = {
+  getEnv?: () => unknown
+  ENV_TYPE?: {
+    WEB?: unknown
+  }
+}
+
+type IframeIdentity = {
+  accessToken: string
+  expiresAt: number
+  openId: string
+}
+
+type IframeIdentityMessage = {
+  from?: unknown
+  type?: unknown
+  data?: unknown
+}
+
+const IFRAME_IDENTITY_STORAGE_KEY = '__iframe_douyin_identity__'
+const IFRAME_IDENTITY_MESSAGE_FROM = 'agiPreview'
+const IFRAME_IDENTITY_MESSAGE_TYPE = 'douyinAuth'
+const IFRAME_LOGOUT_MESSAGE_TYPE = 'douyinLogout'
+
+let cachedIdentity: IframeIdentity | null = null
+
+const isWebIframeRuntime = (taro?: IframeTaroRuntime | null) => {
+  return (
+    typeof taro?.getEnv === 'function' &&
+    taro.ENV_TYPE?.WEB != null &&
+    taro.getEnv() === taro.ENV_TYPE.WEB &&
+    typeof window !== 'undefined' &&
+    window.parent !== window
+  )
+}
+
+const isRecord = (value: unknown): value is Record<string, unknown> => {
+  return typeof value === 'object' && value !== null
+}
+
+const isExpiredIdentity = (identity: IframeIdentity): boolean => {
+  return identity.expiresAt <= Date.now()
+}
+
+const normalizeIdentity = (value: unknown): IframeIdentity | null => {
+  if (!isRecord(value)) {
+    return null
+  }
+
+  const accessToken = typeof value.accessToken === 'string' ? value.accessToken.trim() : ''
+  const expiresAt =
+    typeof value.expiresAt === 'number' && Number.isFinite(value.expiresAt)
+      ? value.expiresAt
+      : 0
+  const openId = typeof value.openId === 'string' ? value.openId.trim() : ''
+
+  if (!accessToken || !openId || expiresAt <= 0) {
+    return null
+  }
+
+  return {
+    accessToken,
+    expiresAt,
+    openId,
+  }
+}
+
+const getParentOrigin = () => {
+  if (typeof document === 'undefined' || !document.referrer) {
+    return null
+  }
+
+  try {
+    return new URL(document.referrer).origin
+  } catch {
+    return null
+  }
+}
+
+const readStoredIdentity = (
+  taro?: IframeTaroRuntime | null,
+): IframeIdentity | null => {
+  if (!isWebIframeRuntime(taro) || typeof sessionStorage === 'undefined') {
+    return null
+  }
+
+  try {
+    const storedValue = sessionStorage.getItem(IFRAME_IDENTITY_STORAGE_KEY)
+    if (!storedValue) {
+      return null
+    }
+
+    return normalizeIdentity(JSON.parse(storedValue))
+  } catch {
+    return null
+  }
+}
+
+export const getIframeIdentity = (
+  taro?: IframeTaroRuntime | null,
+): IframeIdentity | null => {
+  if (cachedIdentity) {
+    if (isExpiredIdentity(cachedIdentity)) {
+      clearIframeIdentity(taro)
+      return null
+    }
+    return cachedIdentity
+  }
+
+  cachedIdentity = readStoredIdentity(taro)
+  if (cachedIdentity && isExpiredIdentity(cachedIdentity)) {
+    clearIframeIdentity(taro)
+    return null
+  }
+  return cachedIdentity
+}
+
+export const persistIframeIdentity = (
+  taro: IframeTaroRuntime | null | undefined,
+  identity: IframeIdentity,
+) => {
+  if (isExpiredIdentity(identity)) {
+    clearIframeIdentity(taro)
+    return
+  }
+
+  cachedIdentity = identity
+
+  if (!isWebIframeRuntime(taro) || typeof sessionStorage === 'undefined') {
+    return
+  }
+
+  try {
+    sessionStorage.setItem(
+      IFRAME_IDENTITY_STORAGE_KEY,
+      JSON.stringify(identity),
+    )
+  } catch {
+    // Ignore storage failures and keep the in-memory copy.
+  }
+}
+
+export const clearIframeIdentity = (
+  taro?: IframeTaroRuntime | null,
+) => {
+  cachedIdentity = null
+
+  if (!isWebIframeRuntime(taro) || typeof sessionStorage === 'undefined') {
+    return
+  }
+
+  try {
+    sessionStorage.removeItem(IFRAME_IDENTITY_STORAGE_KEY)
+  } catch {
+    // Ignore storage failures and rely on the in-memory reset.
+  }
+}
+
+export const getIframeIdentityHeaders = (
+  taro?: IframeTaroRuntime | null,
+): Record<string, string> => {
+  const identity = getIframeIdentity(taro)
+  if (!identity) {
+    return {}
+  }
+
+  return {
+    OpenId: identity.openId,
+    Authorization: `Bearer ${identity.accessToken}`,
+  }
+}
+
+export const mergeIframeIdentityHeaders = (
+  taro: IframeTaroRuntime | null | undefined,
+  header?: Record<string, unknown>,
+): Record<string, unknown> | undefined => {
+  const identityHeaders = getIframeIdentityHeaders(taro)
+  if (Object.keys(identityHeaders).length === 0) {
+    return header
+  }
+
+  return {
+    ...header,
+    ...identityHeaders,
+  }
+}
+
+export const parseIframeIdentityMessage = (
+  taro: IframeTaroRuntime | null | undefined,
+  event: MessageEvent<unknown>,
+): IframeIdentity | null => {
+  if (!isWebIframeRuntime(taro) || event.source !== window.parent) {
+    return null
+  }
+
+  const parentOrigin = getParentOrigin()
+  if (parentOrigin && event.origin !== parentOrigin) {
+    return null
+  }
+
+  const message = event.data as IframeIdentityMessage
+  if (
+    !message ||
+    message.from !== IFRAME_IDENTITY_MESSAGE_FROM ||
+    message.type !== IFRAME_IDENTITY_MESSAGE_TYPE
+  ) {
+    return null
+  }
+
+  return normalizeIdentity(message.data)
+}
+
+export const isIframeLogoutMessage = (
+  taro: IframeTaroRuntime | null | undefined,
+  event: MessageEvent<unknown>,
+): boolean => {
+  if (!isWebIframeRuntime(taro) || event.source !== window.parent) {
+    return false
+  }
+
+  const parentOrigin = getParentOrigin()
+  if (parentOrigin && event.origin !== parentOrigin) {
+    return false
+  }
+
+  const message = event.data as IframeIdentityMessage
+  return Boolean(
+    message &&
+    message.from === IFRAME_IDENTITY_MESSAGE_FROM &&
+    message.type === IFRAME_LOGOUT_MESSAGE_TYPE,
+  )
+}
+
+export const shouldListenIframeIdentityMessage = (
+  taro?: IframeTaroRuntime | null,
+) => isWebIframeRuntime(taro)

package/src/internal/runtime/iframe-auth/index.ts

@@ -0,0 +1,2 @@
+export * from './identity'
+export { subscribeIframeAuth } from './sync'

package/src/internal/runtime/iframe-auth/sync.ts

@@ -0,0 +1,37 @@
+import {
+  clearIframeIdentity,
+  type IframeTaroRuntime,
+  isIframeLogoutMessage,
+  parseIframeIdentityMessage,
+  persistIframeIdentity,
+  shouldListenIframeIdentityMessage,
+} from './identity'
+
+export const subscribeIframeAuth = (
+  taro: IframeTaroRuntime | null | undefined,
+  clearLoginAuth: () => void,
+) => {
+  if (!shouldListenIframeIdentityMessage(taro)) {
+    return
+  }
+
+  const handleMessage = (event: MessageEvent<unknown>) => {
+    if (isIframeLogoutMessage(taro, event)) {
+      clearIframeIdentity(taro)
+      clearLoginAuth()
+      return
+    }
+
+    const identity = parseIframeIdentityMessage(taro, event)
+    if (!identity) {
+      return
+    }
+
+    persistIframeIdentity(taro, identity)
+  }
+
+  window.addEventListener('message', handleMessage)
+  return () => {
+    window.removeEventListener('message', handleMessage)
+  }
+}

package/src/internal/vendor-modules.d.ts

@@ -0,0 +1,8 @@
+declare module '@tailwindcss/postcss' {
+  const tailwindcss: (...args: any[]) => any
+  export default tailwindcss
+}
+
+declare module 'weapp-tailwindcss/vite' {
+  export const UnifiedViteWeappTailwindcssPlugin: (options?: any) => any
+}

package/src/lib/measure.ts

@@ -0,0 +1,115 @@
+import Taro from '@tarojs/taro'
+import { canUseDOM, isH5 } from './platform'
+
+export type Rect = { left: number; top: number; width: number; height: number }
+
+const toNumber = (v: unknown) => {
+    if (typeof v === 'number') return v
+    if (typeof v === 'string') {
+        const n = parseFloat(v)
+        return Number.isFinite(n) ? n : 0
+    }
+    return 0
+}
+
+const normalizeRect = (r: any): Rect | null => {
+    if (!r) return null
+    return {
+        left: toNumber(r.left),
+        top: toNumber(r.top),
+        width: toNumber(r.width),
+        height: toNumber(r.height),
+    }
+}
+
+export const getViewport = () => {
+    if (isH5() && canUseDOM()) {
+        return { width: window.innerWidth, height: window.innerHeight }
+    }
+    try {
+        const info = Taro.getSystemInfoSync()
+        return {
+            width: toNumber(info.windowWidth),
+            height: toNumber(info.windowHeight),
+        }
+    } catch {
+        return { width: 375, height: 667 }
+    }
+}
+
+const getRectH5 = (id: string): Rect | null => {
+    if (!isH5() || !canUseDOM()) return null
+    const el = document.getElementById(id)
+    if (!el) return null
+    const r = el.getBoundingClientRect()
+    return normalizeRect(r)
+}
+
+export const getRectById = (id: string): Promise<Rect | null> => {
+    const h5Rect = getRectH5(id)
+    if (h5Rect) return Promise.resolve(h5Rect)
+    return new Promise(resolve => {
+        const query = Taro.createSelectorQuery()
+        query
+            .select(`#${id}`)
+            .boundingClientRect(res => {
+                const rect = Array.isArray(res) ? res[0] : res
+                resolve(normalizeRect(rect))
+            })
+            .exec()
+    })
+}
+
+export const computePosition = (params: {
+    triggerRect: Rect
+    contentRect: Rect
+    align: 'start' | 'center' | 'end'
+    side: 'top' | 'bottom' | 'left' | 'right'
+    sideOffset: number
+}) => {
+    const { triggerRect, contentRect, align, side, sideOffset } = params
+    const { width: vw, height: vh } = getViewport()
+    const margin = 8
+
+    const crossStart =
+        side === 'left' || side === 'right' ? triggerRect.top : triggerRect.left
+    const crossSize =
+        side === 'left' || side === 'right'
+            ? triggerRect.height
+            : triggerRect.width
+    const contentCrossSize =
+        side === 'left' || side === 'right'
+            ? contentRect.height
+            : contentRect.width
+
+    const cross = (() => {
+        if (align === 'start') return crossStart
+        if (align === 'end') return crossStart + crossSize - contentCrossSize
+        return crossStart + crossSize / 2 - contentCrossSize / 2
+    })()
+
+    let left = 0
+    let top = 0
+
+    if (side === 'bottom' || side === 'top') {
+        left = cross
+        top =
+            side === 'bottom'
+                ? triggerRect.top + triggerRect.height + sideOffset
+                : triggerRect.top - contentRect.height - sideOffset
+    } else {
+        top = cross
+        left =
+            side === 'right'
+                ? triggerRect.left + triggerRect.width + sideOffset
+                : triggerRect.left - contentRect.width - sideOffset
+    }
+
+    const maxLeft = Math.max(margin, vw - contentRect.width - margin)
+    const maxTop = Math.max(margin, vh - contentRect.height - margin)
+
+    left = Math.min(Math.max(left, margin), maxLeft)
+    top = Math.min(Math.max(top, margin), maxTop)
+
+    return { left, top }
+}

package/src/lib/platform.ts

@@ -0,0 +1,11 @@
+import Taro from "@tarojs/taro"
+
+export const canUseDOM = () => typeof window !== "undefined" && typeof document !== "undefined"
+
+export const isH5 = () => {
+  try {
+    return Taro.getEnv() === Taro.ENV_TYPE.WEB
+  } catch {
+    return canUseDOM()
+  }
+}

package/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/src/runtime/client.ts

@@ -0,0 +1,246 @@
+import {
+  canUseDouyinContainer,
+  downloadByDouyinContainer,
+  isDouyinMiniProgram,
+  isDouyinPreviewEnv,
+  isWebPreviewEnv,
+  requestByDouyinContainer,
+  requestSSEByDouyinContainer,
+  uploadByDouyinContainer,
+} from './douyin-container-request'
+import {
+  mergeCachedDouyinLoginHeaders,
+  requestByDouyinLogin,
+  requestSSEByDouyinLogin,
+  requestSSEByFetch,
+  setDouyinLoginPlatformChannel,
+  uploadByDouyinLogin,
+  downloadByDouyinLogin,
+} from './douyin-login-request'
+import { mergeIframeIdentityHeaders } from '../internal/runtime/iframe-auth/index'
+import { appendGetQuery, createUrl } from './network-url'
+
+/**
+ * @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 function createMicroappClient(
+  taro: Taro.TaroStatic,
+  options: CreateMicroappClientOptions = {},
+) {
+  setDouyinLoginPlatformChannel(options.platformChannel ?? '')
+  const mergeExternalPlatformChannelHeader = (
+    header?: Record<string, unknown>,
+  ): Record<string, unknown> | undefined => {
+    if (options.platformChannel !== 'ext') return header
+    return {
+      ...header,
+      'ai-platform-channel': 'ext',
+    }
+  }
+
+  // 保留原模板的登录态复用；非 Web 预览的可信 iframe 身份可以覆盖它。
+  const mergeRequestIdentityHeaders = (
+    header?: Record<string, unknown>,
+  ): Record<string, unknown> | undefined => {
+    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: string, res: Taro.request.SuccessCallbackResult<any>) => {
+      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 as Record<string, any> | undefined,
+        method,
+      )
+      return taro.request({
+        ...rest,
+        url: finalUrl,
+        method,
+        header: fallbackHeader,
+        ...(method.toUpperCase() === 'GET' ? {} : { data }),
+      })
+    })
+    promise.then(res => logResponse(option.url, res)).catch(() => { })
+    return promise
+  }) as typeof Taro.request
+
+  const uploadFile = ((option: Taro.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)
+  }) as (
+    option: Omit<Taro.uploadFile.Option, 'url' | 'name'> & { url?: string, name?: string },
+  ) => ReturnType<typeof Taro.uploadFile>
+
+  const downloadFile = ((option: Taro.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)
+  }) as (
+    option: Omit<Taro.downloadFile.Option, 'url'> & { url?: string },
+  ) => ReturnType<typeof Taro.downloadFile>
+
+  const streamSse = async (option: {
+    url: string;
+    method?: string;
+    data?: unknown;
+    header?: Record<string, unknown>;
+    onMessage(frame: string): void;
+    onError?(error: Error): void;
+    onComplete?(): void;
+  }) => {
+    const method = (option.method ?? "POST") as Taro.request.Option<
+      any,
+      any
+    >["method"];
+    const externalPlatformHeader = /^http(s)?:\/\//.test(option.url)
+      ? option.header
+      : mergeExternalPlatformChannelHeader(option.header);
+    const fallbackHeader = mergeRequestIdentityHeaders(externalPlatformHeader);
+
+    let eventSourceTask: 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 as Record<string, any> | undefined,
+          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,
+    };
+  
+  };
+
+  return {
+    request,
+    uploadFile,
+    downloadFile,
+    streamSse,
+  }
+}

package/src/runtime/default-client.ts

@@ -0,0 +1,26 @@
+import Taro from '@tarojs/taro'
+import {
+  createMicroappClient as createMicroappClientWithTaro,
+  type CreateMicroappClientOptions,
+} from './client'
+
+/**
+ * @desc 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。
+ * @params {CreateMicroappClientOptions} [options] 平台渠道配置；默认使用内场渠道。
+ * @return {ReturnType<typeof createMicroappClient>} 仅提供普通小程序的 request、uploadFile、downloadFile 和 streamSse。
+ * @remarks 业务优先从模板的 @/network 导入 Network；HTTP(S) 绝对地址直接交给 Taro。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。
+ * @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: CreateMicroappClientOptions = {},
+) {
+  return createMicroappClientWithTaro(Taro, options)
+}

package/src/runtime/default-iframe-auth.ts

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