@pattern-stack/codegen 0.2.0

package/dist/runtime/subsystems/storage/storage.module.d.ts

@@ -0,0 +1,40 @@
+import { DynamicModule } from '@nestjs/common';
+
+/**
+ * Storage subsystem — NestJS module factory
+ *
+ * Register once in AppModule (global: true means all other modules can inject
+ * STORAGE without importing StorageModule themselves):
+ *
+ * ```typescript
+ * // app.module.ts
+ * @Module({
+ *   imports: [
+ *     StorageModule.forRoot({ backend: 'local', basePath: './uploads' }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * Swap to memory backend in tests:
+ * ```typescript
+ * Test.createTestingModule({
+ *   imports: [StorageModule.forRoot({ backend: 'memory' })],
+ * });
+ * ```
+ */
+
+interface StorageModuleOptions {
+    /** Which backend to activate. */
+    backend: 'local' | 'memory';
+    /**
+     * Base path for the local backend (resolved to an absolute path).
+     * Ignored when backend is 'memory'. Defaults to `./storage`.
+     */
+    basePath?: string;
+}
+declare class StorageModule {
+    static forRoot(options?: StorageModuleOptions): DynamicModule;
+}
+
+export { StorageModule, type StorageModuleOptions };

package/dist/runtime/subsystems/storage/storage.module.js

