@native-marketing/sdk 0.3.5 → 0.3.7

package/types/sdk/transport.d.ts

@@ -1,5 +1,10 @@
 import { Client, type Tool } from '@modelcontextprotocol/client';
 import { type Profile } from './profile.js';
+import { readNativeServerVersion } from './updates/version.js';
 /** 只访问远端正式工具；无本地数据库 fallback，也不重试未知结果的写操作。 */
-export declare function withClient<T>(profile: Profile, timeout: number, operation: (client: Client) => Promise<T>): Promise<T>;
+export declare function withClient<T>(profile: Profile, timeout: number, operation: (client: Client) => Promise<T>, options?: {
+    requireCompatibility?: boolean;
+    allowIncompatible?: boolean;
+    onVersion?: (version: ReturnType<typeof readNativeServerVersion>) => void;
+}): Promise<T>;
 export declare function callTool(client: Client, tool: Tool, input: Record<string, unknown>, timeout: number, readOnly: boolean, errorToolName?: string): Promise<unknown>;

package/types/sdk/updates/commands.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedArgs } from '../cli/input.js';
+type Output = {
+    command: string;
+    data: unknown;
+};
+export declare function runLifecycleCommand(parsed: ParsedArgs, env: NodeJS.ProcessEnv, executablePath?: string): Promise<Output | null>;
+export declare function maybeAutoUpdate(env: NodeJS.ProcessEnv, io: {
+    executablePath?: string;
+    notify?: (message: string) => void;
+}, timeout: number): Promise<Output | null>;
+export {};

package/types/sdk/updates/install.d.ts

@@ -0,0 +1,20 @@
+import { type NativeRegistryRelease, type NativeUpdatePolicy } from '../../contracts/index.js';
+/** The only subprocess adapter in the client: fixed npm installation and version verification. */
+export declare function installCliUpdate(input: {
+    target: NativeRegistryRelease;
+    currentVersion?: string;
+    policy: NativeUpdatePolicy;
+    executablePath?: string;
+    allowBreaking?: boolean;
+    automatic?: boolean;
+    timeoutMs: number;
+    env: NodeJS.ProcessEnv;
+}): Promise<{
+    state: string;
+    package: "@native-marketing/cli" | "@native-marketing/sdk";
+    previousVersion: string;
+    installedVersion: string;
+    restartRequired: boolean;
+    originalCommandExecuted: boolean;
+    recovery: string[];
+}>;

package/types/sdk/updates/registry.d.ts

@@ -0,0 +1,26 @@
+import { type NativeClientRelease, type NativeUpdatePolicy } from '../../contracts/index.js';
+export declare function checkNativeUpdates(options?: {
+    package?: 'sdk' | 'cli';
+    currentVersion?: string;
+    policy?: NativeUpdatePolicy;
+    server?: NativeClientRelease;
+    timeoutMs?: number;
+    fetch?: typeof fetch;
+}): Promise<{
+    checkedAt: number;
+    target: {
+        name: "@native-marketing/cli" | "@native-marketing/sdk";
+        version: string;
+        deprecated?: string | undefined;
+        nativeMarketing?: {
+            contractVersion: number;
+            apiMajor: number;
+            nodeMajor: number;
+            changes?: string[] | undefined;
+        } | undefined;
+        dist: {
+            integrity: string;
+        };
+    };
+    plan: import("../../contracts/index.js").NativeUpdatePlan;
+}>;

package/types/sdk/updates/store.d.ts

@@ -0,0 +1,14 @@
+import { type NativeClientUpdateState as State, type NativeUpdatePolicy } from '../../contracts/index.js';
+export declare class UpdateStore {
+    private readonly files;
+    constructor(env: NodeJS.ProcessEnv);
+    read(): Promise<State>;
+    locked<T>(action: () => Promise<T>): Promise<T>;
+    change(action: (state: State) => State): Promise<State>;
+}
+export declare function effectiveUpdatePolicy(policy: NativeUpdatePolicy, env: NodeJS.ProcessEnv): {
+    mode: "auto" | "notify" | "off";
+    channel: "beta" | "latest" | "next";
+    pin: string | null;
+    intervalHours: number;
+};

package/types/sdk/updates/version.d.ts

@@ -0,0 +1,93 @@
+import type { Client } from '@modelcontextprotocol/client';
+export declare function getNativeClientVersion(): {
+    schemaVersion: 1;
+    product: "native-marketing";
+    version: string;
+    packages: {
+        sdk: "@native-marketing/sdk";
+        cli: "@native-marketing/cli";
+    };
+    contractVersion: number;
+    minimumClientVersion: string;
+    apiMajor: number;
+    nodeMajor: number;
+    changes: string[];
+};
+export declare function getNativeCliVersion(executablePath?: string): Promise<{
+    schemaVersion: 1;
+    product: "native-marketing";
+    version: string;
+    packages: {
+        sdk: "@native-marketing/sdk";
+        cli: "@native-marketing/cli";
+    };
+    contractVersion: number;
+    minimumClientVersion: string;
+    apiMajor: number;
+    nodeMajor: number;
+    changes: string[];
+    sdkVersion: "0.3.7";
+}>;
+export declare function readNativeServerVersion(client: Client): {
+    client: {
+        schemaVersion: 1;
+        product: "native-marketing";
+        version: string;
+        packages: {
+            sdk: "@native-marketing/sdk";
+            cli: "@native-marketing/cli";
+        };
+        contractVersion: number;
+        minimumClientVersion: string;
+        apiMajor: number;
+        nodeMajor: number;
+        changes: string[];
+    };
+    serverInfo: {
+        version: string;
+        websiteUrl?: string | undefined;
+        description?: string | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+            theme?: "dark" | "light" | undefined;
+        }[] | undefined;
+        name: string;
+        title?: string | undefined;
+    } | null;
+    mcpProtocolVersion: string | null;
+    compatibility: import("../../contracts/index.js").NativeCompatibility;
+};
+export declare function assertNativeCompatibility(result: ReturnType<typeof readNativeServerVersion>, required?: boolean): void;
+export declare function refreshNativeServerVersion(client: Client, timeout: number): Promise<{
+    client: {
+        schemaVersion: 1;
+        product: "native-marketing";
+        version: string;
+        packages: {
+            sdk: "@native-marketing/sdk";
+            cli: "@native-marketing/cli";
+        };
+        contractVersion: number;
+        minimumClientVersion: string;
+        apiMajor: number;
+        nodeMajor: number;
+        changes: string[];
+    };
+    serverInfo: {
+        version: string;
+        websiteUrl?: string | undefined;
+        description?: string | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+            theme?: "dark" | "light" | undefined;
+        }[] | undefined;
+        name: string;
+        title?: string | undefined;
+    } | null;
+    mcpProtocolVersion: string | null;
+    compatibility: import("../../contracts/index.js").NativeCompatibility;
+}>;