@aigne/afs-gce 1.11.0-beta.6 → 1.11.0-beta.7

package/dist/index.d.mts

@@ -1,5 +1,6 @@
+import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, RouteContext } from "@aigne/afs";
+import * as zod0 from "zod";
 import { z } from "zod";
-import { AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult } from "@aigne/afs";
 
 //#region src/types.d.ts
 /**
@@ -84,53 +85,164 @@ declare const afsgceOptionsSchema: z.ZodEffects<z.ZodObject<{
 //#endregion
 //#region src/index.d.ts
 /**
- * AFS GCE Provider
+ * AFSGCE Provider using AFSBaseProvider pattern
  *
- * Provides a file-system-like interface to GCE instances.
+ * Provides file-system-like access to GCE instances.
+ * Uses decorator routing (@List, @Read, @Write, @Delete, @Meta, @Actions, @Explain).
  *
  * @example
  * ```typescript
- * const provider = new AFSGCE({
- *   projectId: 'my-project',
- *   zone: 'us-central1-a',
+ * const gce = new AFSGCE({
+ *   projectId: "my-project",
+ *   zone: "us-central1-a",
  * });
  *
- * // List instances
- * const instances = await provider.list('/instances');
+ * // Mount to AFS
+ * afs.mount(gce);
  *
- * // Get instance metadata
- * const metadata = await provider.read('/instances/my-vm/metadata.json');
+ * // List instances
+ * const result = await afs.list("/modules/gce/instances");
  *
- * // Start an instance (requires readwrite mode)
- * await provider.write('/instances/my-vm/actions/start', {});
+ * // Read instance metadata
+ * const meta = await afs.read("/modules/gce/instances/my-vm/metadata.json");
  * ```
  */