@@ -0,0 +1,201 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// runtime/subsystems/storage/storage.module.ts
+import { Module } from "@nestjs/common";
+
+// runtime/subsystems/storage/storage.local-backend.ts
+import {
+  createReadStream,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync
+} from "fs";
+import { dirname, join, relative, resolve, sep } from "path";
+import { Readable } from "stream";
+
+// runtime/subsystems/storage/storage.utils.ts
+async function toBuffer(data) {
+  if (Buffer.isBuffer(data)) {
+    return data;
+  }
+  const reader = data.getReader();
+  const chunks = [];
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (value) chunks.push(value);
+  }
+  return Buffer.concat(chunks);
+}
+
+// runtime/subsystems/storage/storage.local-backend.ts
+var LocalStorageBackend = class {
+  basePath;
+  constructor(basePath = "./storage") {
+    this.basePath = resolve(basePath);
+  }
+  async upload(key, data, contentType) {
+    const filePath = this.resolvePath(key);
+    mkdirSync(dirname(filePath), { recursive: true });
+    const buffer = await toBuffer(data);
+    writeFileSync(filePath, buffer);
+    return key;
+  }
+  async download(key) {
+    const filePath = this.resolvePath(key);
+    if (!existsSync(filePath)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    return readFileSync(filePath);
+  }
+  async delete(key) {
+    const filePath = this.resolvePath(key);
+    if (!existsSync(filePath)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    unlinkSync(filePath);
+  }
+  async getUrl(key, _expiresInSeconds) {
+    const filePath = this.resolvePath(key);
+    if (!existsSync(filePath)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    return `file://${filePath}`;
+  }
+  async exists(key) {
+    try {
+      return existsSync(this.resolvePath(key));
+    } catch {
+      return false;
+    }
+  }
+  async list(prefix) {
+    const keys = this.listRecursive(this.basePath);
+    if (prefix === void 0) return keys;
+    return keys.filter((k) => k.startsWith(prefix));
+  }
+  async downloadStream(key) {
+    const filePath = this.resolvePath(key);
+    if (!existsSync(filePath)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    const nodeStream = createReadStream(filePath);
+    return Readable.toWeb(nodeStream);
+  }
+  resolvePath(key) {
+    const resolved = resolve(this.basePath, key);
+    if (!resolved.startsWith(this.basePath + sep)) {
+      throw new Error(`Invalid storage key (path traversal attempt): ${key}`);
+    }
+    return resolved;
+  }
+  /** Recursively list all files under dir, returning keys relative to basePath. */
+  listRecursive(dir) {
+    if (!existsSync(dir)) return [];
+    const keys = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const full = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        keys.push(...this.listRecursive(full));
+      } else {
+        keys.push(relative(this.basePath, full));
+      }
+    }
+    return keys;
+  }
+};
+
+// runtime/subsystems/storage/storage.memory-backend.ts
+var MemoryStorageBackend = class {
+  store = /* @__PURE__ */ new Map();
+  async upload(key, data, contentType) {
+    const buffer = await toBuffer(data);
+    this.store.set(key, { data: buffer, contentType });
+    return key;
+  }
+  async download(key) {
+    const entry = this.store.get(key);
+    if (!entry) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    return entry.data;
+  }
+  async delete(key) {
+    if (!this.store.has(key)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    this.store.delete(key);
+  }
+  async getUrl(key, _expiresInSeconds) {
+    if (!this.store.has(key)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    return `memory://${key}`;
+  }
+  async exists(key) {
+    return this.store.has(key);
+  }
+  async list(prefix) {
+    const keys = Array.from(this.store.keys());
+    if (prefix === void 0) return keys;
+    return keys.filter((k) => k.startsWith(prefix));
+  }
+  async downloadStream(key) {
+    const buffer = await this.download(key);
+    return new ReadableStream({
+      start(controller) {
+        controller.enqueue(new Uint8Array(buffer));
+        controller.close();
+      }
+    });
+  }
+  /** Clear all stored files. Useful for test teardown. */
+  clear() {
+    this.store.clear();
+  }
+  /** Return number of stored files. Useful for test assertions. */
+  size() {
+    return this.store.size;
+  }
+};
+
+// runtime/subsystems/storage/storage.tokens.ts
+var STORAGE = /* @__PURE__ */ Symbol("STORAGE");
+
+// runtime/subsystems/storage/storage.module.ts
+var StorageModule = class {
+  static forRoot(options = { backend: "local" }) {
+    const provider = options.backend === "local" ? {
+      provide: STORAGE,
+      useFactory: () => new LocalStorageBackend(options.basePath ?? "./storage")
+    } : {
+      provide: STORAGE,
+      useClass: MemoryStorageBackend
+    };
+    return {
+      module: StorageModule,
+      global: true,
+      providers: [provider],
+      exports: [STORAGE]
+    };
+  }
+};
+StorageModule = __decorateClass([
+  Module({})
+], StorageModule);
+export {
+  StorageModule
+};
+//# sourceMappingURL=storage.module.js.map

package/dist/runtime/subsystems/storage/storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/storage/storage.module.ts","../../../../runtime/subsystems/storage/storage.local-backend.ts","../../../../runtime/subsystems/storage/storage.utils.ts","../../../../runtime/subsystems/storage/storage.memory-backend.ts","../../../../runtime/subsystems/storage/storage.tokens.ts"],"sourcesContent":["/**\n * Storage subsystem — NestJS module factory\n *\n * Register once in AppModule (global: true means all other modules can inject\n * STORAGE without importing StorageModule themselves):\n *\n * ```typescript\n * // app.module.ts\n * @Module({\n *   imports: [\n *     StorageModule.forRoot({ backend: 'local', basePath: './uploads' }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n *\n * Swap to memory backend in tests:\n * ```typescript\n * Test.createTestingModule({\n *   imports: [StorageModule.forRoot({ backend: 'memory' })],\n * });\n * ```\n */\nimport { type DynamicModule, Module } from '@nestjs/common';\nimport { LocalStorageBackend } from './storage.local-backend';\nimport { MemoryStorageBackend } from './storage.memory-backend';\nimport { STORAGE } from './storage.tokens';\n\nexport interface StorageModuleOptions {\n  /** Which backend to activate. */\n  backend: 'local' | 'memory';\n  /**\n   * Base path for the local backend (resolved to an absolute path).\n   * Ignored when backend is 'memory'. Defaults to `./storage`.\n   */\n  basePath?: string;\n}\n\n@Module({})\nexport class StorageModule {\n  static forRoot(options: StorageModuleOptions = { backend: 'local' }): DynamicModule {\n    const provider =\n      options.backend === 'local'\n        ? {\n            provide: STORAGE,\n            useFactory: () => new LocalStorageBackend(options.basePath ?? './storage'),\n          }\n        : {\n            provide: STORAGE,\n            useClass: MemoryStorageBackend,\n          };\n\n    return {\n      module: StorageModule,\n      global: true,\n      providers: [provider],\n      exports: [STORAGE],\n    };\n  }\n}\n","/**\n * Storage subsystem — local filesystem backend\n *\n * Writes files to `{basePath}/{key}` on the local filesystem.\n * Suitable for development only — use an S3/GCS backend in production.\n *\n * - Creates intermediate directories automatically (mkdirSync recursive)\n * - getUrl returns a `file://` URI pointing to the absolute path\n * - All methods throw on failure\n * - resolvePath validates against path traversal attacks\n */\nimport {\n  createReadStream,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n} from 'fs';\nimport { dirname, join, relative, resolve, sep } from 'path';\nimport { Readable } from 'stream';\nimport type { IStorageService } from './storage.protocol';\nimport { toBuffer } from './storage.utils';\n\nexport class LocalStorageBackend implements IStorageService {\n  private readonly basePath: string;\n\n  constructor(basePath: string = './storage') {\n    this.basePath = resolve(basePath);\n  }\n\n  async upload(key: string, data: Buffer | ReadableStream, contentType?: string): Promise<string> {\n    const filePath = this.resolvePath(key);\n    mkdirSync(dirname(filePath), { recursive: true });\n\n    const buffer = await toBuffer(data);\n    writeFileSync(filePath, buffer);\n    return key;\n  }\n\n  async download(key: string): Promise<Buffer> {\n    const filePath = this.resolvePath(key);\n    if (!existsSync(filePath)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    return readFileSync(filePath);\n  }\n\n  async delete(key: string): Promise<void> {\n    const filePath = this.resolvePath(key);\n    if (!existsSync(filePath)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    unlinkSync(filePath);\n  }\n\n  async getUrl(key: string, _expiresInSeconds?: number): Promise<string> {\n    const filePath = this.resolvePath(key);\n    if (!existsSync(filePath)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    return `file://${filePath}`;\n  }\n\n  async exists(key: string): Promise<boolean> {\n    try {\n      return existsSync(this.resolvePath(key));\n    } catch {\n      // resolvePath throws on traversal attempt — treat as non-existent\n      return false;\n    }\n  }\n\n  async list(prefix?: string): Promise<string[]> {\n    const keys = this.listRecursive(this.basePath);\n    if (prefix === undefined) return keys;\n    return keys.filter((k) => k.startsWith(prefix));\n  }\n\n  async downloadStream(key: string): Promise<ReadableStream> {\n    const filePath = this.resolvePath(key);\n    if (!existsSync(filePath)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    const nodeStream = createReadStream(filePath);\n    return Readable.toWeb(nodeStream) as ReadableStream;\n  }\n\n  private resolvePath(key: string): string {\n    const resolved = resolve(this.basePath, key);\n    if (!resolved.startsWith(this.basePath + sep)) {\n      throw new Error(`Invalid storage key (path traversal attempt): ${key}`);\n    }\n    return resolved;\n  }\n\n  /** Recursively list all files under dir, returning keys relative to basePath. */\n  private listRecursive(dir: string): string[] {\n    if (!existsSync(dir)) return [];\n    const keys: string[] = [];\n    for (const entry of readdirSync(dir, { withFileTypes: true })) {\n      const full = join(dir, entry.name);\n      if (entry.isDirectory()) {\n        keys.push(...this.listRecursive(full));\n      } else {\n        keys.push(relative(this.basePath, full));\n      }\n    }\n    return keys;\n  }\n}\n","/**\n * Storage subsystem — shared utilities\n */\n\n/**\n * Convert a Buffer or Web ReadableStream to a Node.js Buffer.\n */\nexport async function toBuffer(data: Buffer | ReadableStream): Promise<Buffer> {\n  if (Buffer.isBuffer(data)) {\n    return data;\n  }\n  const reader = (data as ReadableStream<Uint8Array>).getReader();\n  const chunks: Uint8Array[] = [];\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (value) chunks.push(value);\n  }\n  return Buffer.concat(chunks);\n}\n","/**\n * Storage subsystem — in-memory backend\n *\n * Stores files as Buffers in a Map. Intended for unit tests only.\n * All state is lost when the process exits.\n *\n * - getUrl returns `memory://{key}` (not a real URL, useful for assertions)\n * - All methods throw on failure (missing keys, etc.)\n */\nimport type { IStorageService } from './storage.protocol';\nimport { toBuffer } from './storage.utils';\n\ninterface MemoryEntry {\n  data: Buffer;\n  contentType?: string;\n}\n\nexport class MemoryStorageBackend implements IStorageService {\n  private readonly store = new Map<string, MemoryEntry>();\n\n  async upload(key: string, data: Buffer | ReadableStream, contentType?: string): Promise<string> {\n    const buffer = await toBuffer(data);\n    this.store.set(key, { data: buffer, contentType });\n    return key;\n  }\n\n  async download(key: string): Promise<Buffer> {\n    const entry = this.store.get(key);\n    if (!entry) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    return entry.data;\n  }\n\n  async delete(key: string): Promise<void> {\n    if (!this.store.has(key)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    this.store.delete(key);\n  }\n\n  async getUrl(key: string, _expiresInSeconds?: number): Promise<string> {\n    if (!this.store.has(key)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    return `memory://${key}`;\n  }\n\n  async exists(key: string): Promise<boolean> {\n    return this.store.has(key);\n  }\n\n  async list(prefix?: string): Promise<string[]> {\n    const keys = Array.from(this.store.keys());\n    if (prefix === undefined) return keys;\n    return keys.filter((k) => k.startsWith(prefix));\n  }\n\n  async downloadStream(key: string): Promise<ReadableStream> {\n    const buffer = await this.download(key);\n    return new ReadableStream<Uint8Array>({\n      start(controller) {\n        controller.enqueue(new Uint8Array(buffer));\n        controller.close();\n      },\n    });\n  }\n\n  /** Clear all stored files. Useful for test teardown. */\n  clear(): void {\n    this.store.clear();\n  }\n\n  /** Return number of stored files. Useful for test assertions. */\n  size(): number {\n    return this.store.size;\n  }\n}\n","/**\n * Injection token for the storage service.\n *\n * Usage in use cases:\n * ```typescript\n * constructor(@Inject(STORAGE) private readonly storage: IStorageService) {}\n * ```\n */\nexport const STORAGE = Symbol('STORAGE');\n"],"mappings":"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","names":[]}

package/dist/runtime/subsystems/storage/storage.protocol.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Storage subsystem — protocol (port)
+ *
+ * IStorageService is the hexagonal port. Use cases inject this interface via
+ * STORAGE token. They never depend on a specific backend implementation.
+ *
+ * All methods throw on failure — callers must handle upload/download errors
+ * explicitly. There is no null-return behavior like CacheService.
+ *
+ * Users who need cloud storage (S3, GCS, R2) implement this interface
+ * directly. No Drizzle backend exists — files in Postgres is an antipattern.
+ */
+interface IStorageService {
+    /**
+     * Upload a file and return the stored key (same as the input key).
+     *
+     * @param key - Storage key / path (e.g. 'avatars/user-123.png')
+     * @param data - File contents as a Buffer or a ReadableStream
+     * @param contentType - Optional MIME type (e.g. 'image/png')
+     * @returns The stored key
+     * @throws On any write failure
+     */
+    upload(key: string, data: Buffer | ReadableStream, contentType?: string): Promise<string>;
+    /**
+     * Download a file by key and return its contents as a Buffer.
+     *
+     * @throws If the file does not exist or cannot be read
+     */
+    download(key: string): Promise<Buffer>;
+    /**
+     * Delete a file by key.
+     *
+     * @throws If the file does not exist or cannot be deleted
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Return a URL for accessing the file.
+     *
+     * For local backend: returns a `file://` URI.
+     * For cloud backends: returns a presigned URL that expires after `expiresInSeconds`.
+     *
+     * @param key - Storage key
+     * @param expiresInSeconds - URL expiry (ignored by local/memory backends)
+     * @throws If the file does not exist
+     */
+    getUrl(key: string, expiresInSeconds?: number): Promise<string>;
+    /**
+     * Check whether a file exists at the given key.
+     *
+     * @returns `true` if the file exists, `false` otherwise
+     * @throws Only on unexpected I/O errors (not on simple absence)
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * List all stored keys, optionally filtered by prefix.
+     *
+     * @param prefix - Optional prefix filter (e.g. 'avatars/')
+     * @returns Array of keys matching the prefix (or all keys if omitted)
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Download a file by key and return its contents as a Web ReadableStream.
+     *
+     * @throws If the file does not exist or cannot be read
+     */
+    downloadStream(key: string): Promise<ReadableStream>;
+}
+
+export type { IStorageService };

package/dist/runtime/subsystems/storage/storage.protocol.js

@@ -0,0 +1 @@
+//# sourceMappingURL=storage.protocol.js.map

package/dist/runtime/subsystems/storage/storage.protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime/subsystems/storage/storage.tokens.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Injection token for the storage service.
+ *
+ * Usage in use cases:
+ * ```typescript
+ * constructor(@Inject(STORAGE) private readonly storage: IStorageService) {}
+ * ```
+ */
+declare const STORAGE: unique symbol;
+
+export { STORAGE };

package/dist/runtime/subsystems/storage/storage.tokens.js

@@ -0,0 +1,6 @@
+// runtime/subsystems/storage/storage.tokens.ts
+var STORAGE = /* @__PURE__ */ Symbol("STORAGE");
+export {
+  STORAGE
+};
+//# sourceMappingURL=storage.tokens.js.map

package/dist/runtime/subsystems/storage/storage.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/storage/storage.tokens.ts"],"sourcesContent":["/**\n * Injection token for the storage service.\n *\n * Usage in use cases:\n * ```typescript\n * constructor(@Inject(STORAGE) private readonly storage: IStorageService) {}\n * ```\n */\nexport const STORAGE = Symbol('STORAGE');\n"],"mappings":";AAQO,IAAM,UAAU,uBAAO,SAAS;","names":[]}

package/dist/runtime/subsystems/storage/storage.utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Storage subsystem — shared utilities
+ */
+/**
+ * Convert a Buffer or Web ReadableStream to a Node.js Buffer.
+ */
+declare function toBuffer(data: Buffer | ReadableStream): Promise<Buffer>;
+
+export { toBuffer };

package/dist/runtime/subsystems/storage/storage.utils.js

@@ -0,0 +1,18 @@
+// runtime/subsystems/storage/storage.utils.ts
+async function toBuffer(data) {
+  if (Buffer.isBuffer(data)) {
+    return data;
+  }
+  const reader = data.getReader();
+  const chunks = [];
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (value) chunks.push(value);
+  }
+  return Buffer.concat(chunks);
+}
+export {
+  toBuffer
+};
+//# sourceMappingURL=storage.utils.js.map

package/dist/runtime/subsystems/storage/storage.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/storage/storage.utils.ts"],"sourcesContent":["/**\n * Storage subsystem — shared utilities\n */\n\n/**\n * Convert a Buffer or Web ReadableStream to a Node.js Buffer.\n */\nexport async function toBuffer(data: Buffer | ReadableStream): Promise<Buffer> {\n  if (Buffer.isBuffer(data)) {\n    return data;\n  }\n  const reader = (data as ReadableStream<Uint8Array>).getReader();\n  const chunks: Uint8Array[] = [];\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (value) chunks.push(value);\n  }\n  return Buffer.concat(chunks);\n}\n"],"mappings":";AAOA,eAAsB,SAAS,MAAgD;AAC7E,MAAI,OAAO,SAAS,IAAI,GAAG;AACzB,WAAO;AAAA,EACT;AACA,QAAM,SAAU,KAAoC,UAAU;AAC9D,QAAM,SAAuB,CAAC;AAC9B,SAAO,MAAM;AACX,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,QAAI,KAAM;AACV,QAAI,MAAO,QAAO,KAAK,KAAK;AAAA,EAC9B;AACA,SAAO,OAAO,OAAO,MAAM;AAC7B;","names":[]}

package/dist/runtime/types/drizzle.d.ts

@@ -0,0 +1,17 @@
+import { NodePgDatabase } from 'drizzle-orm/node-postgres';
+
+/**
+ * DrizzleClient type alias
+ *
+ * Type alias for the Drizzle ORM database client. Using NodePgDatabase
+ * as the canonical Drizzle Postgres client type.
+ */
+
+/**
+ * The Drizzle database client type used throughout the application.
+ * Typed with a permissive schema to allow use in the abstract base class
+ * without coupling to a specific schema module.
+ */
+type DrizzleClient = NodePgDatabase<any>;
+
+export type { DrizzleClient };

package/dist/runtime/types/drizzle.js

@@ -0,0 +1 @@
+//# sourceMappingURL=drizzle.js.map

package/dist/runtime/types/drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/src/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node