@zhuixin/shared 0.0.0-stage → 0.1.1

package/dist/index.d.cts

@@ -0,0 +1,412 @@
+import { z } from 'zod';
+
+type TargetPlatform = "ios" | "windows" | "macos" | "android" | "linux";
+type HostPlatform = "darwin" | "win32" | "linux";
+type SourceId = "app-store" | "local-file" | "direct-url" | "microsoft-store" | "winget";
+type PackageFormat = "ipa" | "msix" | "appx" | "exe" | "msi" | "zip" | "dmg" | "apk";
+interface TargetRef {
+    platform: TargetPlatform;
+    sourceId: SourceId;
+    sourceRef: string;
+}
+interface ResolvedTarget {
+    targetRef: TargetRef;
+    name: string;
+    publisher?: string;
+    version?: string;
+    bundleId?: string;
+    packageId?: string;
+    iconUrl?: string;
+    storeUrl?: string;
+    metadata: Record<string, unknown>;
+}
+interface TargetRecord extends ResolvedTarget {
+    id: string;
+    slug: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ArtifactRecord {
+    id: string;
+    targetId: string;
+    platform: TargetPlatform;
+    packageFormat: PackageFormat;
+    architecture?: string;
+    sha256: string;
+    path: string;
+    sizeBytes: number;
+    version?: string;
+    buildNumber?: string;
+    signature?: Record<string, unknown>;
+    inspection?: Record<string, unknown>;
+    sourceUrl?: string;
+    downloadedAt: string;
+    isCurrent: boolean;
+}
+type FindingType = "technology" | "route" | "network_endpoint" | "module" | "asset" | "storage" | "native_procedure" | "native_string" | "risk" | "limitation";
+type FindingConfidence = "exact" | "high" | "medium" | "low" | "unknown";
+interface FindingRecord {
+    id: string;
+    targetId: string;
+    artifactId?: string;
+    jobId: string;
+    evidenceId: string;
+    type: FindingType;
+    value: string;
+    group?: string;
+    sourcePath?: string;
+    start?: {
+        line: number;
+        column: number;
+    };
+    end?: {
+        line: number;
+        column: number;
+    };
+    confidence: FindingConfidence;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+interface EvidenceRecord {
+    id: string;
+    targetId: string;
+    artifactId?: string;
+    jobId: string;
+    kind: string;
+    format: "json" | "markdown" | "text";
+    path: string;
+    sha256: string;
+    summary: Record<string, unknown>;
+    parentEvidenceId?: string;
+    createdAt: string;
+}
+interface FindingSearchResult {
+    items: FindingRecord[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface AnalysisRunRecord {
+    id: string;
+    targetId?: string;
+    status: "running" | "completed" | "failed" | "interrupted";
+    startedAt: string;
+    finishedAt?: string;
+    result?: Record<string, unknown>;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    updatedAt: string;
+}
+type JobStatus = "queued" | "resolving" | "awaiting_auth" | "awaiting_license" | "acquiring" | "inspecting" | "registering" | "ready" | "analyzing" | "analyzed" | "failed" | "cancelled" | "interrupted";
+interface JobRecord {
+    id: string;
+    targetId?: string;
+    sourceId?: SourceId;
+    capabilityId: string;
+    status: JobStatus;
+    progress: number;
+    params: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    errorCode?: string;
+    errorMessage?: string;
+    createdAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+}
+interface JobEvent {
+    jobId: string;
+    level: "info" | "warn" | "error";
+    message: string;
+    payload?: Record<string, unknown>;
+    createdAt: string;
+}
+interface SourceDescriptor {
+    id: SourceId;
+    platform: TargetPlatform;
+    displayName: string;
+    requiresAuth: boolean;
+    status: "ready" | "preview" | "evaluate";
+    description: string;
+}
+interface CapabilityDescriptor {
+    id: string;
+    label: string;
+    description: string;
+    targetPlatforms: TargetPlatform[];
+    packageFormats?: PackageFormat[];
+    hostPlatforms?: HostPlatform[];
+    available: boolean;
+    reason?: string;
+    requiresArtifact?: boolean;
+    requiresInput?: "function" | "query";
+}
+interface ResolveResult {
+    resolutionId: string;
+    target: ResolvedTarget;
+    provider: SourceDescriptor;
+}
+interface TargetDetail {
+    target: TargetRecord;
+    artifacts: ArtifactRecord[];
+    jobs: JobRecord[];
+}
+interface CoreError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+interface HealthInfo {
+    version: string;
+    workspaceRoot: string;
+    hostPlatform: HostPlatform;
+    store: "sqlite" | "json";
+    tools?: ToolInfo[];
+}
+interface ToolInfo {
+    id: string;
+    label: string;
+    path: string;
+    available: boolean;
+}
+interface AccountStatus {
+    authenticated: boolean;
+    email?: string;
+    name?: string;
+    keychain: "unlocked" | "locked" | "unknown";
+    checkedAt: string;
+    message?: string;
+}
+interface EntitlementRecord {
+    appId?: string | number;
+    bundleId?: string;
+    name: string;
+    version?: string;
+    platform?: string;
+}
+interface AccountEntitlements {
+    items: EntitlementRecord[];
+    checkedAt: string;
+    truncated: boolean;
+    error?: string;
+}
+interface EntitlementCheck {
+    status: "owned" | "not_owned" | "unknown";
+    checkedAt: string;
+    message?: string;
+    entitlement?: EntitlementRecord;
+}
+interface CoreRequest<T = unknown> {
+    id: string;
+    channel: string;
+    payload: T;
+}
+type CoreResponse<T = unknown> = {
+    id: string;
+    ok: true;
+    data: T;
+} | {
+    id: string;
+    ok: false;
+    error: CoreError;
+};
+type CoreEvent = {
+    type: "job.updated";
+    payload: JobRecord;
+} | {
+    type: "job.log";
+    payload: JobEvent;
+} | {
+    type: "target.updated";
+    payload: TargetRecord;
+} | {
+    type: "terminal.data";
+    payload: {
+        sessionId: string;
+        data: string;
+    };
+} | {
+    type: "terminal.exit";
+    payload: {
+        sessionId: string;
+        code: number | null;
+        signal?: string | null;
+    };
+};
+declare const CHANNELS: {
+    readonly health: "health";
+    readonly sourcesList: "sources:list";
+    readonly targetsResolve: "targets:resolve";
+    readonly targetsCreate: "targets:create";
+    readonly targetsList: "targets:list";
+    readonly targetsGet: "targets:get";
+    readonly jobsCreate: "jobs:create";
+    readonly jobsGet: "jobs:get";
+    readonly jobsCancel: "jobs:cancel";
+    readonly capabilitiesList: "capabilities:list";
+    readonly findingsSearch: "findings:search";
+    readonly evidenceList: "evidence:list";
+    readonly terminalStart: "terminal:start";
+    readonly terminalInput: "terminal:input";
+    readonly terminalStop: "terminal:stop";
+    readonly accountStatus: "account:status";
+    readonly accountEntitlements: "account:entitlements";
+    readonly accountCheckEntitlement: "account:check-entitlement";
+};
+declare const resolveInputSchema: z.ZodObject<{
+    input: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    input: string;
+}, {
+    input: string;
+}>;
+declare const createTargetSchema: z.ZodObject<{
+    resolutionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    resolutionId: string;
+}, {
+    resolutionId: string;
+}>;
+declare const createJobSchema: z.ZodObject<{
+    targetId: z.ZodString;
+    capabilityId: z.ZodString;
+    artifactId: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodObject<{
+        functionName: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<["procedures", "strings"]>>;
+        mode: z.ZodOptional<z.ZodEnum<["literal", "regex"]>>;
+    }, "strict", z.ZodTypeAny, {
+        query?: string | undefined;
+        functionName?: string | undefined;
+        kind?: "procedures" | "strings" | undefined;
+        mode?: "literal" | "regex" | undefined;
+    }, {
+        query?: string | undefined;
+        functionName?: string | undefined;
+        kind?: "procedures" | "strings" | undefined;
+        mode?: "literal" | "regex" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    targetId: string;
+    capabilityId: string;
+    input?: {
+        query?: string | undefined;
+        functionName?: string | undefined;
+        kind?: "procedures" | "strings" | undefined;
+        mode?: "literal" | "regex" | undefined;
+    } | undefined;
+    artifactId?: string | undefined;
+}, {
+    targetId: string;
+    capabilityId: string;
+    input?: {
+        query?: string | undefined;
+        functionName?: string | undefined;
+        kind?: "procedures" | "strings" | undefined;
+        mode?: "literal" | "regex" | undefined;
+    } | undefined;
+    artifactId?: string | undefined;
+}>;
+declare const findingsSearchSchema: z.ZodObject<{
+    targetId: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<["technology", "route", "network_endpoint", "module", "asset", "storage", "native_procedure", "native_string", "risk", "limitation"]>, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    targetId: string;
+    query?: string | undefined;
+    types?: ("technology" | "route" | "network_endpoint" | "module" | "asset" | "storage" | "native_procedure" | "native_string" | "risk" | "limitation")[] | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    targetId: string;
+    query?: string | undefined;
+    types?: ("technology" | "route" | "network_endpoint" | "module" | "asset" | "storage" | "native_procedure" | "native_string" | "risk" | "limitation")[] | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+declare const evidenceListSchema: z.ZodObject<{
+    targetId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    targetId: string;
+}, {
+    targetId: string;
+}>;
+declare const capabilitiesListSchema: z.ZodOptional<z.ZodObject<{
+    targetId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    targetId?: string | undefined;
+}, {
+    targetId?: string | undefined;
+}>>;
+declare const targetIdSchema: z.ZodObject<{
+    targetId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    targetId: string;
+}, {
+    targetId: string;
+}>;
+declare const jobIdSchema: z.ZodObject<{
+    jobId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    jobId: string;
+}, {
+    jobId: string;
+}>;
+declare const terminalStartSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"ipatool-auth">;
+}, "strip", z.ZodTypeAny, {
+    kind: "ipatool-auth";
+}, {
+    kind: "ipatool-auth";
+}>;
+declare const terminalInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    data: string;
+}, {
+    sessionId: string;
+    data: string;
+}>;
+declare const terminalStopSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+}, {
+    sessionId: string;
+}>;
+declare const accountStatusSchema: z.ZodObject<{
+    force: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    force?: boolean | undefined;
+}, {
+    force?: boolean | undefined;
+}>;
+declare const accountCheckSchema: z.ZodEffects<z.ZodObject<{
+    appId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    bundleId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    appId?: string | number | undefined;
+    bundleId?: string | undefined;
+}, {
+    appId?: string | number | undefined;
+    bundleId?: string | undefined;
+}>, {
+    appId?: string | number | undefined;
+    bundleId?: string | undefined;
+}, {
+    appId?: string | number | undefined;
+    bundleId?: string | undefined;
+}>;
+declare function parseAppStoreId(input: string): {
+    appId: number;
+    country: string;
+} | null;
+
+export { type AccountEntitlements, type AccountStatus, type AnalysisRunRecord, type ArtifactRecord, CHANNELS, type CapabilityDescriptor, type CoreError, type CoreEvent, type CoreRequest, type CoreResponse, type EntitlementCheck, type EntitlementRecord, type EvidenceRecord, type FindingConfidence, type FindingRecord, type FindingSearchResult, type FindingType, type HealthInfo, type HostPlatform, type JobEvent, type JobRecord, type JobStatus, type PackageFormat, type ResolveResult, type ResolvedTarget, type SourceDescriptor, type SourceId, type TargetDetail, type TargetPlatform, type TargetRecord, type TargetRef, type ToolInfo, accountCheckSchema, accountStatusSchema, capabilitiesListSchema, createJobSchema, createTargetSchema, evidenceListSchema, findingsSearchSchema, jobIdSchema, parseAppStoreId, resolveInputSchema, targetIdSchema, terminalInputSchema, terminalStartSchema, terminalStopSchema };