@leonxin/meetgames 0.1.8 → 0.1.12

package/src/config/topsdkFeatureModules.ts

@@ -0,0 +1,92 @@
+import type { MeetSdkFeatureScope, MeetSdkGradleDependency, MeetSdkRemoteConfig } from "./meetSdkRemoteConfig.js";
+import { hasSdkModuleKey } from "./meetSdkRemoteConfig.js";
+
+/**
+ * Gradle `implementation` lines from `sdkModules`（是否接入由 `hasSdkModuleKey` 判定：JSON 是否写了子键）。
+ * 登录 Facebook → `facebook`；埋点 Facebook Data → `facebookdata` / `facebook-data` 构件。
+ */
+export type MeetSdkFeatureCategory = "login" | "payment" | "analytics";
+
+export interface TopSdkFeatureModule {
+  readonly category: MeetSdkFeatureCategory;
+  readonly topsdkArtifact: string;
+  readonly scope: MeetSdkFeatureScope;
+  /** Key under `sdkModules[scope]` (e.g. `facebook` for login vs analytics). */
+  readonly subKey: string;
+}
+
+function readToggle(config: MeetSdkRemoteConfig, m: TopSdkFeatureModule): boolean {
+  const bucket = config.sdkModules[m.scope] as unknown as Record<string, unknown>;
+  return hasSdkModuleKey(bucket, m.subKey);
+}
+
+export function isTopSdkFeatureModuleEnabled(config: MeetSdkRemoteConfig, m: TopSdkFeatureModule): boolean {
+  return readToggle(config, m);
+}
+
+/** Stable Gradle output order. */
+export const TOPSDK_FEATURE_MODULES: readonly TopSdkFeatureModule[] = [
+  { scope: "login", subKey: "guest", category: "login", topsdkArtifact: "guest" },
+  { scope: "login", subKey: "email", category: "login", topsdkArtifact: "email" },
+  { scope: "login", subKey: "facebook", category: "login", topsdkArtifact: "facebook" },
+  { scope: "login", subKey: "google", category: "login", topsdkArtifact: "google" },
+  { scope: "login", subKey: "twitter", category: "login", topsdkArtifact: "twitter" },
+  { scope: "login", subKey: "snapchat", category: "login", topsdkArtifact: "snapchat" },
+  { scope: "login", subKey: "line", category: "login", topsdkArtifact: "line" },
+  { scope: "login", subKey: "naver", category: "login", topsdkArtifact: "naver" },
+  { scope: "login", subKey: "kakao", category: "login", topsdkArtifact: "kakao" },
+  { scope: "login", subKey: "tiktok", category: "login", topsdkArtifact: "tiktok" },
+  { scope: "login", subKey: "discord", category: "login", topsdkArtifact: "discord" },
+  { scope: "analytics", subKey: "appsflyer", category: "analytics", topsdkArtifact: "appsflyer" },
+  { scope: "analytics", subKey: "firebase", category: "analytics", topsdkArtifact: "firebase" },
+  { scope: "analytics", subKey: "adjust", category: "analytics", topsdkArtifact: "adjust" },
+  { scope: "analytics", subKey: "facebookdata", category: "analytics", topsdkArtifact: "facebook-data" },
+  { scope: "payment", subKey: "googleIap", category: "payment", topsdkArtifact: "google-iap" },
+  { scope: "payment", subKey: "onestoreIap", category: "payment", topsdkArtifact: "onestore-iap" },
+  { scope: "payment", subKey: "huaweiIap", category: "payment", topsdkArtifact: "huawei-iap" },
+  { scope: "payment", subKey: "xiaomiIap", category: "payment", topsdkArtifact: "xiaomi-iap" },
+];
+
+function appendRepositories(out: string[], repositories: readonly string[] | undefined): void {
+  if (!repositories) return;
+  for (const repo of repositories) {
+    if (!out.includes(repo)) out.push(repo);
+  }
+}
+
+/**
+ * Maven repositories for modules present in `meetsdk-remote-config.json` (`hasSdkModuleKey`),
+ * with `repositories` resolved from merged `meetsdk-android.json` defaults.
+ */
+export function collectTopSdkFeatureRepositories(config: MeetSdkRemoteConfig): string[] {
+  const out: string[] = [];
+  for (const m of TOPSDK_FEATURE_MODULES) {
+    const bucket = config.sdkModules[m.scope] as unknown as Record<string, unknown>;
+    if (!hasSdkModuleKey(bucket, m.subKey)) continue;
+    const value = bucket[m.subKey];
+    if (typeof value === "object" && value !== null) {
+      const repos = (value as { repositories?: unknown }).repositories;
+      appendRepositories(out, Array.isArray(repos) ? repos.map((x) => String(x)) : undefined);
+    }
+  }
+  return out;
+}
+
+/** Gradle `implementation` lines for enabled modules (excludes mandatory `ui`). */
+export function buildTopSdkFeatureImplementationLines(config: MeetSdkRemoteConfig): string[] {
+  const lines: string[] = [];
+  for (const m of TOPSDK_FEATURE_MODULES) {
+    if (isTopSdkFeatureModuleEnabled(config, m)) {
+      const bucket = config.sdkModules[m.scope] as unknown as Record<string, unknown>;
+      const value = bucket[m.subKey];
+      const deps =
+        typeof value === "object" && value !== null && Array.isArray((value as { dependencies?: unknown }).dependencies)
+          ? ((value as { dependencies: MeetSdkGradleDependency[] }).dependencies)
+          : [{ implementation: `$groupId:${m.topsdkArtifact}:$topsdk_version` }];
+      for (const dep of deps) {
+        lines.push(`    implementation "${dep.implementation}"`);
+      }
+    }
+  }
+  return lines;
+}

