akanjs 2.3.12-rc.1 → 2.3.13-rc.0

package/index.ts

@@ -78,6 +78,87 @@ export interface AkanMobileConfig extends AkanCapacitorLikeConfig {
   targets: Record<string, AkanMobileTargetConfig>;
 }
 
+export interface PluginRuntimeContext {
+  readonly appName: string;
+  readonly mobile: AkanMobileConfig;
+  /** True when any mobile target declares the given permission. */
+  hasMobilePermission(permission: MobilePermission): boolean;
+}
+
+export interface AkanScanInfo {
+  /** Transitive lib dependencies of the app (or direct deps of a lib). */
+  getLibs(): string[];
+  getDatabaseModules(): string[];
+  getServiceModules(): string[];
+  getScalarModules(): string[];
+}
+
+export interface AkanExecutor {
+  readonly name: string;
+  readonly type: "app" | "lib";
+  readonly cwdPath: string;
+  getPath(rel: string): string;
+  exists(rel: string): Promise<boolean>;
+  readFile(rel: string): Promise<string>;
+  writeFile(rel: string, content: string, opts?: { overwrite?: boolean; silent?: boolean }): Promise<unknown>;
+  mkdir(rel: string): Promise<unknown>;
+  removeDir(rel: string): Promise<unknown>;
+  cp(src: string, dest: string): Promise<void>;
+  readdir(rel: string): Promise<string[]>;
+  getFilesAndDirs(rel: string): Promise<{ files: string[]; dirs: string[] }>;
+  scan(options?: { refresh?: boolean; write?: boolean }): Promise<AkanScanInfo>;
+}
+
+export interface AkanSyncContext {
+  readonly appName: string;
+  readonly appPath: string;
+  /** The full app/lib executor for advanced scan-result access and file operations. */
+  readonly executor: AkanExecutor;
+  getPath(rel: string): string;
+  fileExists(rel: string): Promise<boolean>;
+  writeFile(rel: string, content: string, opts?: { overwrite?: boolean }): Promise<void>;
+  /** Resolves `env/env.client.ts` and returns its exported `env`, or null when absent/invalid. */
+  readEnvClient(): Promise<Record<string, unknown> | null>;
+}
+
+export interface AkanNativeContext {
+  readonly appPath: string;
+  /** The app executor for advanced scan-result access and file operations. */
+  readonly executor: AkanExecutor;
+  readonly target: AkanMobileTargetConfig;
+  readonly operation: "local" | "release";
+  readonly env: MobileEnv;
+  /** Set NS-prefixed usage descriptions in the iOS Info.plist (Debug + Release). */
+  setIosUsageDescriptions(descriptions: Record<string, string>): Promise<void>;
+  /** Merge raw key/values into the iOS Info.plist (Debug + Release). */
+  updateIosInfoPlist(values: Record<string, unknown>): Promise<void>;
+  /** Contribute entries to the iOS entitlements file (merged, then written once per prepare). */
+  addIosEntitlements(entitlements: Record<string, string | string[]>): void;
+  /** Transform `ios/App/App/AppDelegate.swift` in place (no-op when the file is absent). */
+  editIosAppDelegate(transform: (content: string) => string): Promise<void>;
+  /** Add `uses-permission` entries to the Android manifest (without the `android.permission.` prefix). */
+  addAndroidPermissions(permissions: string[]): void;
+  /** Add `uses-feature` entries to the Android manifest. */
+  addAndroidFeatures(features: string[]): void;
+}
+
+export interface AkanPluginCapacitorConfig {
+  /** Mobile permission that activates this plugin's native config (reuses the existing permission model). */
+  permission?: MobilePermission;
+  /** Imperative native (Capacitor) project configuration. */
+  configureNative?: (ctx: AkanNativeContext) => Promise<void>;
+}
+
+export interface AkanPlugin {
+  name: string;
+  /** Runtime npm packages this plugin needs; installed on demand by the CLI (e.g. firebase for push). */
+  runtimePackages?: (ctx: PluginRuntimeContext) => string[];
+  /** Native (Capacitor) project configuration. */
+  capacitor?: AkanPluginCapacitorConfig;
+  /** Build-time asset generation (e.g. `public/firebase-messaging-sw.js`). */
+  syncAssets?: (ctx: AkanSyncContext) => Promise<void>;
+}
+
 export interface AppConfigResult {
   docker: DockerConfig;
   defaultDatabaseMode: DatabaseMode;
@@ -110,8 +191,10 @@ export interface LibConfigContext {
   readonly type: "lib";
 }
 
-export type AppConfig = DeepPartial<AppConfigResult> | ((app: AppConfigContext) => DeepPartial<AppConfigResult>);
-export type LibConfig = DeepPartial<LibConfigResult> | ((lib: LibConfigContext) => DeepPartial<LibConfigResult>);
+export type AppConfigInput = DeepPartial<AppConfigResult> & { plugins?: AkanPlugin[] };
+export type LibConfigInput = DeepPartial<LibConfigResult> & { plugins?: AkanPlugin[] };
+export type AppConfig = AppConfigInput | ((app: AppConfigContext) => AppConfigInput);
+export type LibConfig = LibConfigInput | ((lib: LibConfigContext) => LibConfigInput);
 export type AkanConfigFile = object;
 
 export interface FileConventionScanResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "2.3.12-rc.1",
+  "version": "2.3.13-rc.0",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -195,7 +195,6 @@
     "bullmq": "^5.76.10",
     "capacitor-plugin-safe-area": "^5.0.0",
     "chance": "^1.1.13",
-    "cordova-plugin-purchase": "^13.16.0",
     "croner": "^10.0.1",
     "daisyui": "5.5.23",
     "firebase": "^12.13.0",
@@ -280,9 +279,6 @@
     "chance": {
       "optional": true
     },
-    "cordova-plugin-purchase": {
-      "optional": true
-    },
     "croner": {
       "optional": true
     },

package/types/index.d.ts

@@ -72,6 +72,91 @@ export interface AkanMobileConfig extends AkanCapacitorLikeConfig {
     buildNum: number;
     targets: Record<string, AkanMobileTargetConfig>;
 }
+export interface PluginRuntimeContext {
+    readonly appName: string;
+    readonly mobile: AkanMobileConfig;
+    /** True when any mobile target declares the given permission. */
+    hasMobilePermission(permission: MobilePermission): boolean;
+}
+export interface AkanScanInfo {
+    /** Transitive lib dependencies of the app (or direct deps of a lib). */
+    getLibs(): string[];
+    getDatabaseModules(): string[];
+    getServiceModules(): string[];
+    getScalarModules(): string[];
+}
+export interface AkanExecutor {
+    readonly name: string;
+    readonly type: "app" | "lib";
+    readonly cwdPath: string;
+    getPath(rel: string): string;
+    exists(rel: string): Promise<boolean>;
+    readFile(rel: string): Promise<string>;
+    writeFile(rel: string, content: string, opts?: {
+        overwrite?: boolean;
+        silent?: boolean;
+    }): Promise<unknown>;
+    mkdir(rel: string): Promise<unknown>;
+    removeDir(rel: string): Promise<unknown>;
+    cp(src: string, dest: string): Promise<void>;
+    readdir(rel: string): Promise<string[]>;
+    getFilesAndDirs(rel: string): Promise<{
+        files: string[];
+        dirs: string[];
+    }>;
+    scan(options?: {
+        refresh?: boolean;
+        write?: boolean;
+    }): Promise<AkanScanInfo>;
+}
+export interface AkanSyncContext {
+    readonly appName: string;
+    readonly appPath: string;
+    /** The full app/lib executor for advanced scan-result access and file operations. */
+    readonly executor: AkanExecutor;
+    getPath(rel: string): string;
+    fileExists(rel: string): Promise<boolean>;
+    writeFile(rel: string, content: string, opts?: {
+        overwrite?: boolean;
+    }): Promise<void>;
+    /** Resolves `env/env.client.ts` and returns its exported `env`, or null when absent/invalid. */
+    readEnvClient(): Promise<Record<string, unknown> | null>;
+}
+export interface AkanNativeContext {
+    readonly appPath: string;
+    /** The app executor for advanced scan-result access and file operations. */
+    readonly executor: AkanExecutor;
+    readonly target: AkanMobileTargetConfig;
+    readonly operation: "local" | "release";
+    readonly env: MobileEnv;
+    /** Set NS-prefixed usage descriptions in the iOS Info.plist (Debug + Release). */
+    setIosUsageDescriptions(descriptions: Record<string, string>): Promise<void>;
+    /** Merge raw key/values into the iOS Info.plist (Debug + Release). */
+    updateIosInfoPlist(values: Record<string, unknown>): Promise<void>;
+    /** Contribute entries to the iOS entitlements file (merged, then written once per prepare). */
+    addIosEntitlements(entitlements: Record<string, string | string[]>): void;
+    /** Transform `ios/App/App/AppDelegate.swift` in place (no-op when the file is absent). */
+    editIosAppDelegate(transform: (content: string) => string): Promise<void>;
+    /** Add `uses-permission` entries to the Android manifest (without the `android.permission.` prefix). */
+    addAndroidPermissions(permissions: string[]): void;
+    /** Add `uses-feature` entries to the Android manifest. */
+    addAndroidFeatures(features: string[]): void;
+}
+export interface AkanPluginCapacitorConfig {
+    /** Mobile permission that activates this plugin's native config (reuses the existing permission model). */
+    permission?: MobilePermission;
+    /** Imperative native (Capacitor) project configuration. */
+    configureNative?: (ctx: AkanNativeContext) => Promise<void>;
+}
+export interface AkanPlugin {
+    name: string;
+    /** Runtime npm packages this plugin needs; installed on demand by the CLI (e.g. firebase for push). */
+    runtimePackages?: (ctx: PluginRuntimeContext) => string[];
+    /** Native (Capacitor) project configuration. */
+    capacitor?: AkanPluginCapacitorConfig;
+    /** Build-time asset generation (e.g. `public/firebase-messaging-sw.js`). */
+    syncAssets?: (ctx: AkanSyncContext) => Promise<void>;
+}
 export interface AppConfigResult {
     docker: DockerConfig;
     defaultDatabaseMode: DatabaseMode;
@@ -99,8 +184,14 @@ export interface LibConfigContext {
     readonly name: string;
     readonly type: "lib";
 }
-export type AppConfig = DeepPartial<AppConfigResult> | ((app: AppConfigContext) => DeepPartial<AppConfigResult>);
-export type LibConfig = DeepPartial<LibConfigResult> | ((lib: LibConfigContext) => DeepPartial<LibConfigResult>);
+export type AppConfigInput = DeepPartial<AppConfigResult> & {
+    plugins?: AkanPlugin[];
+};
+export type LibConfigInput = DeepPartial<LibConfigResult> & {
+    plugins?: AkanPlugin[];
+};
+export type AppConfig = AppConfigInput | ((app: AppConfigContext) => AppConfigInput);
+export type LibConfig = LibConfigInput | ((lib: LibConfigContext) => LibConfigInput);
 export type AkanConfigFile = object;
 export interface FileConventionScanResult {
     constant: {

package/types/webkit/index.d.ts

@@ -3,15 +3,10 @@ export { createRobotPage } from "./createRobotPage.d.ts";
 export { createSitemapPage } from "./createSitemapPage.d.ts";
 export { lazy } from "./lazy.d.ts";
 export type * from "./types.d.ts";
-export { useCamera } from "./useCamera.d.ts";
-export { useCodepush } from "./useCodepush.d.ts";
-export { useContact } from "./useContact.d.ts";
 export { useCsrValues } from "./useCsrValues.d.ts";
 export { useDebounce } from "./useDebounce.d.ts";
 export { useFetch, useFetchFn } from "./useFetch.d.ts";
-export { useGeoLocation } from "./useGeoLocation.d.ts";
 export { useHistory } from "./useHistory.d.ts";
 export { useInterval } from "./useInterval.d.ts";
 export { useLocation } from "./useLocation.d.ts";
-export { initPushNotificationClickBridge, type PushNotificationPermission, type PushNotificationPlatform, type PushNotificationProvider, type PushToken, usePushNotification, } from "./usePushNotification.d.ts";
 export { useThrottle } from "./useThrottle.d.ts";

package/webkit/index.ts

@@ -3,22 +3,10 @@ export { createRobotPage } from "./createRobotPage";
 export { createSitemapPage } from "./createSitemapPage";
 export { lazy } from "./lazy";
 export type * from "./types";
-export { useCamera } from "./useCamera";
-export { useCodepush } from "./useCodepush";
-export { useContact } from "./useContact";
 export { useCsrValues } from "./useCsrValues";
 export { useDebounce } from "./useDebounce";
 export { useFetch, useFetchFn } from "./useFetch";
-export { useGeoLocation } from "./useGeoLocation";
 export { useHistory } from "./useHistory";
 export { useInterval } from "./useInterval";
 export { useLocation } from "./useLocation";
-export {
-  initPushNotificationClickBridge,
-  type PushNotificationPermission,
-  type PushNotificationPlatform,
-  type PushNotificationProvider,
-  type PushToken,
-  usePushNotification,
-} from "./usePushNotification";
 export { useThrottle } from "./useThrottle";

package/types/webkit/useCamera.d.ts

@@ -1,19 +0,0 @@
-import { type CapacitorPermissionState } from "akanjs/client/capacitor";
-type PermissionStatus = {
-    camera: CapacitorPermissionState;
-    photos: CapacitorPermissionState;
-};
-/** Capacitor camera/photos hook with permission checks and app-settings fallback. */
-export declare const useCamera: () => {
-    permissions: PermissionStatus;
-    getPhoto: (src?: "prompt" | "camera" | "photos") => Promise<{
-        [key: string]: unknown;
-        dataUrl?: string;
-    } | undefined>;
-    pickImage: () => Promise<{
-        [key: string]: unknown;
-        photos: unknown[];
-    }>;
-    checkPermission: (type: "photos" | "camera" | "all") => Promise<void>;
-};
-export {};

package/types/webkit/useCodepush.d.ts

@@ -1,16 +0,0 @@
-import type { ProtoAppInfo, ProtoFile } from "akanjs/constant";
-export declare const useCodepush: ({ serverUrl }: {
-    serverUrl: string;
-}) => {
-    update: boolean;
-    version: string;
-    initialize: () => Promise<void>;
-    checkNewRelease: () => Promise<{
-        release: ProtoAppInfo & {
-            appBuild: string;
-        };
-        bundleFile: ProtoFile;
-    } | undefined>;
-    codepush: () => Promise<void>;
-    statManager: () => Promise<void>;
-};

package/types/webkit/useContact.d.ts

@@ -1,11 +0,0 @@
-import { type CapacitorPermissionState } from "akanjs/client/capacitor";
-type PermissionStatus = {
-    contacts: CapacitorPermissionState;
-};
-/** Capacitor contacts hook with permission checks and contact loading helpers. */
-export declare const useContact: () => {
-    permissions: PermissionStatus;
-    getContacts: () => Promise<unknown[]>;
-    checkPermission: () => Promise<void>;
-};
-export {};

package/types/webkit/useGeoLocation.d.ts

@@ -1,8 +0,0 @@
-/** Capacitor geolocation hook with permission checks and current position lookup. */
-export declare const useGeoLocation: () => {
-    checkPermission: () => Promise<{
-        geolocation: string;
-        coarseLocation: string;
-    }>;
-    getPosition: () => Promise<unknown>;
-};

package/types/webkit/usePurchase.d.ts

@@ -1,19 +0,0 @@
-import "cordova-plugin-purchase/www/store";
-export type PlatformType = "android" | "ios" | "all";
-export interface ProductType {
-    id: string;
-    type: keyof typeof CdvPurchase.ProductType;
-}
-export type CdvProductType = CdvPurchase.ProductType;
-export declare const usePurchase: ({ platform, productInfo, url, onPay, onSubscribe, }: {
-    platform: PlatformType;
-    productInfo: ProductType[];
-    url: string;
-    onPay?: (transaction: CdvPurchase.Transaction) => void | Promise<void>;
-    onSubscribe?: (transaction: CdvPurchase.Transaction) => void | Promise<void>;
-}) => {
-    isLoading: boolean;
-    products: CdvPurchase.Product[];
-    purchaseProduct: (product: CdvPurchase.Product) => Promise<void>;
-    restorePurchases: () => Promise<void>;
-};

package/types/webkit/usePushNotification.d.ts

@@ -1,37 +0,0 @@
-export type PushNotificationPlatform = "web" | "ios" | "android";
-export type PushNotificationProvider = "fcm";
-export interface FirebaseOptions {
-    apiKey?: string;
-    authDomain?: string;
-    databaseURL?: string;
-    projectId?: string;
-    storageBucket?: string;
-    messagingSenderId?: string;
-    appId?: string;
-    measurementId?: string;
-}
-export interface PushToken {
-    token: string;
-    platform: PushNotificationPlatform;
-    provider: PushNotificationProvider;
-    deviceId?: string;
-}
-export type PushNotificationPermission = "prompt" | "granted" | "denied" | string;
-export interface PushNotificationClientEnv {
-    firebase?: FirebaseOptions & {
-        vapidKey?: string;
-    };
-}
-declare global {
-    var __AKAN_PUSH_CLICK_BRIDGE__: Promise<boolean> | undefined;
-    var __AKAN_CLIENT_ENV__: PushNotificationClientEnv | undefined;
-}
-export declare const initPushNotificationClickBridge: () => Promise<boolean>;
-export declare const usePushNotification: () => {
-    isSupported: () => Promise<boolean>;
-    getPermission: () => Promise<PushNotificationPermission>;
-    requestPermission: () => Promise<PushNotificationPermission>;
-    register: () => Promise<PushToken | undefined>;
-    getToken: () => Promise<PushToken | undefined>;
-    initClickBridge: () => Promise<boolean>;
-};

package/webkit/useCamera.tsx

@@ -1,103 +0,0 @@
-"use client";
-import { Device, isMobileDevice } from "akanjs/client";
-import { type CapacitorPermissionState, loadCapacitorCamera } from "akanjs/client/capacitor";
-import { useEffect, useState } from "react";
-
-type PermissionStatus = {
-  camera: CapacitorPermissionState;
-  photos: CapacitorPermissionState;
-};
-
-/** Capacitor camera/photos hook with permission checks and app-settings fallback. */
-export const useCamera = () => {
-  const [permissions, setPermissions] = useState<PermissionStatus>({ camera: "prompt", photos: "prompt" });
-
-  /**
-   * 최초로 킬 경우 권한은 prompt 상태이다.
-   * prompt 상태일 경우 권한을 요청한다.
-   * 권한이 denied 상태일 경우 설정으로 이동한다.
-   * 이후 state의 permission을 업데이트해야한다.
-   *
-   */
-  const checkPermission = async (type: "photos" | "camera" | "all") => {
-    try {
-      const { Camera } = await loadCapacitorCamera();
-      if (type === "photos") {
-        if (permissions.photos === "prompt") {
-          const { photos } = await Camera.requestPermissions();
-          setPermissions((prev) => ({ ...prev, photos }));
-        } else if (permissions.photos === "denied") {
-          location.assign("app-settings:");
-          return;
-        }
-      } else if (type === "camera") {
-        if (permissions.camera === "prompt") {
-          const { camera } = await Camera.requestPermissions();
-          setPermissions((prev) => ({ ...prev, camera }));
-        } else if (permissions.camera === "denied") {
-          location.assign("app-settings:");
-          return;
-        }
-      } else {
-        if (permissions.camera === "prompt" || permissions.photos === "prompt") {
-          const permissions = await Camera.requestPermissions();
-          setPermissions(permissions);
-        } else if (permissions.camera === "denied" || permissions.photos === "denied") {
-          location.assign("app-settings:");
-          return;
-        }
-      }
-    } catch {
-    }
-  };
-
-  const getPhoto = async (src: "prompt" | "camera" | "photos" = "prompt") => {
-    const { Camera, CameraResultType, CameraSource } = await loadCapacitorCamera();
-    const source =
-      Device.getDevice().info.platform !== "web"
-        ? src === "prompt"
-          ? CameraSource.Prompt
-          : src === "camera"
-            ? CameraSource.Camera
-            : CameraSource.Photos
-        : CameraSource.Photos;
-    const permission = src === "prompt" ? "all" : src === "camera" ? "camera" : "photos";
-    await checkPermission(permission);
-    try {
-      const photo = await Camera.getPhoto({
-        quality: 100,
-        source,
-        allowEditing: false,
-        resultType: CameraResultType.DataUrl,
-        promptLabelHeader: "프로필 사진을 올려주세요",
-        promptLabelPhoto: "앨범에서 선택하기",
-        promptLabelPicture: "사진 찍기",
-        promptLabelCancel: "취소",
-      });
-      return photo;
-    } catch (e) {
-      if (e === "User cancelled photos app") return;
-    }
-  };
-
-  const pickImage = async () => {
-    await checkPermission("photos");
-    const { Camera } = await loadCapacitorCamera();
-    const photo = await Camera.pickImages({
-      quality: 90,
-    });
-
-    return photo;
-  };
-
-  useEffect(() => {
-    void (async () => {
-      if (isMobileDevice()) {
-        const { Camera } = await loadCapacitorCamera();
-        const permissions = await Camera.checkPermissions();
-        setPermissions(permissions);
-      }
-    })();
-  }, []);
-  return { permissions, getPhoto, pickImage, checkPermission };
-};

package/webkit/useCodepush.tsx

@@ -1,99 +0,0 @@
-"use client";
-import { loadCapacitorApp, loadCapacitorDevice, loadCapacitorUpdater } from "akanjs/client/capacitor";
-import { HttpClient, mergeVersion, splitVersion } from "akanjs/common";
-import type { ProtoAppInfo, ProtoFile } from "akanjs/constant";
-import { useState } from "react";
-
-export const useCodepush = ({ serverUrl }: { serverUrl: string }) => {
-  const [update, setUpdate] = useState(false);
-  const [version, setVersion] = useState("");
-
-  const initialize = async () => {
-    const { CapacitorUpdater } = await loadCapacitorUpdater();
-    await CapacitorUpdater.notifyAppReady();
-  };
-  const checkNewRelease = async () => {
-    const [{ App }, { Device }, { CapacitorUpdater }] = await Promise.all([
-      loadCapacitorApp(),
-      loadCapacitorDevice(),
-      loadCapacitorUpdater(),
-    ]);
-    
-    const info = await Device.getInfo();
-    const app = await App.getInfo();
-    const pluginVersion = await CapacitorUpdater.getPluginVersion();
-    const { deviceId } = await CapacitorUpdater.getDeviceId();
-    const { bundle: version, native } = await CapacitorUpdater.current();
-    const builtInversion = await CapacitorUpdater.getBuiltinVersion();
-    const appId = app.id;
-    const platform = info.platform;
-
-    window.alert(
-      `getBuildinVersion:${builtInversion.version}\ncurrent.bundle:${version.version}\ncurrennt.native:${native}`,
-    );
-    /**
-     *  "version_name": "builtin",
-     *   "version_code": "1",
-     *   "app_id": "com.lu.app",
-     *   "plugin_version": "5.6.9",
-     *   "version_build": "1.0",
-     *   "is_prod": true,
-     *   "version_os": "17.0.1",
-     *   "is_emulator": true,
-     *   "custom_id": "",
-     *   "device_id": "C77000B1-7D28-4697-ADE0-74452F47C350",
-     *   "platform": "ios",
-     *   "defaultChannel": ""
-     */
-    const { major, minor, patch } = splitVersion(version.version === "builtin" ? app.version : version.version);
-    const appName = process.env.AKAN_PUBLIC_APP_NAME ?? "";
-
-    const appInfo: ProtoAppInfo = {
-      appId,
-      appName,
-      deviceId: deviceId,
-      platform: platform as "ios" | "android",
-      branch: process.env.AKAN_PUBLIC_ENV ?? "debug",
-      isEmulator: info.isVirtual,
-      major: parseInt(major),
-      minor: parseInt(minor),
-      patch: parseInt(patch),
-      buildNum: app.build, //앱내 빌드시 버전 횟수 모르면 고한테 물어보기
-      versionOs: info.osVersion,
-    };
-
-    const url = serverUrl.replace("lu", "akasys");
-    const httpClient = new HttpClient(url);
-    const release = await httpClient.post<(ProtoAppInfo & { appBuild: string }) | null>("/release/codepush", {
-      data: { ...appInfo },
-    });
-    if (!release) return;
-    const file = await httpClient.get<ProtoFile>(`/file/file/${release.appBuild}`);
-
-    return { release: release, bundleFile: file };
-  };
-
-  const codepush = async () => {
-    
-    const newRelease = await checkNewRelease();
-    if (!newRelease) return;
-    const { release, bundleFile } = newRelease;
-    const { CapacitorUpdater } = await loadCapacitorUpdater();
-    setUpdate(true);
-    const bundle = await CapacitorUpdater.download({
-      url: bundleFile.url,
-      version: mergeVersion(release.major, release.minor, release.patch),
-    });
-    
-    await CapacitorUpdater.set(bundle);
-  };
-  const getVersion = async () => {
-    const { CapacitorUpdater } = await loadCapacitorUpdater();
-    return await CapacitorUpdater.getBuiltinVersion();
-  };
-
-  const statManager = async () => {
-  };
-
-  return { update, version, initialize, checkNewRelease, codepush, statManager };
-};

package/webkit/useContact.tsx

@@ -1,52 +0,0 @@
-"use client";
-import { Device } from "akanjs/client";
-import { type CapacitorPermissionState, loadCapacitorContacts } from "akanjs/client/capacitor";
-import { useEffect, useState } from "react";
-
-type PermissionStatus = {
-  contacts: CapacitorPermissionState;
-};
-
-/** Capacitor contacts hook with permission checks and contact loading helpers. */
-export const useContact = () => {
-  const [permissions, setPermissions] = useState<PermissionStatus>({ contacts: "prompt" });
-
-  /**
-   * 최초로 킬 경우 권한은 prompt 상태이다.
-   * prompt 상태일 경우 권한을 요청한다.
-   * 권한이 denied 상태일 경우 설정으로 이동한다.
-   * 이후 state의 permission을 업데이트해야한다.
-   *
-   */
-  const checkPermission = async () => {
-    try {
-      const { Contacts } = await loadCapacitorContacts();
-      if (permissions.contacts === "prompt") {
-        const { contacts } = await Contacts.requestPermissions();
-        setPermissions((prev) => ({ ...prev, contacts }));
-      } else if (permissions.contacts === "denied") {
-        location.assign("app-settings:");
-        return;
-      }
-    } catch {
-    }
-  };
-
-  const getContacts = async () => {
-    await checkPermission();
-    const { Contacts } = await loadCapacitorContacts();
-    const { contacts } = await Contacts.getContacts({ projection: { name: true, phones: true } });
-    return contacts;
-  };
-
-  useEffect(() => {
-    void (async () => {
-      if (Device.getDevice().info.platform === "web") return;
-      const { Contacts } = await loadCapacitorContacts();
-      const permissions = await Contacts.checkPermissions();
-      setPermissions(permissions);
-    })();
-  }, []);
-
-  return { permissions, getContacts, checkPermission };
-};

package/webkit/useGeoLocation.tsx

@@ -1,24 +0,0 @@
-"use client";
-import { loadCapacitorGeolocation } from "akanjs/client/capacitor";
-
-/** Capacitor geolocation hook with permission checks and current position lookup. */
-export const useGeoLocation = () => {
-  const checkPermission = async (): Promise<{ geolocation: string; coarseLocation: string }> => {
-    const { Geolocation } = await loadCapacitorGeolocation();
-    const { location: geolocation, coarseLocation } = await Geolocation.requestPermissions();
-    return { geolocation, coarseLocation };
-  };
-
-  const getPosition = async () => {
-    const { geolocation, coarseLocation } = await checkPermission();
-    if (geolocation === "denied" || coarseLocation === "denied") {
-      location.assign("app-settings:");
-      return;
-    }
-    const { Geolocation } = await loadCapacitorGeolocation();
-    const coordinates = await Geolocation.getCurrentPosition();
-    return coordinates;
-  };
-
-  return { checkPermission, getPosition };
-};

package/webkit/usePurchase.tsx

@@ -1,156 +0,0 @@
-"use client";
-
-import "cordova-plugin-purchase/www/store";
-
-import { loadCapacitorApp } from "akanjs/client/capacitor";
-import { useEffect, useRef, useState } from "react";
-
-export type PlatformType = "android" | "ios" | "all";
-export interface ProductType {
-  id: string;
-  type: keyof typeof CdvPurchase.ProductType;
-}
-
-export type CdvProductType = CdvPurchase.ProductType;
-
-export const usePurchase = ({
-  platform,
-  productInfo,
-  url,
-  onPay,
-  onSubscribe,
-}: {
-  platform: PlatformType;
-  productInfo: ProductType[];
-  url: string;
-  onPay?: (transaction: CdvPurchase.Transaction) => void | Promise<void>;
-  onSubscribe?: (transaction: CdvPurchase.Transaction) => void | Promise<void>;
-}) => {
-  const [isLoading, setIsLoading] = useState(true);
-  const billingRef = useRef<any>(null);
-
-  useEffect(() => {
-    const init = async () => {
-      if (CdvPurchase.store.isReady) {
-        setIsLoading(false);
-
-        return;
-      }
-      const { App } = await loadCapacitorApp();
-      const app = await App.getInfo();
-      if (platform === "all")
-        CdvPurchase.store.register([
-          ...productInfo.map((prouct) => ({
-            id: prouct.id,
-            platform: CdvPurchase.Platform.GOOGLE_PLAY,
-            type: CdvPurchase.ProductType[prouct.type],
-          })),
-          ...productInfo.map((prouct) => ({
-            id: prouct.id,
-            platform: CdvPurchase.Platform.APPLE_APPSTORE,
-            type: CdvPurchase.ProductType[prouct.type],
-          })),
-        ]);
-      else
-        CdvPurchase.store.register(
-          productInfo.map((product) => ({
-            id: product.id,
-            platform: platform === "android" ? CdvPurchase.Platform.GOOGLE_PLAY : CdvPurchase.Platform.APPLE_APPSTORE,
-            type: CdvPurchase.ProductType[product.type],
-          })),
-        );
-
-      await CdvPurchase.store.initialize([
-        { platform: CdvPurchase.Platform.APPLE_APPSTORE, options: { needAppReceipt: false } },
-        { platform: CdvPurchase.Platform.GOOGLE_PLAY },
-      ]);
-      await CdvPurchase.store.update();
-      await CdvPurchase.store.restorePurchases();
-      
-      CdvPurchase.store.validator = (async (
-        request: { id: string; transaction: { id: string; purchaseToken: string; appStoreReceipt: string } },
-        callback: (result: {
-          ok: boolean;
-          data: { id: string; latest_receipt: boolean; transaction: CdvPurchase.Transaction };
-        }) => void,
-      ) => {
-        const transactionId = request.transaction.id; 
-        const transactions = CdvPurchase.store.localTransactions;
-        const verifingTransaction = transactions.find((transaction) => transaction.transactionId === transactionId);
-
-        if (verifingTransaction?.state !== "approved") return;
-
-        const billing = await fetch(`${url}/billing/verifyBilling`, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-          },
-          body: JSON.stringify({
-            data: {
-              platform: verifingTransaction.platform === CdvPurchase.Platform.GOOGLE_PLAY ? "google" : "apple",
-              packageName: app.id,
-              productId: verifingTransaction.products[0].id,
-              receipt:
-                verifingTransaction.platform === CdvPurchase.Platform.GOOGLE_PLAY
-                  ? request.transaction.purchaseToken
-                  : request.transaction.appStoreReceipt,
-              transactionId: verifingTransaction.transactionId,
-            },
-          }),
-        });
-
-        billingRef.current = billing.json();
-
-        callback({
-          
-          ok: !!billing,
-          
-          data: { id: request.id, latest_receipt: true, transaction: request.transaction } as any,
-        });
-      }) as any;
-      if (CdvPurchase.store.localReceipts.length > 0) {
-        CdvPurchase.store.localReceipts.forEach((receipt) => {
-          if (receipt.platform === CdvPurchase.Platform.GOOGLE_PLAY)
-            if (receipt.transactions[0].state === CdvPurchase.TransactionState.APPROVED)
-              void receipt.transactions[0].verify();
-            else void receipt.transactions[0].finish();
-        });
-      }
-
-      CdvPurchase.store
-        .when()
-        .approved((transaction) => {
-          void transaction.verify();
-        })
-        .verified((receipt) => {
-          void receipt.finish();
-        })
-        .finished((transaction) => {
-          void inAppPurchase(transaction);
-        });
-      setIsLoading(false);
-    };
-    void init();
-  }, []);
-  const purchaseProduct = async (product: CdvPurchase.Product) => {
-    await product.getOffer()?.order();
-  };
-
-  const restorePurchases = async () => {
-    await CdvPurchase.store.restorePurchases();
-  };
-
-  const inAppPurchase = async (transaction: CdvPurchase.Transaction) => {
-    const product = CdvPurchase.store.get(transaction.products[0].id);
-    if (product?.type === "consumable") await onPay?.(transaction);
-    else await onSubscribe?.(transaction);
-    await transaction.finish();
-  };
-
-  return {
-    isLoading,
-    products: CdvPurchase.store.products,
-    purchaseProduct,
-    restorePurchases,
-  };
-};

package/webkit/usePushNotification.tsx

@@ -1,288 +0,0 @@
-"use client";
-
-import { router } from "akanjs/client";
-import { loadCapacitorDevice, loadCapacitorFcm, loadCapacitorPushNotifications } from "akanjs/client/capacitor";
-import { useEffect } from "react";
-
-export type PushNotificationPlatform = "web" | "ios" | "android";
-export type PushNotificationProvider = "fcm";
-
-export interface FirebaseOptions {
-  apiKey?: string;
-  authDomain?: string;
-  databaseURL?: string;
-  projectId?: string;
-  storageBucket?: string;
-  messagingSenderId?: string;
-  appId?: string;
-  measurementId?: string;
-}
-
-export interface PushToken {
-  token: string;
-  platform: PushNotificationPlatform;
-  provider: PushNotificationProvider;
-  deviceId?: string;
-}
-
-export type PushNotificationPermission = "prompt" | "granted" | "denied" | string;
-
-export interface PushNotificationClientEnv {
-  firebase?: FirebaseOptions & {
-    vapidKey?: string;
-  };
-}
-
-declare global {
-  
-  var __AKAN_PUSH_CLICK_BRIDGE__: Promise<boolean> | undefined;
-  
-  var __AKAN_CLIENT_ENV__: PushNotificationClientEnv | undefined;
-}
-
-const getClientEnv = () => globalThis.__AKAN_CLIENT_ENV__;
-
-const getFirebaseConfig = () => getClientEnv()?.firebase;
-
-const firebaseAppPackage = "firebase/app";
-const firebaseMessagingPackage = "firebase/messaging";
-
-const normalizePlatform = (platform: string): PushNotificationPlatform | null => {
-  if (platform === "web" || platform === "ios" || platform === "android") return platform;
-  return null;
-};
-
-const isWebRuntime = () => typeof window !== "undefined" && typeof navigator !== "undefined";
-
-const isInternalDeepLink = (url: string) => {
-  if (url.startsWith("/") && !url.startsWith("//")) return true;
-  if (!isWebRuntime()) return false;
-  try {
-    const parsed = new URL(url, window.location.origin);
-    return parsed.origin === window.location.origin;
-  } catch {
-    return false;
-  }
-};
-
-const enterDeepLink = (url: string) => {
-  if (!isInternalDeepLink(url)) return false;
-  const parsed = new URL(url, isWebRuntime() ? window.location.origin : "http://localhost");
-  return router.enterDeepLink(`${parsed.pathname}${parsed.search}${parsed.hash}`);
-};
-
-const getNativePlatform = async () => {
-  const { Device } = await loadCapacitorDevice();
-  const device = await Device.getInfo();
-  return normalizePlatform(device.platform);
-};
-
-const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
-
-const getNativeToken = async (options?: { retries?: number }): Promise<PushToken | undefined> => {
-  const [{ FCM }, platform] = await Promise.all([loadCapacitorFcm(), getNativePlatform()]);
-  if (!platform || platform === "web") return undefined;
-
-  const retries = options?.retries ?? 0;
-  for (let attempt = 0; attempt <= retries; attempt += 1) {
-    const { token } = await FCM.getToken();
-    if (token) return { token, platform, provider: "fcm" };
-    if (attempt < retries) await sleep(500 * (attempt + 1));
-  }
-
-  return undefined;
-};
-
-const getWebToken = async (): Promise<PushToken | undefined> => {
-  if (!isWebRuntime() || !("serviceWorker" in navigator)) return undefined;
-  const firebaseConfig = getFirebaseConfig();
-  if (
-    !firebaseConfig?.apiKey ||
-    !firebaseConfig.projectId ||
-    !firebaseConfig.messagingSenderId ||
-    !firebaseConfig.appId
-  ) {
-    return undefined;
-  }
-  const [{ getApps, initializeApp }, { getToken: getFirebaseToken, getMessaging }] = await Promise.all([
-    null as unknown as typeof import("firebase/app"), //! temporary disabled
-    null as unknown as typeof import("firebase/messaging"), //@ temporary disabled
-  ]);
-  const firebase = getApps()[0] ?? initializeApp(firebaseConfig);
-  const messaging = getMessaging(firebase);
-  const serviceWorkerRegistration = await navigator.serviceWorker.register("/firebase-messaging-sw.js");
-  const token = await getFirebaseToken(messaging, {
-    vapidKey: firebaseConfig.vapidKey,
-    serviceWorkerRegistration,
-  });
-  if (!token) return undefined;
-  return { token, platform: "web", provider: "fcm" };
-};
-
-const getPushUrlFromNativeEvent = (event: { notification?: { data?: Record<string, unknown> } }) => {
-  const data = event.notification?.data;
-  const fcmMessage = data?.FCM_MSG as { data?: { url?: unknown }; fcmOptions?: { link?: unknown } } | undefined;
-  const directUrl = data?.url;
-  const nestedUrl = fcmMessage?.data?.url ?? fcmMessage?.fcmOptions?.link;
-  return typeof directUrl === "string" ? directUrl : typeof nestedUrl === "string" ? nestedUrl : undefined;
-};
-
-const waitForNativeRegistration = async (
-  PushNotifications: Awaited<ReturnType<typeof loadCapacitorPushNotifications>>["PushNotifications"],
-): Promise<string | undefined> => {
-  let registrationHandle: { remove?: () => Promise<void> | void } | void;
-  let errorHandle: { remove?: () => Promise<void> | void } | void;
-
-  const cleanup = async () => {
-    await registrationHandle?.remove?.();
-    await errorHandle?.remove?.();
-  };
-
-  return await new Promise<string | undefined>((resolve) => {
-    let settled = false;
-    const finish = (token?: string) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timeout);
-      void cleanup();
-      resolve(token);
-    };
-
-    const timeout = setTimeout(() => finish(), 8000);
-
-    Promise.resolve(
-      PushNotifications.addListener("registration", (event) => {
-        finish(typeof event.value === "string" ? event.value : undefined);
-      }),
-    ).then((handle) => {
-      registrationHandle = handle;
-    });
-    Promise.resolve(PushNotifications.addListener("registrationError", () => finish())).then((handle) => {
-      errorHandle = handle;
-    });
-    Promise.resolve(PushNotifications.register()).catch(() => finish());
-  });
-};
-
-export const initPushNotificationClickBridge = async () => {
-  if (globalThis.__AKAN_PUSH_CLICK_BRIDGE__) return await globalThis.__AKAN_PUSH_CLICK_BRIDGE__;
-
-  try {
-    const platform = await getNativePlatform();
-    if (!platform || platform === "web") return true;
-
-    globalThis.__AKAN_PUSH_CLICK_BRIDGE__ = (async () => {
-      const { PushNotifications } = await loadCapacitorPushNotifications();
-      await PushNotifications.addListener("pushNotificationActionPerformed", (event) => {
-        const url = getPushUrlFromNativeEvent(event);
-        if (!url) return;
-        try {
-          enterDeepLink(url);
-        } catch {
-        }
-      });
-      return true;
-    })();
-
-    return await globalThis.__AKAN_PUSH_CLICK_BRIDGE__;
-  } catch {
-    return false;
-  }
-};
-
-export const usePushNotification = () => {
-  useEffect(() => {
-    void initPushNotificationClickBridge();
-  }, []);
-
-  const isSupported = async () => {
-    if (!isWebRuntime()) return false;
-    try {
-      const platform = await getNativePlatform();
-      if (platform && platform !== "web") {
-        await Promise.all([loadCapacitorFcm(), loadCapacitorPushNotifications()]);
-        return true;
-      }
-    } catch {
-    }
-    return Boolean(getFirebaseConfig()?.apiKey && "Notification" in window && "serviceWorker" in navigator);
-  };
-
-  const getPermission = async (): Promise<PushNotificationPermission> => {
-    try {
-      const platform = await getNativePlatform();
-      if (platform && platform !== "web") {
-        const { PushNotifications } = await loadCapacitorPushNotifications();
-        const { receive } = await PushNotifications.checkPermissions();
-        return receive;
-      }
-    } catch {
-    }
-    if (!isWebRuntime() || !("Notification" in window)) return "denied";
-    return Notification.permission;
-  };
-
-  const requestPermission = async (): Promise<PushNotificationPermission> => {
-    try {
-      const platform = await getNativePlatform();
-      if (platform && platform !== "web") {
-        const { PushNotifications } = await loadCapacitorPushNotifications();
-        const { receive } = await PushNotifications.requestPermissions();
-        return receive;
-      }
-    } catch {
-    }
-    if (!isWebRuntime() || !("Notification" in window)) return "denied";
-    return await Notification.requestPermission();
-  };
-
-  const getToken = async () => {
-    try {
-      const platform = await getNativePlatform();
-      if (platform && platform !== "web") return await getNativeToken();
-    } catch {
-    }
-    try {
-      return await getWebToken();
-    } catch {
-      return undefined;
-    }
-  };
-
-  const register = async () => {
-    try {
-      const permission = await requestPermission();
-
-      const platform = await getNativePlatform().catch(() => null);
-      if (platform && platform !== "web") {
-        const [{ FCM }, { PushNotifications }] = await Promise.all([
-          loadCapacitorFcm(),
-          loadCapacitorPushNotifications(),
-        ]);
-        await FCM.setAutoInit({ enabled: true });
-
-        if (platform === "android") {
-          return await getNativeToken({ retries: 5 });
-        }
-
-        if (permission !== "granted") return undefined;
-        await waitForNativeRegistration(PushNotifications);
-        return await getNativeToken({ retries: 5 });
-      }
-
-      if (permission !== "granted") return undefined;
-      return await getWebToken();
-    } catch {
-      return undefined;
-    }
-  };
-
-  return {
-    isSupported,
-    getPermission,
-    requestPermission,
-    register,
-    getToken,
-    initClickBridge: initPushNotificationClickBridge,
-  };
-};