@aigne/afs-gcs 1.11.0-beta.10

package/LICENSE.md

@@ -0,0 +1,26 @@
+# Proprietary License
+
+Copyright (c) 2024-2025 ArcBlock, Inc. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. Unauthorized copying, modification, distribution, or use of
+this Software, via any medium, is strictly prohibited.
+
+The Software is provided for internal use only within ArcBlock, Inc. and its
+authorized affiliates.
+
+## No License Granted
+
+No license, express or implied, is granted to any party for any purpose.
+All rights are reserved by ArcBlock, Inc.
+
+## Public Artifact Distribution
+
+Portions of this Software may be released publicly under separate open-source
+licenses (such as MIT License) through designated public repositories. Such
+public releases are governed by their respective licenses and do not affect
+the proprietary nature of this repository.
+
+## Contact
+
+For licensing inquiries, contact: legal@arcblock.io

package/dist/index.d.mts

@@ -0,0 +1,193 @@
+import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSSearchResult, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, ProviderManifest, RouteContext } from "@aigne/afs";
+import { z } from "zod";
+
+//#region src/types.d.ts
+/**
+ * Configuration options for AFSGCS
+ */
+interface AFSGCSOptions {
+  /** Module name (used as mount path segment) */
+  name?: string;
+  /** Module description */
+  description?: string;
+  /** GCS bucket name */
+  bucket: string;
+  /** Key prefix (optional) */
+  prefix?: string;
+  /** GCP project ID */
+  projectId?: string;
+  /** Access mode */
+  accessMode?: "readonly" | "readwrite";
+  /** Custom endpoint for GCS-compatible services (fake-gcs-server) */
+  endpoint?: string;
+  /** Path to service account key file */
+  keyFilename?: string;
+  /** Explicit credentials (for programmatic access) */
+  credentials?: {
+    clientEmail: string;
+    privateKey: string;
+  };
+  /** Cache TTL in seconds (0 = no cache) */
+  cacheTtl?: number;
+}
+/**
+ * Parsed GCS URI
+ */
+interface ParsedGCSUri {
+  bucket: string;
+  prefix: string;
+}
+//#endregion
+//#region src/gcs-afs.d.ts
+/**
+ * AFSGCS Provider using Base Provider pattern
+ *
+ * Provides access to Google Cloud Storage through AFS.
+ * Uses decorator routing (@List, @Read, @Write, @Delete, @Meta, @Actions).
+ *
+ * @example
+ * ```typescript
+ * const gcs = new AFSGCS({
+ *   bucket: "my-bucket",
+ *   prefix: "data",
+ *   projectId: "my-project",
+ * });
+ *
+ * // Mount to AFS
+ * afs.mount(gcs);
+ *
+ * // List objects
+ * const result = await afs.list("/modules/my-bucket/data");
+ *
+ * // Read object
+ * const content = await afs.read("/modules/my-bucket/data/file.json");
+ * ```
+ */
+declare class AFSGCS extends AFSBaseProvider {
+  readonly name: string;
+  readonly description?: string;
+  readonly accessMode: AFSAccessMode;
+  private options;
+  private storage;
+  private bucket;
+  private listCache?;
+  private statCache?;
+  constructor(options: AFSGCSOptions & {
+    uri?: string;
+    token?: string;
+    auth?: unknown;
+  });
+  /**
+   * Schema for configuration validation
+   */
+  static schema(): z.ZodType<{
+    name: string | undefined;
+    description: string | undefined;
+    bucket: string;
+    prefix: string | undefined;
+    projectId: string | undefined;
+    accessMode: "readonly" | "readwrite" | undefined;
+    endpoint: string | undefined;
+    keyFilename: string | undefined;
+    credentials: {
+      clientEmail: string;
+      privateKey: string;
+    } | undefined;
+    cacheTtl: number | undefined;
+  }, unknown, z.core.$ZodTypeInternals<{
+    name: string | undefined;
+    description: string | undefined;
+    bucket: string;
+    prefix: string | undefined;
+    projectId: string | undefined;
+    accessMode: "readonly" | "readwrite" | undefined;
+    endpoint: string | undefined;
+    keyFilename: string | undefined;
+    credentials: {
+      clientEmail: string;
+      privateKey: string;
+    } | undefined;
+    cacheTtl: number | undefined;
+  }, unknown>>;
+  /**
+   * Provider manifest for URI-based discovery
+   */
+  static manifest(): ProviderManifest;
+  /**
+   * Load from configuration file
+   */
+  static load({
+    basePath,
+    config
+  }?: AFSModuleLoadParams): Promise<AFSGCS>;
+  /**
+   * Build the full GCS key from a path
+   */
+  private buildGCSKey;
+  /**
+   * Generate a unique ID for a GCS object
+   */
+  private generateId;
+  /**
+   * Invalidate caches for a given path
+   */
+  private invalidateCache;
+  /**
+   * Clear all caches
+   */
+  clearCache(): void;
+  listHandler(ctx: RouteContext<{
+    path?: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List with delimiter (single level)
+   */
+  private listWithDelimiter;
+  listVersionsHandler(ctx: RouteContext<{
+    path: string;
+  }>): Promise<AFSListResult>;
+  readHandler(ctx: RouteContext<{
+    path: string;
+  }>): Promise<AFSEntry>;
+  readVersionHandler(ctx: RouteContext<{
+    path: string;
+    generation: string;
+  }>): Promise<AFSEntry>;
+  metaHandler(ctx: RouteContext<{
+    path?: string;
+  }>): Promise<AFSEntry>;
+  statHandler(ctx: RouteContext<{
+    path?: string;
+  }>): Promise<AFSStatResult>;
+  writeHandler(ctx: RouteContext<{
+    path: string;
+  }>, payload: AFSWriteEntryPayload): Promise<AFSWriteResult>;
+  deleteHandler(ctx: RouteContext<{
+    path: string;
+  }>): Promise<AFSDeleteResult>;
+  listActionsHandler(ctx: RouteContext<{
+    path: string;
+  }>): Promise<AFSListResult>;
+  signDownloadActionHandler(ctx: RouteContext<{
+    path: string;
+  }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  signUploadActionHandler(ctx: RouteContext<{
+    path: string;
+  }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  composeActionHandler(ctx: RouteContext<{
+    path: string;
+  }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  rewriteActionHandler(ctx: RouteContext<{
+    path: string;
+  }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  explainHandler(ctx: RouteContext<{
+    path?: string;
+  }>): Promise<AFSExplainResult>;
+  searchHandler(ctx: RouteContext<{
+    path?: string;
+  }>, query: string): Promise<AFSSearchResult>;
+  readCapabilities(_ctx: RouteContext): Promise<AFSEntry>;
+}
+//#endregion
+export { AFSGCS, AFSGCS as default, type AFSGCSOptions, type ParsedGCSUri };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/gcs-afs.ts"],"mappings":";;;;AAUA;;;AAAA,UAAiB,aAAA;EAEf;EAAA,IAAA;EAMA;EAHA,WAAA;EASA;EANA,MAAA;EAYA;EATA,MAAA;EAeA;EAZA,SAAA;EAcE;EAXF,UAAA;EAeQ;EAZR,QAAA;EAmEe;EAhEf,WAAA;;EAGA,WAAA;IACE,WAAA;IACA,UAAA;EAAA;;EAIF,QAAA;AAAA;;;;UAuDe,YAAA;EACf,MAAA;EACA,MAAA;AAAA;;;;;;;;;;;;;;;;AAFF;;;;;;;;ACZA;;;cAAa,MAAA,SAAe,eAAA;EAAA,SACR,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA,EAAY,aAAA;EAAA,QAEtB,OAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,QACA,SAAA;cAEI,OAAA,EAAS,aAAA;IAAkB,GAAA;IAAc,KAAA;IAAgB,IAAA;EAAA;EAwSG;;;EAAA,OAtQjE,MAAA,CAAA,GAAM,CAAA,CAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAu4BN;;;EAAA,OAh4BA,QAAA,CAAA,GAAY,gBAAA;EAk7BZ;;;EAAA,OA95BM,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAA2B,OAAA,CAAQ,MAAA;EAm9BjD;;;EAAA,QAz8BlB,WAAA;EAkiCG;;;EAAA,QA1hCH,UAAA;EAmkCoC;;;EAAA,QA3jCpC,eAAA;EAlGkB;;;EAmH1B,UAAA,CAAA;EASM,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,aAAA;EArHzD;;;EAAA,QAwLM,iBAAA;EAoHR,mBAAA,CAAoB,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAkB,OAAA,CAAQ,aAAA;EAgDlE,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAkB,OAAA,CAAQ,QAAA;EA8H1D,kBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;IAAc,UAAA;EAAA,KACjC,OAAA,CAAQ,QAAA;EA0CL,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,QAAA;EAmJ3D,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,aAAA;EAuB3D,YAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,OAAA,EAAS,oBAAA,GACR,OAAA,CAAQ,cAAA;EAiEL,aAAA,CAAc,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAkB,OAAA,CAAQ,eAAA;EA4C5D,kBAAA,CAAmB,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAkB,OAAA,CAAQ,aAAA;EAgFjE,yBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,IAAA,EAAM,MAAA,oBACL,OAAA,CAAQ,aAAA;EA0BL,uBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,IAAA,EAAM,MAAA,oBACL,OAAA,CAAQ,aAAA;EA4BL,oBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,IAAA,EAAM,MAAA,oBACL,OAAA,CAAQ,aAAA;EA+CL,oBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,IAAA,EAAM,MAAA,oBACL,OAAA,CAAQ,aAAA;EAmDL,cAAA,CAAe,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,gBAAA;EAsF9D,aAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,KAAA,WACC,OAAA,CAAQ,eAAA;EAyCL,gBAAA,CAAiB,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,QAAA;AAAA"}