@stratal/testing 0.0.14 → 0.0.16

package/dist/storage-PcJUKxwp.mjs

@@ -0,0 +1,206 @@
+import { FileNotFoundError, STORAGE_TOKENS, StorageManagerService, StorageService } from "stratal/storage";
+import { Transient, inject } from "stratal/di";
+import { expect } from "vitest";
+//#region \0@oxc-project+runtime@0.115.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.115.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.115.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+//#endregion
+//#region src/storage/fake-storage.service.ts
+var _ref;
+let FakeStorageService = class FakeStorageService extends StorageService {
+	files = /* @__PURE__ */ new Map();
+	constructor(storageManager, options) {
+		super(storageManager, options);
+		this.storageManager = storageManager;
+		this.options = options;
+	}
+	/**
+	* Upload content to fake storage
+	*/
+	async upload(body, relativePath, options, disk) {
+		const content = await this.bodyToUint8Array(body);
+		const diskName = this.resolveDisk(disk);
+		this.files.set(relativePath, {
+			content,
+			mimeType: options.mimeType ?? "application/octet-stream",
+			size: options.size,
+			metadata: options.metadata,
+			uploadedAt: /* @__PURE__ */ new Date()
+		});
+		return {
+			path: relativePath,
+			disk: diskName,
+			fullPath: relativePath,
+			size: options.size,
+			mimeType: options.mimeType ?? "application/octet-stream",
+			uploadedAt: /* @__PURE__ */ new Date()
+		};
+	}
+	/**
+	* Download a file from fake storage
+	*/
+	download(path) {
+		const file = this.files.get(path);
+		if (!file) return Promise.reject(new FileNotFoundError(path));
+		return Promise.resolve({
+			toStream: () => new ReadableStream({ start(controller) {
+				controller.enqueue(file.content);
+				controller.close();
+			} }),
+			toString: () => Promise.resolve(new TextDecoder().decode(file.content)),
+			toArrayBuffer: () => Promise.resolve(file.content),
+			contentType: file.mimeType,
+			size: file.size,
+			metadata: file.metadata
+		});
+	}
+	/**
+	* Delete a file from fake storage
+	*/
+	delete(path) {
+		this.files.delete(path);
+		return Promise.resolve();
+	}
+	/**
+	* Check if a file exists in fake storage
+	*/
+	exists(path) {
+		return Promise.resolve(this.files.has(path));
+	}
+	/**
+	* Generate a fake presigned download URL
+	*/
+	getPresignedDownloadUrl(path, expiresIn) {
+		return Promise.resolve(this.createPresignedUrl(path, "GET", expiresIn));
+	}
+	/**
+	* Generate a fake presigned upload URL
+	*/
+	getPresignedUploadUrl(path, expiresIn) {
+		return Promise.resolve(this.createPresignedUrl(path, "PUT", expiresIn));
+	}
+	/**
+	* Generate a fake presigned delete URL
+	*/
+	getPresignedDeleteUrl(path, expiresIn) {
+		return Promise.resolve(this.createPresignedUrl(path, "DELETE", expiresIn));
+	}
+	/**
+	* Chunked upload (same as regular upload for fake)
+	*/
+	async chunkedUpload(body, path, options, disk) {
+		const content = await this.bodyToUint8Array(body);
+		const size = options.size ?? content.length;
+		return this.upload(body, path, {
+			...options,
+			size
+		}, disk);
+	}
+	/**
+	* Assert that a file exists at the given path
+	*
+	* @param path - Path to check
+	* @throws AssertionError if file does not exist
+	*/
+	assertExists(path) {
+		expect(this.files.has(path), `Expected file to exist at: ${path}\nStored files: ${this.getStoredPaths().join(", ") || "(none)"}`).toBe(true);
+	}
+	/**
+	* Assert that a file does NOT exist at the given path
+	*
+	* @param path - Path to check
+	* @throws AssertionError if file exists
+	*/
+	assertMissing(path) {
+		expect(this.files.has(path), `Expected file NOT to exist at: ${path}`).toBe(false);
+	}
+	/**
+	* Assert storage is empty
+	*
+	* @throws AssertionError if any files exist
+	*/
+	assertEmpty() {
+		expect(this.files.size, `Expected storage to be empty but found ${this.files.size} files: ${this.getStoredPaths().join(", ")}`).toBe(0);
+	}
+	/**
+	* Assert storage has exactly N files
+	*
+	* @param count - Expected number of files
+	* @throws AssertionError if count doesn't match
+	*/
+	assertCount(count) {
+		expect(this.files.size, `Expected ${count} files in storage but found ${this.files.size}`).toBe(count);
+	}
+	/**
+	* Get all stored files (for inspection)
+	*/
+	getStoredFiles() {
+		return new Map(this.files);
+	}
+	/**
+	* Get all stored file paths
+	*/
+	getStoredPaths() {
+		return Array.from(this.files.keys());
+	}
+	/**
+	* Get a specific file by path
+	*/
+	getFile(path) {
+		return this.files.get(path);
+	}
+	/**
+	* Clear all stored files (call in beforeEach for test isolation)
+	*/
+	clear() {
+		this.files.clear();
+	}
+	createPresignedUrl(path, method, expiresIn = 300) {
+		const expiresAt = new Date(Date.now() + expiresIn * 1e3);
+		return {
+			url: `https://fake-storage.test/${path}?method=${method}&expires=${expiresAt.toISOString()}`,
+			expiresIn,
+			expiresAt,
+			method
+		};
+	}
+	async bodyToUint8Array(body) {
+		if (!body) return new Uint8Array(0);
+		if (body instanceof Uint8Array) return body;
+		if (body instanceof ArrayBuffer) return new Uint8Array(body);
+		if (typeof body === "string") return new TextEncoder().encode(body);
+		if (body instanceof Blob) {
+			const buffer = await body.arrayBuffer();
+			return new Uint8Array(buffer);
+		}
+		if (body instanceof ReadableStream) return new Uint8Array(await new Response(body).arrayBuffer());
+		if (body instanceof FormData || body instanceof URLSearchParams) return new Uint8Array(await new Response(body).arrayBuffer());
+		return new Uint8Array(0);
+	}
+};
+FakeStorageService = __decorate([
+	Transient(STORAGE_TOKENS.StorageService),
+	__decorateParam(0, inject(STORAGE_TOKENS.StorageManager)),
+	__decorateParam(1, inject(STORAGE_TOKENS.Options)),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof StorageManagerService !== "undefined" && StorageManagerService) === "function" ? _ref : Object, Object])
+], FakeStorageService);
+//#endregion
+export { __decorate as n, FakeStorageService as t };
+
+//# sourceMappingURL=storage-PcJUKxwp.mjs.map

