@guanjinke/artifact-client 1.5.1 → 1.6.1

package/dist/web/types.d.ts

@@ -0,0 +1,82 @@
+import { EnvironmentRecord, RunMode } from '../environment/registry';
+import { EnvironmentClient, EnvironmentOptions, EnvironmentPlan, EnvironmentProgress, EnvironmentResult } from '../environment/types';
+import { ModuleUpdateSpec, UpdateResult } from '../environment/update';
+/** Cloud provider selected for artifact resolution; the same names as the CLI command groups. */
+export type Provider = 'az' | 'oss';
+export type EnvironmentRow = EnvironmentRecord & {
+    observedState: string;
+    problem?: string;
+};
+/**
+ * The slice of `EnvironmentManager` the web layer uses.
+ *
+ * Declared structurally so tests and the API can be exercised with fakes, and so
+ * the server never depends on process/registry adapters it does not need.
+ */
+export interface WebManager {
+    list(): Promise<EnvironmentRow[]>;
+    create(name: string, options: EnvironmentOptions, clientFactory: () => EnvironmentClient, onProgress?: EnvironmentProgress): Promise<EnvironmentPlan | EnvironmentResult>;
+    delete(name: string, confirm: (entry: EnvironmentRecord) => Promise<boolean>): Promise<boolean>;
+    start(name: string, mode: RunMode): Promise<void>;
+    stop(name: string): Promise<void>;
+    restart(name: string, mode?: RunMode): Promise<void>;
+}
+/** The slice of `EnvironmentUpdater` the web layer uses. */
+export interface WebUpdater {
+    update(name: string, specs: (ModuleUpdateSpec | string)[], clientFactory: () => EnvironmentClient, options?: {
+        dryRun?: boolean;
+        onProgress?: EnvironmentProgress;
+    }): Promise<UpdateResult>;
+}
+/** The slice of `EnvironmentRegistry` the web layer uses. */
+export interface WebRegistry {
+    get(name: string): Promise<EnvironmentRecord>;
+    read(): Promise<EnvironmentRecord[]>;
+}
+/** What the page may show about configured credentials: never a secret. */
+export interface ProviderInfo {
+    az?: {
+        container: string | null;
+    };
+    oss?: {
+        bucket: string | null;
+        region: string | null;
+    };
+}
+/** Credentials a browser may submit; validated and stored, never echoed back. */
+export interface SubmittedCredentials {
+    sasUrl?: string;
+    keyId?: string;
+    key?: string;
+    bucket?: string;
+    region?: string;
+}
+/**
+ * Stored-credential access.
+ *
+ * The page can *write* credentials (so a fresh machine needs no terminal) but
+ * can never read them back: `available` and `info` expose only non-secret facts,
+ * the same profile the CLI's `az login`/`oss login` use.
+ */
+export interface WebProviders {
+    /** Which providers have usable stored credentials. */
+    available(): {
+        az: boolean;
+        oss: boolean;
+    };
+    /** Build the artifact client for a provider; throws with an actionable message when unconfigured. */
+    client(provider: Provider): EnvironmentClient;
+    /** Non-secret details of what is stored, for display in the settings dialog. */
+    info(): ProviderInfo;
+    /** Validate and persist one provider's credentials. */
+    save(provider: Provider, credentials: SubmittedCredentials): Promise<void>;
+    /** Forget one provider's credentials. */
+    clear(provider: Provider): Promise<void>;
+}
+/** Static facts shown in the page header. */
+export interface WebStateInfo {
+    environmentRoot: string | null;
+    version: string;
+    platform: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web/types.d.ts.map

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

package/dist/web/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/web/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanjinke/artifact-client",
-  "version": "1.5.1",
+  "version": "1.6.1",
   "description": "Artifact management client and CLI for Azure Storage and Aliyun OSS",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,8 @@
     "dist/"
   ],
   "scripts": {
-    "build": "tsc && node -e \"process.platform !== 'win32' && require('fs').chmodSync('dist/cli.js', '755')\"",
+    "build": "tsc && tsc -p tsconfig.web.json && node scripts/build-web.js && node -e \"process.platform !== 'win32' && require('fs').chmodSync('dist/cli.js', '755')\"",
+    "build:web": "tsc -p tsconfig.web.json && node scripts/build-web.js",
     "test": "jest",
     "test:watch": "jest --watch"
   },
@@ -37,10 +38,16 @@
   "devDependencies": {
     "@types/jest": "^29.5.12",
     "@types/node": "^20.14.0",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
     "@types/semver": "^7.5.8",
     "@types/yauzl": "^3.4.0",
     "@types/yazl": "^3.3.1",
+    "esbuild": "^0.24.2",
     "jest": "^29.7.0",
+    "jsdom": "^20.0.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "ts-jest": "^29.2.0",
     "typescript": "^5.5.0",
     "yazl": "^3.3.1"