-declare class AFSGCE implements AFSModule {
+declare class AFSGCE extends AFSBaseProvider {
   readonly name: string;
   readonly description?: string;
-  readonly accessMode: "readonly" | "readwrite";
+  readonly accessMode: AFSAccessMode;
   private readonly client;
   private readonly projectId;
   private readonly zone;
   constructor(options: AFSGCEOptions);
-  /**
-   * List GCE resources
-   */
-  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
-  /**
-   * Get metadata for a GCE resource
-   */
-  stat(path: string): Promise<AFSStatResult>;
-  /**
-   * Read GCE resource data
-   */
-  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
-  /**
-   * Write/execute action on GCE resource
-   *
-   * In GCE, write is used to execute actions (start, stop, reset)
-   */
-  write(path: string, _content: AFSWriteEntryPayload, _options?: AFSWriteOptions): Promise<AFSWriteResult>;
+  static schema(): zod0.ZodEffects<zod0.ZodObject<{
+    name: zod0.ZodType<string | undefined, zod0.ZodTypeDef, string | undefined>;
+    description: zod0.ZodType<string | undefined, zod0.ZodTypeDef, string | undefined>;
+    projectId: zod0.ZodString;
+    zone: zod0.ZodString;
+    accessMode: zod0.ZodType<"readonly" | "readwrite" | undefined, zod0.ZodTypeDef, "readonly" | "readwrite" | undefined>;
+    keyFilename: zod0.ZodType<string | undefined, zod0.ZodTypeDef, string | undefined>;
+    credentials: zod0.ZodType<{
+      clientEmail: string;
+      privateKey: string;
+    } | undefined, zod0.ZodTypeDef, {
+      clientEmail: string;
+      privateKey: string;
+    } | undefined>;
+    cacheTtl: zod0.ZodType<number | undefined, zod0.ZodTypeDef, number | undefined>;
+  }, "strict", zod0.ZodTypeAny, {
+    projectId: string;
+    zone: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    accessMode?: "readonly" | "readwrite" | undefined;
+    keyFilename?: string | undefined;
+    credentials?: {
+      clientEmail: string;
+      privateKey: string;
+    } | undefined;
+    cacheTtl?: number | undefined;
+  }, {
+    projectId: string;
+    zone: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    accessMode?: "readonly" | "readwrite" | undefined;
+    keyFilename?: string | undefined;
+    credentials?: {
+      clientEmail: string;
+      privateKey: string;
+    } | undefined;
+    cacheTtl?: number | undefined;
+  }>, {
+    projectId: string;
+    zone: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    accessMode?: "readonly" | "readwrite" | undefined;
+    keyFilename?: string | undefined;
+    credentials?: {
+      clientEmail: string;
+      privateKey: string;
+    } | undefined;
+    cacheTtl?: number | undefined;
+  }, any>;
+  static load({
+    basePath,
+    config
+  }?: AFSModuleLoadParams): Promise<AFSGCE>;
+  private getInstance;
+  private listAllInstances;
+  private buildInstanceEntry;
+  listRoot(_ctx: RouteContext): Promise<AFSListResult>;
+  listInstances(_ctx: RouteContext): Promise<AFSListResult>;
+  listInstanceChildren(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>): Promise<AFSListResult>;
+  listInstanceLabels(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>): Promise<AFSListResult>;
+  listByStatus(_ctx: RouteContext): Promise<AFSListResult>;
+  listByStatusFilter(ctx: RouteContext<{
+    status: string;
+  }>): Promise<AFSListResult>;
+  readCapabilities(_ctx: RouteContext): Promise<AFSEntry>;
+  readInstanceMetadata(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>): Promise<AFSEntry>;
+  readInstanceLabel(ctx: RouteContext<{
+    instanceId: string;
+    labelKey: string;
+    status?: string;
+  }>): Promise<AFSEntry>;
+  metaRoot(ctx: RouteContext): Promise<AFSEntry>;
+  metaInstances(ctx: RouteContext): Promise<AFSEntry>;
+  metaInstance(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>): Promise<AFSEntry>;
+  statRoot(ctx: RouteContext): Promise<AFSStatResult>;
+  statInstances(ctx: RouteContext): Promise<AFSStatResult>;
+  statInstance(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>): Promise<AFSStatResult>;
+  writeInstanceLabel(ctx: RouteContext<{
+    instanceId: string;
+    labelKey: string;
+    status?: string;
+  }>, payload: AFSWriteEntryPayload): Promise<AFSWriteResult>;
+  deleteInstanceLabel(ctx: RouteContext<{
+    instanceId: string;
+    labelKey: string;
+    status?: string;
+  }>): Promise<AFSDeleteResult>;
+  listGlobalActions(ctx: RouteContext): Promise<AFSListResult>;
+  refreshAction(_ctx: RouteContext, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  listInstanceActions(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>): Promise<AFSListResult>;
+  startInstanceAction(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  stopInstanceAction(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  resetInstanceAction(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>, _args: Record<string, unknown>): Promise<AFSExecResult>;
+  explainRoot(_ctx: RouteContext): Promise<AFSExplainResult>;
+  explainInstance(ctx: RouteContext<{
+    instanceId: string;
+    status?: string;
+  }>): Promise<AFSExplainResult>;
 }
 //#endregion
 export { AFSGCE, type AFSGCEOptions, afsgceOptionsSchema };

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/index.ts"],"mappings":";;;;AAUA;;;AAAA,UAAiB,aAAA;EAEf;EAAA,IAAA;EAMA;EAHA,WAAA;EASA;EANA,SAAA;EAYA;EATA,IAAA;EAWE;EARF,UAAA;EAYQ;EATR,WAAA;EAqBW;EAlBX,WAAA;IACE,WAAA;IACA,UAAA;EAAA;;EAIF,QAAA;AAAA;;;;cAYW,mBAAA,EAAmB,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAhC;;;;;;;;;cCAa,MAAA,YAAkB,SAAA;EAAA,SACpB,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;EAAA,iBAEQ,MAAA;EAAA,iBACA,SAAA;EAAA,iBACA,IAAA;cAEL,OAAA,EAAS,aAAA;;;;EAyBf,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EDlC9B;;;ECyCxB,IAAA,CAAK,IAAA,WAAe,OAAA,CAAQ,aAAA;EDzCJ;;;ECuDxB,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;;;;;;EAStD,KAAA,CACJ,IAAA,UACA,QAAA,EAAU,oBAAA,EACV,QAAA,GAAW,eAAA,GACV,OAAA,CAAQ,cAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/index.ts"],"mappings":"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"}