hazo_files 2.0.0 → 2.1.1

package/dist/server/index.js

@@ -47,6 +47,7 @@ __export(index_exports, {
   FileTooLargeError: () => FileTooLargeError,
   GoogleDriveAuth: () => GoogleDriveAuth,
   GoogleDriveModule: () => GoogleDriveModule,
+  GoogleDriveProvider: () => GoogleDriveProvider,
   HAZO_FILES_DEFAULT_TABLE_NAME: () => HAZO_FILES_DEFAULT_TABLE_NAME,
   HAZO_FILES_JOB_TYPES: () => HAZO_FILES_JOB_TYPES,
   HAZO_FILES_MIGRATION_V2: () => HAZO_FILES_MIGRATION_V2,
@@ -59,6 +60,7 @@ __export(index_exports, {
   HAZO_FILE_QUOTAS_TABLE_SCHEMA: () => HAZO_FILE_QUOTAS_TABLE_SCHEMA,
   HazoFilesError: () => HazoFilesError,
   ImportSizeCapError: () => ImportSizeCapError,
+  InMemoryProvider: () => InMemoryProvider,
   InvalidExtensionError: () => InvalidExtensionError,
   InvalidPathError: () => InvalidPathError,
   LLMExtractionService: () => LLMExtractionService,
@@ -6554,6 +6556,194 @@ async function streamToBuffer(s) {
   return Buffer.concat(chunks);
 }
 
+// src/providers/in-memory.ts
+var InMemoryProvider = class {
+  constructor() {
+    this.provider_tag = "in_memory";
+    this.store = /* @__PURE__ */ new Map();
+  }
+  async put(path4, body, opts) {
+    if (opts?.ifNotExists && this.store.has(path4)) throw new Error(`File exists: ${path4}`);
+    const buf = Buffer.isBuffer(body) ? body : await streamToBuffer2(body);
+    this.store.set(path4, buf);
+    return { provider: this.provider_tag, native_id: path4, size: buf.length };
+  }
+  async get(path4) {
+    const buf = this.store.get(path4);
+    if (!buf) throw new Error(`Not found: ${path4}`);
+    return buf;
+  }
+  async delete(path4) {
+    this.store.delete(path4);
+  }
+  async exists(path4) {
+    return this.store.has(path4);
+  }
+  async getSignedUrl(path4, _opts) {
+    const buf = this.store.get(path4);
+    if (!buf) throw new Error(`Not found: ${path4}`);
+    return `data:application/octet-stream;base64,${buf.toString("base64")}`;
+  }
+  async probe() {
+    return { ok: true };
+  }
+  /** Test-only escape hatch — exposes the internal store for assertions. */
+  snapshot() {
+    return new Map(this.store);
+  }
+};
+async function streamToBuffer2(s) {
+  const chunks = [];
+  for await (const c of s) chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+  return Buffer.concat(chunks);
+}
+
+// src/providers/google-drive.ts
+var import_googleapis3 = require("googleapis");
+var GoogleDriveProvider = class {
+  constructor(opts) {
+    this.provider_tag = "gdrive";
+    let credentials = {};
+    try {
+      credentials = JSON.parse(opts.service_account_json);
+    } catch {
+    }
+    const auth = new import_googleapis3.google.auth.GoogleAuth({
+      credentials,
+      scopes: ["https://www.googleapis.com/auth/drive"]
+    });
+    this.drive = import_googleapis3.google.drive({ version: "v3", auth });
+    this.driveId = opts.shared_drive_id;
+    this.cache = opts.path_cache;
+  }
+  async probe() {
+    try {
+      await this.drive.drives.get({
+        driveId: this.driveId,
+        supportsAllDrives: true
+      });
+      return { ok: true };
+    } catch (err) {
+      const e = err;
+      if (e?.code === 404) return { ok: false, error: "drive_not_shared", message: "SA cannot see Shared Drive" };
+      if (e?.code === 403) return { ok: false, error: "write_denied", message: "SA lacks permission" };
+      return { ok: false, error: "transient", message: String(err) };
+    }
+  }
+  async put(path4, body, opts) {
+    const segments = path4.split("/").filter(Boolean);
+    const filename = segments.pop();
+    const parentId = await this.resolvePath(segments, { create: true });
+    if (opts?.ifNotExists) {
+      const existing = await this.findChild(filename, parentId);
+      if (existing) throw new Error(`File exists: ${path4}`);
+    }
+    const buf = Buffer.isBuffer(body) ? body : await streamToBuffer3(body);
+    const res = await this.drive.files.create({
+      requestBody: {
+        name: filename,
+        parents: [parentId],
+        mimeType: opts?.contentType ?? "application/octet-stream"
+      },
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      media: { body: buf },
+      fields: "id, name"
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+    return { provider: this.provider_tag, native_id: res.data.id, size: buf.length };
+  }
+  async get(path4) {
+    const id = await this.lookupFileId(path4);
+    const res = await this.drive.files.get(
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      { fileId: id, alt: "media", supportsAllDrives: true },
+      { responseType: "arraybuffer" }
+    );
+    return Buffer.from(res.data);
+  }
+  async delete(path4) {
+    try {
+      const id = await this.lookupFileId(path4);
+      await this.drive.files.delete({ fileId: id, supportsAllDrives: true });
+    } catch (err) {
+      const e = err;
+      if (e?.code !== 404) throw err;
+    }
+  }
+  async exists(path4) {
+    try {
+      await this.lookupFileId(path4);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async getSignedUrl(path4, _opts) {
+    const id = await this.lookupFileId(path4);
+    return `https://drive.google.com/uc?id=${id}&export=download`;
+  }
+  async resolvePath(segments, opts) {
+    let parentId = this.driveId;
+    const accumulated = [];
+    for (const segment of segments) {
+      accumulated.push(segment);
+      const cacheKey = accumulated.join("/");
+      const cached = await this.cache.lookup(cacheKey);
+      if (cached) {
+        parentId = cached;
+        continue;
+      }
+      let found = await this.findChild(segment, parentId, "application/vnd.google-apps.folder");
+      if (!found && opts.create) {
+        const created = await this.drive.files.create({
+          requestBody: {
+            name: segment,
+            parents: [parentId],
+            mimeType: "application/vnd.google-apps.folder"
+          },
+          fields: "id"
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+        found = created.data.id;
+      }
+      if (!found) throw new Error(`Folder not found and create=false: ${cacheKey}`);
+      await this.cache.write(cacheKey, found);
+      parentId = found;
+    }
+    return parentId;
+  }
+  async findChild(name, parentId, mimeType) {
+    const q = [
+      `name='${name.replace(/'/g, "\\'")}'`,
+      `'${parentId}' in parents`,
+      `trashed=false`
+    ];
+    if (mimeType) q.push(`mimeType='${mimeType}'`);
+    const res = await this.drive.files.list({
+      q: q.join(" and "),
+      driveId: this.driveId,
+      corpora: "drive",
+      includeItemsFromAllDrives: true,
+      fields: "files(id, name)"
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+    return res.data.files?.[0]?.id ?? null;
+  }
+  async lookupFileId(path4) {
+    const segments = path4.split("/").filter(Boolean);
+    const filename = segments.pop();
+    const parentId = await this.resolvePath(segments, { create: false });
+    const id = await this.findChild(filename, parentId);
+    if (!id) throw Object.assign(new Error(`Not found: ${path4}`), { code: 404 });
+    return id;
+  }
+};
+async function streamToBuffer3(s) {
+  const chunks = [];
+  for await (const c of s) chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+  return Buffer.concat(chunks);
+}
+
 // src/providers/types.ts
 var StorageCollisionExhausted = class extends Error {
   constructor(attempts, lastPath) {
@@ -6636,6 +6826,7 @@ try {
   FileTooLargeError,
   GoogleDriveAuth,
   GoogleDriveModule,
+  GoogleDriveProvider,
   HAZO_FILES_DEFAULT_TABLE_NAME,
   HAZO_FILES_JOB_TYPES,
   HAZO_FILES_MIGRATION_V2,
@@ -6648,6 +6839,7 @@ try {
   HAZO_FILE_QUOTAS_TABLE_SCHEMA,
   HazoFilesError,
   ImportSizeCapError,
+  InMemoryProvider,
   InvalidExtensionError,
   InvalidPathError,
   LLMExtractionService,

package/dist/server/index.mjs

@@ -6368,6 +6368,194 @@ async function streamToBuffer(s) {
   return Buffer.concat(chunks);
 }
 
+// src/providers/in-memory.ts
+var InMemoryProvider = class {
+  constructor() {
+    this.provider_tag = "in_memory";
+    this.store = /* @__PURE__ */ new Map();
+  }
+  async put(path4, body, opts) {
+    if (opts?.ifNotExists && this.store.has(path4)) throw new Error(`File exists: ${path4}`);
+    const buf = Buffer.isBuffer(body) ? body : await streamToBuffer2(body);
+    this.store.set(path4, buf);
+    return { provider: this.provider_tag, native_id: path4, size: buf.length };
+  }
+  async get(path4) {
+    const buf = this.store.get(path4);
+    if (!buf) throw new Error(`Not found: ${path4}`);
+    return buf;
+  }
+  async delete(path4) {
+    this.store.delete(path4);
+  }
+  async exists(path4) {
+    return this.store.has(path4);
+  }
+  async getSignedUrl(path4, _opts) {
+    const buf = this.store.get(path4);
+    if (!buf) throw new Error(`Not found: ${path4}`);
+    return `data:application/octet-stream;base64,${buf.toString("base64")}`;
+  }
+  async probe() {
+    return { ok: true };
+  }
+  /** Test-only escape hatch — exposes the internal store for assertions. */
+  snapshot() {
+    return new Map(this.store);
+  }
+};
+async function streamToBuffer2(s) {
+  const chunks = [];
+  for await (const c of s) chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+  return Buffer.concat(chunks);
+}
+
+// src/providers/google-drive.ts
+import { google as google3 } from "googleapis";
+var GoogleDriveProvider = class {
+  constructor(opts) {
+    this.provider_tag = "gdrive";
+    let credentials = {};
+    try {
+      credentials = JSON.parse(opts.service_account_json);
+    } catch {
+    }
+    const auth = new google3.auth.GoogleAuth({
+      credentials,
+      scopes: ["https://www.googleapis.com/auth/drive"]
+    });
+    this.drive = google3.drive({ version: "v3", auth });
+    this.driveId = opts.shared_drive_id;
+    this.cache = opts.path_cache;
+  }
+  async probe() {
+    try {
+      await this.drive.drives.get({
+        driveId: this.driveId,
+        supportsAllDrives: true
+      });
+      return { ok: true };
+    } catch (err) {
+      const e = err;
+      if (e?.code === 404) return { ok: false, error: "drive_not_shared", message: "SA cannot see Shared Drive" };
+      if (e?.code === 403) return { ok: false, error: "write_denied", message: "SA lacks permission" };
+      return { ok: false, error: "transient", message: String(err) };
+    }
+  }
+  async put(path4, body, opts) {
+    const segments = path4.split("/").filter(Boolean);
+    const filename = segments.pop();
+    const parentId = await this.resolvePath(segments, { create: true });
+    if (opts?.ifNotExists) {
+      const existing = await this.findChild(filename, parentId);
+      if (existing) throw new Error(`File exists: ${path4}`);
+    }
+    const buf = Buffer.isBuffer(body) ? body : await streamToBuffer3(body);
+    const res = await this.drive.files.create({
+      requestBody: {
+        name: filename,
+        parents: [parentId],
+        mimeType: opts?.contentType ?? "application/octet-stream"
+      },
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      media: { body: buf },
+      fields: "id, name"
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+    return { provider: this.provider_tag, native_id: res.data.id, size: buf.length };
+  }
+  async get(path4) {
+    const id = await this.lookupFileId(path4);
+    const res = await this.drive.files.get(
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      { fileId: id, alt: "media", supportsAllDrives: true },
+      { responseType: "arraybuffer" }
+    );
+    return Buffer.from(res.data);
+  }
+  async delete(path4) {
+    try {
+      const id = await this.lookupFileId(path4);
+      await this.drive.files.delete({ fileId: id, supportsAllDrives: true });
+    } catch (err) {
+      const e = err;
+      if (e?.code !== 404) throw err;
+    }
+  }
+  async exists(path4) {
+    try {
+      await this.lookupFileId(path4);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async getSignedUrl(path4, _opts) {
+    const id = await this.lookupFileId(path4);
+    return `https://drive.google.com/uc?id=${id}&export=download`;
+  }
+  async resolvePath(segments, opts) {
+    let parentId = this.driveId;
+    const accumulated = [];
+    for (const segment of segments) {
+      accumulated.push(segment);
+      const cacheKey = accumulated.join("/");
+      const cached = await this.cache.lookup(cacheKey);
+      if (cached) {
+        parentId = cached;
+        continue;
+      }
+      let found = await this.findChild(segment, parentId, "application/vnd.google-apps.folder");
+      if (!found && opts.create) {
+        const created = await this.drive.files.create({
+          requestBody: {
+            name: segment,
+            parents: [parentId],
+            mimeType: "application/vnd.google-apps.folder"
+          },
+          fields: "id"
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+        found = created.data.id;
+      }
+      if (!found) throw new Error(`Folder not found and create=false: ${cacheKey}`);
+      await this.cache.write(cacheKey, found);
+      parentId = found;
+    }
+    return parentId;
+  }
+  async findChild(name, parentId, mimeType) {
+    const q = [
+      `name='${name.replace(/'/g, "\\'")}'`,
+      `'${parentId}' in parents`,
+      `trashed=false`
+    ];
+    if (mimeType) q.push(`mimeType='${mimeType}'`);
+    const res = await this.drive.files.list({
+      q: q.join(" and "),
+      driveId: this.driveId,
+      corpora: "drive",
+      includeItemsFromAllDrives: true,
+      fields: "files(id, name)"
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+    return res.data.files?.[0]?.id ?? null;
+  }
+  async lookupFileId(path4) {
+    const segments = path4.split("/").filter(Boolean);
+    const filename = segments.pop();
+    const parentId = await this.resolvePath(segments, { create: false });
+    const id = await this.findChild(filename, parentId);
+    if (!id) throw Object.assign(new Error(`Not found: ${path4}`), { code: 404 });
+    return id;
+  }
+};
+async function streamToBuffer3(s) {
+  const chunks = [];
+  for await (const c of s) chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+  return Buffer.concat(chunks);
+}
+
 // src/providers/types.ts
 var StorageCollisionExhausted = class extends Error {
   constructor(attempts, lastPath) {
@@ -6449,6 +6637,7 @@ export {
   FileTooLargeError,
   GoogleDriveAuth,
   GoogleDriveModule,
+  GoogleDriveProvider,
   HAZO_FILES_DEFAULT_TABLE_NAME,
   HAZO_FILES_JOB_TYPES,
   HAZO_FILES_MIGRATION_V2,
@@ -6461,6 +6650,7 @@ export {
   HAZO_FILE_QUOTAS_TABLE_SCHEMA,
   HazoFilesError,
   ImportSizeCapError,
+  InMemoryProvider,
   InvalidExtensionError,
   InvalidPathError,
   LLMExtractionService,

package/dist/testing/index.d.mts

@@ -0,0 +1,62 @@
+import { Readable } from 'node:stream';
+
+type StoragePath = string;
+interface PutOpts {
+    /** Reject if the target path already exists (atomic). */
+    ifNotExists?: boolean;
+    /** Hint for content-type; provider may sniff if absent. */
+    contentType?: string;
+    /** Free-form key/value metadata persisted with the file when supported. */
+    metadata?: Record<string, string>;
+}
+interface PutResult {
+    /** Provider tag — `"app_file_server"`, `"gdrive"`, `"in_memory"`. */
+    provider: string;
+    /** Provider-native identifier (path for app-server; file ID for GDrive). */
+    native_id: string;
+    /** Size in bytes of the persisted body. */
+    size: number;
+}
+interface SignedUrlOpts {
+    /** Seconds the URL is valid for. */
+    ttl_seconds?: number;
+    /** Suggested download filename (Content-Disposition). */
+    filename_hint?: string;
+}
+interface ProbeResult {
+    ok: boolean;
+    /** Machine-readable error tag when ok=false. */
+    error?: "drive_not_shared" | "write_denied" | "invalid_id" | "transient" | "config_missing";
+    /** Free-form detail for logging. */
+    message?: string;
+}
+/**
+ * Storage provider abstraction. Every method MUST be idempotent at the
+ * data-content level — re-invoking put with identical body is allowed.
+ *
+ * Paths are logical; providers translate to native identifiers internally.
+ */
+interface FileStorageProvider {
+    put(path: StoragePath, body: Buffer | Readable, opts?: PutOpts): Promise<PutResult>;
+    get(path: StoragePath): Promise<Buffer | Readable>;
+    delete(path: StoragePath): Promise<void>;
+    exists(path: StoragePath): Promise<boolean>;
+    getSignedUrl(path: StoragePath, opts?: SignedUrlOpts): Promise<string>;
+    /** Used by validation cron + onboarding step 2. */
+    probe(): Promise<ProbeResult>;
+}
+
+declare class InMemoryProvider implements FileStorageProvider {
+    readonly provider_tag: "in_memory";
+    private readonly store;
+    put(path: string, body: Buffer | Readable, opts?: PutOpts): Promise<PutResult>;
+    get(path: string): Promise<Buffer>;
+    delete(path: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    getSignedUrl(path: string, _opts?: SignedUrlOpts): Promise<string>;
+    probe(): Promise<ProbeResult>;
+    /** Test-only escape hatch — exposes the internal store for assertions. */
+    snapshot(): Map<string, Buffer>;
+}
+
+export { InMemoryProvider };

package/dist/testing/index.d.ts

@@ -0,0 +1,62 @@
+import { Readable } from 'node:stream';
+
+type StoragePath = string;
+interface PutOpts {
+    /** Reject if the target path already exists (atomic). */
+    ifNotExists?: boolean;
+    /** Hint for content-type; provider may sniff if absent. */
+    contentType?: string;
+    /** Free-form key/value metadata persisted with the file when supported. */
+    metadata?: Record<string, string>;
+}
+interface PutResult {
+    /** Provider tag — `"app_file_server"`, `"gdrive"`, `"in_memory"`. */
+    provider: string;
+    /** Provider-native identifier (path for app-server; file ID for GDrive). */
+    native_id: string;
+    /** Size in bytes of the persisted body. */
+    size: number;
+}
+interface SignedUrlOpts {
+    /** Seconds the URL is valid for. */
+    ttl_seconds?: number;
+    /** Suggested download filename (Content-Disposition). */
+    filename_hint?: string;
+}
+interface ProbeResult {
+    ok: boolean;
+    /** Machine-readable error tag when ok=false. */
+    error?: "drive_not_shared" | "write_denied" | "invalid_id" | "transient" | "config_missing";
+    /** Free-form detail for logging. */
+    message?: string;
+}
+/**
+ * Storage provider abstraction. Every method MUST be idempotent at the
+ * data-content level — re-invoking put with identical body is allowed.
+ *
+ * Paths are logical; providers translate to native identifiers internally.
+ */
+interface FileStorageProvider {
+    put(path: StoragePath, body: Buffer | Readable, opts?: PutOpts): Promise<PutResult>;
+    get(path: StoragePath): Promise<Buffer | Readable>;
+    delete(path: StoragePath): Promise<void>;
+    exists(path: StoragePath): Promise<boolean>;
+    getSignedUrl(path: StoragePath, opts?: SignedUrlOpts): Promise<string>;
+    /** Used by validation cron + onboarding step 2. */
+    probe(): Promise<ProbeResult>;
+}
+
+declare class InMemoryProvider implements FileStorageProvider {
+    readonly provider_tag: "in_memory";
+    private readonly store;
+    put(path: string, body: Buffer | Readable, opts?: PutOpts): Promise<PutResult>;
+    get(path: string): Promise<Buffer>;
+    delete(path: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    getSignedUrl(path: string, _opts?: SignedUrlOpts): Promise<string>;
+    probe(): Promise<ProbeResult>;
+    /** Test-only escape hatch — exposes the internal store for assertions. */
+    snapshot(): Map<string, Buffer>;
+}
+
+export { InMemoryProvider };

package/dist/testing/index.js

@@ -0,0 +1,71 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing/index.ts
+var index_exports = {};
+__export(index_exports, {
+  InMemoryProvider: () => InMemoryProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/providers/in-memory.ts
+var InMemoryProvider = class {
+  constructor() {
+    this.provider_tag = "in_memory";
+    this.store = /* @__PURE__ */ new Map();
+  }
+  async put(path, body, opts) {
+    if (opts?.ifNotExists && this.store.has(path)) throw new Error(`File exists: ${path}`);
+    const buf = Buffer.isBuffer(body) ? body : await streamToBuffer(body);
+    this.store.set(path, buf);
+    return { provider: this.provider_tag, native_id: path, size: buf.length };
+  }
+  async get(path) {
+    const buf = this.store.get(path);
+    if (!buf) throw new Error(`Not found: ${path}`);
+    return buf;
+  }
+  async delete(path) {
+    this.store.delete(path);
+  }
+  async exists(path) {
+    return this.store.has(path);
+  }
+  async getSignedUrl(path, _opts) {
+    const buf = this.store.get(path);
+    if (!buf) throw new Error(`Not found: ${path}`);
+    return `data:application/octet-stream;base64,${buf.toString("base64")}`;
+  }
+  async probe() {
+    return { ok: true };
+  }
+  /** Test-only escape hatch — exposes the internal store for assertions. */
+  snapshot() {
+    return new Map(this.store);
+  }
+};
+async function streamToBuffer(s) {
+  const chunks = [];
+  for await (const c of s) chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+  return Buffer.concat(chunks);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InMemoryProvider
+});

package/dist/testing/index.mjs

@@ -0,0 +1,44 @@
+// src/providers/in-memory.ts
+var InMemoryProvider = class {
+  constructor() {
+    this.provider_tag = "in_memory";
+    this.store = /* @__PURE__ */ new Map();
+  }
+  async put(path, body, opts) {
+    if (opts?.ifNotExists && this.store.has(path)) throw new Error(`File exists: ${path}`);
+    const buf = Buffer.isBuffer(body) ? body : await streamToBuffer(body);
+    this.store.set(path, buf);
+    return { provider: this.provider_tag, native_id: path, size: buf.length };
+  }
+  async get(path) {
+    const buf = this.store.get(path);
+    if (!buf) throw new Error(`Not found: ${path}`);
+    return buf;
+  }
+  async delete(path) {
+    this.store.delete(path);
+  }
+  async exists(path) {
+    return this.store.has(path);
+  }
+  async getSignedUrl(path, _opts) {
+    const buf = this.store.get(path);
+    if (!buf) throw new Error(`Not found: ${path}`);
+    return `data:application/octet-stream;base64,${buf.toString("base64")}`;
+  }
+  async probe() {
+    return { ok: true };
+  }
+  /** Test-only escape hatch — exposes the internal store for assertions. */
+  snapshot() {
+    return new Map(this.store);
+  }
+};
+async function streamToBuffer(s) {
+  const chunks = [];
+  for await (const c of s) chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c));
+  return Buffer.concat(chunks);
+}
+export {
+  InMemoryProvider
+};

package/docs/superpowers/plans/2026-05-23-test-app-v2-providers.md

@@ -8,7 +8,7 @@
 - [x] Task 4: Signed-URL serve route — 0983dfa (2026-05-23)
 - [x] Task 5: AppFileServerProvider scenario page — fdff8ec (2026-05-23)
 - [x] Task 6: Stub pages (InMemory + GDrive) — d815df6 (2026-05-23)
-- [ ] Task 7: Smoke test — manual browser verification needed
+- [x] Task 7: Smoke test — passed, published to npm (2026-05-23)
 
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.