openxiangda-devkit-core 2.0.0-alpha.12

package/README.md

@@ -0,0 +1,12 @@
+# openxiangda-devkit-core
+
+Application services shared by the OpenXiangda 2.0 CLI and MCP server:
+
+- validate `openxiangda-app.config.ts`;
+- create a deterministic `WorkspaceContext`;
+- compile and digest an `AppPackage`;
+- negotiate platform capabilities;
+- upload immutable artifacts and create/query a durable `DeploymentRun`.
+- call the current application backend through the platform gateway with an explicit `RoleSession`.
+
+The package has no console, prompt or global process-state dependencies.

package/dist/application-services.d.ts

@@ -0,0 +1,229 @@
+import { type AppArtifact, type DeploymentRun, type DevkitResult, type Diagnostic, type WorkspaceIdentity } from "openxiangda-contracts";
+import { type CompiledAppPackage } from "openxiangda-compiler";
+import { OpenXiangdaControlPlaneClient, type CreateApplicationSecretInput, type CreateOAuthClientInput, type ControlPlaneClientOptions, type RotateApplicationSecretInput, type UpdateApplicationSecretInput, type UpdateOAuthClientInput } from "./control-plane-client.js";
+export interface GenerateOptions {
+    root?: string;
+    check?: boolean;
+}
+export interface BuildOptions {
+    root?: string;
+    backendImage?: string;
+    skipWorkspaceBuild?: boolean;
+    write?: boolean;
+}
+export interface BuiltApplication {
+    package: CompiledAppPackage;
+    outputDirectory?: string;
+}
+interface SealedApplication extends BuiltApplication {
+    artifactContent: Record<string, string>;
+}
+export interface DeployOptions extends BuildOptions {
+    environment: "development" | "preproduction" | "production";
+    environmentId?: string;
+    idempotencyKey?: string;
+    requestId?: string;
+}
+export declare class OpenXiangdaApplicationServices {
+    private readonly options;
+    constructor(options?: {
+        toolchainVersion?: string;
+        client?: OpenXiangdaControlPlaneClient;
+        clientOptions?: ControlPlaneClientOptions;
+    });
+    workspaceContext(root?: string): Promise<DevkitResult<import("openxiangda-contracts").WorkspaceContext>>;
+    contractDescribe(root?: string): Promise<DevkitResult<{
+        configDigest: string;
+        contractDigest: string;
+        contract: import("openxiangda-compiler").ContractBundleV2;
+        counts: {
+            backendSecrets: number;
+            dataResources: number;
+            eventSubscriptions: number;
+            timerSubscriptions: number;
+            workflowDefinitions: number;
+            workflowBindings: number;
+            workflowProviders: number;
+        };
+    }>>;
+    platformCapabilities(root?: string): Promise<DevkitResult<import("openxiangda-contracts").PlatformCapabilities>>;
+    provisionApplication(root?: string): Promise<DevkitResult<import("openxiangda-contracts").ProvisionedApplication>>;
+    oauthClients(root?: string): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").OAuthClient[];
+        total: number;
+        reservedScopes: string[];
+        appCapabilityScopePrefix: string;
+    }>>;
+    runtimeOAuthCredentialStatus(root: string | undefined, environmentKey: string): Promise<DevkitResult<import("openxiangda-contracts").RuntimeOAuthCredentialStatus>>;
+    rotateRuntimeOAuthCredential(root: string | undefined, input: {
+        environmentKey: string;
+        gracePeriodSeconds?: number;
+        idempotencyKey: string;
+    }): Promise<DevkitResult<{
+        rotation: import("openxiangda-contracts").RuntimeOAuthCredentialStatus;
+        deployment: DeploymentRun;
+        next: {
+            command: string;
+            credentialActivatesDuringDeployment: boolean;
+        };
+    }>>;
+    createOAuthClient(root: string | undefined, input: CreateOAuthClientInput): Promise<DevkitResult<import("./control-plane-client.js").OAuthClientSecretResult>>;
+    updateOAuthClient(root: string | undefined, clientId: string, input: UpdateOAuthClientInput): Promise<DevkitResult<import("openxiangda-contracts").OAuthClient>>;
+    rotateOAuthClientSecret(root: string | undefined, clientId: string, gracePeriodSeconds?: number): Promise<DevkitResult<import("./control-plane-client.js").OAuthClientSecretResult>>;
+    revokeOAuthClient(root: string | undefined, clientId: string): Promise<DevkitResult<import("openxiangda-contracts").OAuthClient>>;
+    oauthAuditEvents(root: string | undefined, input?: {
+        environmentKey?: string;
+        clientId?: string;
+        limit?: number;
+    }): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").OAuthAuditEvent[];
+        limit: number;
+    }>>;
+    applicationSecrets(root: string | undefined, environmentKey: string): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").ApplicationSecret[];
+        total: number;
+    }>>;
+    createApplicationSecret(root: string | undefined, environmentKey: string, input: CreateApplicationSecretInput): Promise<DevkitResult<import("openxiangda-contracts").ApplicationSecret>>;
+    updateApplicationSecret(root: string | undefined, environmentKey: string, name: string, input: UpdateApplicationSecretInput): Promise<DevkitResult<import("openxiangda-contracts").ApplicationSecret>>;
+    rotateApplicationSecret(root: string | undefined, environmentKey: string, name: string, input: RotateApplicationSecretInput): Promise<DevkitResult<import("openxiangda-contracts").ApplicationSecret>>;
+    deleteApplicationSecret(root: string | undefined, environmentKey: string, name: string, input: {
+        expectedRevision: number;
+        reason?: string;
+    }): Promise<DevkitResult<import("openxiangda-contracts").ApplicationSecret>>;
+    applicationSecretAuditEvents(root: string | undefined, environmentKey: string, name: string, limit?: number): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").ApplicationSecretAuditEvent[];
+    }>>;
+    eventSubscriptions(root?: string): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").EventSubscription[];
+    }>>;
+    setEventSubscriptionStatus(root: string | undefined, subscriptionId: string, input: {
+        expectedRevision: number;
+        status: "active" | "paused";
+    }): Promise<DevkitResult<import("openxiangda-contracts").EventSubscription>>;
+    rotateEventSubscriptionSecret(root: string | undefined, subscriptionId: string, input: {
+        expectedRevision: number;
+        idempotencyKey: string;
+        gracePeriodSeconds?: number;
+    }): Promise<DevkitResult<import("openxiangda-contracts").EventSubscription>>;
+    eventDeliveries(root: string | undefined, limit?: number): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").EventDelivery[];
+    }>>;
+    replayEventDelivery(root: string | undefined, deliveryId: string, idempotencyKey?: string): Promise<DevkitResult<import("openxiangda-contracts").EventDelivery>>;
+    timerSubscriptions(root?: string): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").TimerSubscription[];
+    }>>;
+    setTimerSubscriptionStatus(root: string | undefined, timerId: string, input: {
+        expectedRevision: number;
+        status: "active" | "paused";
+    }): Promise<DevkitResult<import("openxiangda-contracts").TimerSubscription>>;
+    workflowAssigneeProviders(root: string | undefined, environmentKey: string): Promise<DevkitResult<{
+        items: import("openxiangda-contracts").WorkflowAssigneeProvider[];
+    }>>;
+    rotateWorkflowAssigneeProviderSecret(root: string | undefined, providerCode: string, input: {
+        environmentKey: string;
+        expectedRevision: number;
+        idempotencyKey: string;
+    }): Promise<DevkitResult<import("openxiangda-contracts").WorkflowAssigneeProvider>>;
+    linkApplication(root: string | undefined, input: {
+        baseUrl: string;
+        environments?: Array<{
+            id?: string;
+            name: string;
+            kind: "development" | "preproduction" | "production";
+        }>;
+    }): Promise<DevkitResult<{
+        schemaVersion: number;
+        appCode: string;
+        baseUrl: string;
+        environments: {
+            id?: string;
+            name: string;
+            kind: "development" | "preproduction" | "production";
+        }[];
+        path: string;
+    }>>;
+    generate(input?: GenerateOptions): Promise<DevkitResult<{
+        output: string;
+        changed: boolean;
+        contractDigest: string;
+    }>>;
+    check(root?: string): Promise<DevkitResult<{
+        stages: {
+            ok: boolean;
+            exitCode: number;
+            output: string;
+            name: string;
+        }[];
+    }>>;
+    test(root?: string): Promise<DevkitResult<{
+        ok: boolean;
+        exitCode: number;
+        output: string;
+    }>>;
+    build(input?: BuildOptions): Promise<DevkitResult<BuiltApplication>>;
+    private buildSealed;
+    deploymentPlan(input: BuildOptions & {
+        environment: string;
+    }): Promise<DevkitResult<BuiltApplication> | {
+        operation: string;
+        data: {
+            environment: string;
+            packageDigest: string;
+            appCode: string;
+            artifacts: AppArtifact[];
+            requiredCapabilities: string[];
+        };
+        ok: boolean;
+        workspace: WorkspaceIdentity;
+        diagnostics: Diagnostic[];
+        nextActions: import("openxiangda-contracts").NextAction[];
+        traceId?: string;
+    }>;
+    deploy(input: DeployOptions): Promise<DevkitResult<SealedApplication> | DevkitResult<undefined> | DevkitResult<DeploymentRun>>;
+    deploymentStatus(root: string | undefined, deploymentId?: string): Promise<DevkitResult<DeploymentRun | {
+        items: DeploymentRun[];
+        total: number;
+    }>>;
+    deploymentLogs(root: string | undefined, deploymentId: string): Promise<{
+        operation: string;
+        data: {
+            deploymentId: string;
+            status: import("openxiangda-contracts").DeploymentStatus;
+            stage: string;
+            checkpoints: import("openxiangda-contracts").DeploymentCheckpoint[];
+            failure: import("openxiangda-contracts").DeploymentFailure | undefined;
+            traceId: unknown;
+        };
+        ok: boolean;
+        workspace: WorkspaceIdentity;
+        diagnostics: Diagnostic[];
+        nextActions: import("openxiangda-contracts").NextAction[];
+        traceId?: string;
+    }>;
+    retry(root: string | undefined, deploymentId: string): Promise<DevkitResult<DeploymentRun>>;
+    cancel(root: string | undefined, deploymentId: string): Promise<DevkitResult<DeploymentRun>>;
+    promote(root: string | undefined, deploymentId: string, environment: "preproduction" | "production"): Promise<DevkitResult<DeploymentRun>>;
+    rollback(root: string | undefined, environment: "development" | "preproduction" | "production", appVersionId: string): Promise<DevkitResult<DeploymentRun>>;
+    doctor(root?: string): Promise<DevkitResult<{
+        commands: {
+            command: string;
+            ok: boolean;
+            version: string;
+        }[];
+        platform: Record<string, unknown>;
+    }>>;
+    dev(root?: string): Promise<DevkitResult<{
+        exitCode: number;
+    }>>;
+    private workspace;
+    private client;
+    private get toolchainVersion();
+    private runPackageScript;
+    private directoryBundle;
+    private versionTrainDiagnostics;
+    private diagnostic;
+    private ok;
+    private result;
+}
+export {};
+//# sourceMappingURL=application-services.d.ts.map

package/dist/application-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-services.d.ts","sourceRoot":"","sources":["../src/application-services.ts"],"names":[],"mappings":"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"}