package/dist/storage-PcJUKxwp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-PcJUKxwp.mjs","names":[],"sources":["../src/storage/fake-storage.service.ts"],"sourcesContent":["import { Transient, inject } from 'stratal/di'\nimport {\n  FileNotFoundError,\n  STORAGE_TOKENS,\n  StorageManagerService,\n  StorageService,\n  StreamingBlobPayloadInputTypes,\n  type DownloadResult,\n  type PresignedUrlResult,\n  type StorageConfig,\n  type UploadOptions,\n  type UploadResult,\n} from 'stratal/storage'\nimport { expect } from 'vitest'\n\n/**\n * Stored file representation in memory\n */\nexport interface StoredFile {\n  content: Uint8Array\n  mimeType: string\n  size: number\n  metadata?: Record<string, string>\n  uploadedAt: Date\n}\n\n/**\n * FakeStorageService\n *\n * In-memory storage implementation for testing.\n * Registered by default in TestingModuleBuilder.\n *\n * Similar to Laravel's Storage::fake() - stores files in memory\n * and provides assertion helpers for testing.\n *\n * @example\n * ```typescript\n * // Access via TestingModule\n * module.storage.assertExists('path/to/file.pdf')\n * module.storage.assertMissing('deleted/file.pdf')\n * module.storage.clear() // Reset between tests\n * ```\n */\n@Transient(STORAGE_TOKENS.StorageService)\nexport class FakeStorageService extends StorageService {\n  private files = new Map<string, StoredFile>()\n\n  constructor(\n    @inject(STORAGE_TOKENS.StorageManager)\n    protected readonly storageManager: StorageManagerService,\n    @inject(STORAGE_TOKENS.Options)\n    protected readonly options: StorageConfig\n  ) {\n    super(storageManager, options)\n  }\n\n  /**\n   * Upload content to fake storage\n   */\n  async upload(\n    body: StreamingBlobPayloadInputTypes,\n    relativePath: string,\n    options: UploadOptions,\n    disk?: string\n  ): Promise<UploadResult> {\n    const content = await this.bodyToUint8Array(body)\n    const diskName = this.resolveDisk(disk)\n\n    this.files.set(relativePath, {\n      content,\n      mimeType: options.mimeType ?? 'application/octet-stream',\n      size: options.size,\n      metadata: options.metadata,\n      uploadedAt: new Date(),\n    })\n\n    return {\n      path: relativePath,\n      disk: diskName,\n      fullPath: relativePath,\n      size: options.size,\n      mimeType: options.mimeType ?? 'application/octet-stream',\n      uploadedAt: new Date(),\n    }\n  }\n\n  /**\n   * Download a file from fake storage\n   */\n  download(path: string): Promise<DownloadResult> {\n    const file = this.files.get(path)\n\n    if (!file) {\n      return Promise.reject(new FileNotFoundError(path))\n    }\n\n    return Promise.resolve({\n      toStream: () => new ReadableStream({\n        start(controller) {\n          controller.enqueue(file.content)\n          controller.close()\n        },\n      }),\n      toString: () => Promise.resolve(new TextDecoder().decode(file.content)),\n      toArrayBuffer: () => Promise.resolve(file.content),\n      contentType: file.mimeType,\n      size: file.size,\n      metadata: file.metadata,\n    })\n  }\n\n  /**\n   * Delete a file from fake storage\n   */\n  delete(path: string): Promise<void> {\n    this.files.delete(path)\n    return Promise.resolve()\n  }\n\n  /**\n   * Check if a file exists in fake storage\n   */\n  exists(path: string): Promise<boolean> {\n    return Promise.resolve(this.files.has(path))\n  }\n\n  /**\n   * Generate a fake presigned download URL\n   */\n  getPresignedDownloadUrl(\n    path: string,\n    expiresIn?: number\n  ): Promise<PresignedUrlResult> {\n    return Promise.resolve(this.createPresignedUrl(path, 'GET', expiresIn))\n  }\n\n  /**\n   * Generate a fake presigned upload URL\n   */\n  getPresignedUploadUrl(\n    path: string,\n    expiresIn?: number\n  ): Promise<PresignedUrlResult> {\n    return Promise.resolve(this.createPresignedUrl(path, 'PUT', expiresIn))\n  }\n\n  /**\n   * Generate a fake presigned delete URL\n   */\n  getPresignedDeleteUrl(\n    path: string,\n    expiresIn?: number\n  ): Promise<PresignedUrlResult> {\n    return Promise.resolve(this.createPresignedUrl(path, 'DELETE', expiresIn))\n  }\n\n  /**\n   * Chunked upload (same as regular upload for fake)\n   */\n  async chunkedUpload(\n    body: StreamingBlobPayloadInputTypes,\n    path: string,\n    options: Omit<UploadOptions, 'size'> & { size?: number },\n    disk?: string\n  ): Promise<UploadResult> {\n    const content = await this.bodyToUint8Array(body)\n    const size = options.size ?? content.length\n\n    return this.upload(body, path, { ...options, size }, disk)\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // Test Assertion Helpers\n  // ─────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Assert that a file exists at the given path\n   *\n   * @param path - Path to check\n   * @throws AssertionError if file does not exist\n   */\n  assertExists(path: string): void {\n    expect(\n      this.files.has(path),\n      `Expected file to exist at: ${path}\\nStored files: ${this.getStoredPaths().join(', ') || '(none)'}`\n    ).toBe(true)\n  }\n\n  /**\n   * Assert that a file does NOT exist at the given path\n   *\n   * @param path - Path to check\n   * @throws AssertionError if file exists\n   */\n  assertMissing(path: string): void {\n    expect(\n      this.files.has(path),\n      `Expected file NOT to exist at: ${path}`\n    ).toBe(false)\n  }\n\n  /**\n   * Assert storage is empty\n   *\n   * @throws AssertionError if any files exist\n   */\n  assertEmpty(): void {\n    expect(\n      this.files.size,\n      `Expected storage to be empty but found ${this.files.size} files: ${this.getStoredPaths().join(', ')}`\n    ).toBe(0)\n  }\n\n  /**\n   * Assert storage has exactly N files\n   *\n   * @param count - Expected number of files\n   * @throws AssertionError if count doesn't match\n   */\n  assertCount(count: number): void {\n    expect(\n      this.files.size,\n      `Expected ${count} files in storage but found ${this.files.size}`\n    ).toBe(count)\n  }\n\n  /**\n   * Get all stored files (for inspection)\n   */\n  getStoredFiles(): Map<string, StoredFile> {\n    return new Map(this.files)\n  }\n\n  /**\n   * Get all stored file paths\n   */\n  getStoredPaths(): string[] {\n    return Array.from(this.files.keys())\n  }\n\n  /**\n   * Get a specific file by path\n   */\n  getFile(path: string): StoredFile | undefined {\n    return this.files.get(path)\n  }\n\n  /**\n   * Clear all stored files (call in beforeEach for test isolation)\n   */\n  clear(): void {\n    this.files.clear()\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // Private Helpers\n  // ─────────────────────────────────────────────────────────────────────────\n\n  private createPresignedUrl(\n    path: string,\n    method: 'GET' | 'PUT' | 'DELETE' | 'HEAD',\n    expiresIn = 300\n  ): PresignedUrlResult {\n    const expiresAt = new Date(Date.now() + expiresIn * 1000)\n\n    return {\n      url: `https://fake-storage.test/${path}?method=${method}&expires=${expiresAt.toISOString()}`,\n      expiresIn,\n      expiresAt,\n      method,\n    }\n  }\n\n  private async bodyToUint8Array(body: StreamingBlobPayloadInputTypes | null | undefined): Promise<Uint8Array> {\n    if (!body) {\n      return new Uint8Array(0)\n    }\n\n    if (body instanceof Uint8Array) {\n      return body\n    }\n\n    if (body instanceof ArrayBuffer) {\n      return new Uint8Array(body)\n    }\n\n    if (typeof body === 'string') {\n      return new TextEncoder().encode(body)\n    }\n\n    if (body instanceof Blob) {\n      const buffer = await body.arrayBuffer()\n      return new Uint8Array(buffer)\n    }\n\n    if (body instanceof ReadableStream) {\n      return new Uint8Array(await new Response(body).arrayBuffer())\n    }\n\n    // FormData or URLSearchParams - convert via Response\n    if (body instanceof FormData || body instanceof URLSearchParams) {\n      return new Uint8Array(await new Response(body).arrayBuffer())\n    }\n\n    return new Uint8Array(0)\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratal/testing",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Testing utilities and mocks for Stratal framework applications",
   "type": "module",
   "license": "MIT",
@@ -49,6 +49,10 @@
       "types": "./dist/mocks/zenstack-language.d.mts",
       "import": "./dist/mocks/zenstack-language.mjs"
     },
+    "./storage": {
+      "types": "./dist/storage/index.d.mts",
+      "import": "./dist/storage/index.mjs"
+    },
     "./vitest-plugin": {
       "types": "./dist/vitest-plugin/index.d.mts",
       "import": "./dist/vitest-plugin/index.mjs"
@@ -67,9 +71,10 @@
     "msw": "^2.12.13"
   },
   "peerDependencies": {
-    "@stratal/framework": "^0.0.14",
+    "@stratal/framework": "^0.0.16",
     "better-auth": "^1.4.9",
-    "stratal": "^0.0.14",
+    "reflect-metadata": "^0.2.2",
+    "stratal": "^0.0.16",
     "vitest": "^4.1.0"
   },
   "peerDependenciesMeta": {
@@ -87,6 +92,7 @@
     "@vitest/runner": "~4.1.0",
     "@vitest/snapshot": "~4.1.0",
     "better-auth": "^1.5.5",
+    "reflect-metadata": "^0.2.2",
     "stratal": "workspace:*",
     "tsdown": "^0.21.4",
     "typescript": "^5.9.3",