package/src/contracts/types.ts

@@ -0,0 +1,129 @@
+export interface AndroidDetection {
+  ok: true;
+  moduleName: string;
+  moduleDir: string;
+  manifestPath: string;
+}
+
+export interface AndroidDetectionError {
+  ok: false;
+  error: string;
+}
+
+export type AndroidDetectResult = AndroidDetection | AndroidDetectionError;
+
+export interface AndroidDetectOptions {
+  /** Unified app target selector; for Android this is the application Gradle module, e.g. `:app` or `launcher`. */
+  appTarget?: string;
+}
+
+export interface IOSDetectOptions {
+  /** Unified app target selector; for iOS this is the Xcode application target name. */
+  appTarget?: string;
+}
+
+export interface IOSDetection {
+  ok: true;
+  iosRoot: string;
+  podfilePath?: string;
+  xcodeprojPath?: string;
+  workspacePath?: string;
+  /** Primary PBXNativeTarget name */
+  targetName?: string;
+  /** Xcode PBXNativeTarget names whose product type is iOS application. */
+  targetNames?: string[];
+}
+
+export interface IOSDetectionError {
+  ok: false;
+  error: string;
+}
+
+export type IOSDetectResult = IOSDetection | IOSDetectionError;
+
+/** iOS 工具链状态说明。 */
+export interface IosToolingReserved {
+  status: "not_implemented" | "implemented";
+  plan?: readonly string[];
+}
+
+export interface WorkspaceContext {
+  projectRoot: string;
+  /** Absolute path to npm package root (for bundled assets) */
+  packageRoot: string;
+  /** sdk-home API root used for latest Android/iOS SDK version discovery. */
+  sdkHomeApiBaseUrl?: string;
+  /** Cached meetsdk-remote-config.json path for this project. */
+  remoteConfigPath?: string;
+  /** Cached iOS SDK root used as the source for integration resources. */
+  iosSdkRoot?: string;
+  android?: AndroidDetectResult;
+  /** Reserved: populated via placeholder until iOS tooling ships. */
+  ios?: IOSDetectResult;
+  iosReserved?: IosToolingReserved;
+}
+
+export interface WorkspaceContextOptions {
+  /** Unified app target selector: Android application module or iOS application target. */
+  appTarget?: string;
+  /** sdk-home API root; defaults to the production MeetGames business API. */
+  sdkHomeApiBaseUrl?: string;
+  /** Override the cached remote config path. */
+  remoteConfigPath?: string;
+  /** Override the iOS SDK source root. */
+  iosSdkRoot?: string;
+}
+
+export interface ManifestStep {
+  op: string;
+  platform?: "android" | "ios" | "all";
+  args?: Record<string, unknown>;
+}
+
+export interface Manifest {
+  version: number;
+  targets?: Array<{
+    platform: "android" | "ios" | "all";
+    when?: { engine?: string };
+  }>;
+  steps: ManifestStep[];
+}
+
+/** Remote-assembled document: same executable shape as Manifest plus optional provenance. */
+export interface AndroidIntegrationDocument extends Manifest {
+  meta?: {
+    sourceUrl?: string;
+    fetchedAt?: string;
+    mode?: string;
+    appId?: string;
+    channelType?: string;
+    endpointPath?: string;
+    authTypesFiltered?: string[];
+    [key: string]: unknown;
+  };
+  /** Raw TOPSDK `getSDKConfig` JSON envelope (`code` / `data` / …), same for Android or iOS callers. */
+  remote?: Record<string, unknown>;
+}
+
+export interface StepResult {
+  ok: boolean;
+  /** Relative paths from project root that were touched or would be touched */
+  changedFiles: string[];
+  warnings: string[];
+  errors: string[];
+}
+
+export interface PipelineReport {
+  dryRun: boolean;
+  projectRoot: string;
+  stepsRun: number;
+  stepsSkipped: number;
+  results: StepResult[];
+  warnings: string[];
+  errors: string[];
+}
+
+export interface AndroidPlatformAdapter {
+  readonly id: "android";
+  detect(projectRoot: string, options?: AndroidDetectOptions): AndroidDetectResult;
+}