@objectstack/service-storage 3.0.7 → 3.0.9

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/service-storage@3.0.7 build /home/runner/work/spec/spec/packages/services/service-storage
+> @objectstack/service-storage@3.0.9 build /home/runner/work/spec/spec/packages/services/service-storage
 > tsup --config ../../../tsup.config.ts
 
 CLI Building entry: src/index.ts
@@ -10,13 +10,13 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js     3.52 KB
-ESM dist/index.js.map 9.96 KB
-ESM ⚡️ Build success in 80ms
-CJS dist/index.cjs     4.85 KB
-CJS dist/index.cjs.map 10.56 KB
-CJS ⚡️ Build success in 89ms
+ESM dist/index.js     4.04 KB
+ESM dist/index.js.map 10.95 KB
+ESM ⚡️ Build success in 48ms
+CJS dist/index.cjs     5.36 KB
+CJS dist/index.cjs.map 11.56 KB
+CJS ⚡️ Build success in 49ms
 DTS Build start
-DTS ⚡️ Build success in 12796ms
-DTS dist/index.d.ts  3.83 KB
-DTS dist/index.d.cts 3.83 KB
+DTS ⚡️ Build success in 13804ms
+DTS dist/index.d.ts  4.20 KB
+DTS dist/index.d.cts 4.20 KB

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @objectstack/service-storage
 
+## 3.0.9
+
+### Patch Changes
+
+- Updated dependencies [15e0df6]
+  - @objectstack/spec@3.0.9
+  - @objectstack/core@3.0.9
+
+## 3.0.8
+
+### Patch Changes
+
+- Updated dependencies [5a968a2]
+  - @objectstack/spec@3.0.8
+  - @objectstack/core@3.0.8
+
 ## 3.0.7
 
 ### Patch Changes

package/dist/index.cjs

@@ -147,6 +147,18 @@ var S3StorageAdapter = class {
   async getSignedUrl(_key, _expiresIn) {
     throw new Error("S3StorageAdapter not yet implemented");
   }
+  async initiateChunkedUpload(_key, _options) {
+    throw new Error("S3StorageAdapter.initiateChunkedUpload not yet implemented");
+  }
+  async uploadChunk(_uploadId, _partNumber, _data) {
+    throw new Error("S3StorageAdapter.uploadChunk not yet implemented");
+  }
+  async completeChunkedUpload(_uploadId, _parts) {
+    throw new Error("S3StorageAdapter.completeChunkedUpload not yet implemented");
+  }
+  async abortChunkedUpload(_uploadId) {
+    throw new Error("S3StorageAdapter.abortChunkedUpload not yet implemented");
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/local-storage-adapter.ts","../src/storage-service-plugin.ts","../src/s3-storage-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { StorageServicePlugin } from './storage-service-plugin.js';\nexport type { StorageServicePluginOptions } from './storage-service-plugin.js';\nexport { LocalStorageAdapter } from './local-storage-adapter.js';\nexport type { LocalStorageAdapterOptions } from './local-storage-adapter.js';\nexport { S3StorageAdapter } from './s3-storage-adapter.js';\nexport type { S3StorageAdapterOptions } from './s3-storage-adapter.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { promises as fs } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for LocalStorageAdapter.\n */\nexport interface LocalStorageAdapterOptions {\n  /** Root directory for file storage */\n  rootDir: string;\n}\n\n/**\n * Local filesystem storage adapter implementing IStorageService.\n *\n * Stores files on the local disk under a configurable root directory.\n * Suitable for development, testing, and single-server deployments.\n */\nexport class LocalStorageAdapter implements IStorageService {\n  private readonly rootDir: string;\n\n  constructor(options: LocalStorageAdapterOptions) {\n    this.rootDir = options.rootDir;\n  }\n\n  private resolvePath(key: string): string {\n    return join(this.rootDir, key);\n  }\n\n  async upload(key: string, data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.mkdir(dirname(filePath), { recursive: true });\n\n    if (data instanceof Buffer) {\n      await fs.writeFile(filePath, data);\n    } else {\n      // Convert ReadableStream to Buffer\n      const chunks: Uint8Array[] = [];\n      const reader = (data as ReadableStream).getReader();\n      let done = false;\n      while (!done) {\n        const result = await reader.read();\n        done = result.done;\n        if (result.value) chunks.push(result.value);\n      }\n      await fs.writeFile(filePath, Buffer.concat(chunks));\n    }\n  }\n\n  async download(key: string): Promise<Buffer> {\n    const filePath = this.resolvePath(key);\n    return fs.readFile(filePath);\n  }\n\n  async delete(key: string): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.unlink(filePath);\n  }\n\n  async exists(key: string): Promise<boolean> {\n    try {\n      await fs.access(this.resolvePath(key));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async getInfo(key: string): Promise<StorageFileInfo> {\n    const filePath = this.resolvePath(key);\n    const stat = await fs.stat(filePath);\n    return {\n      key,\n      size: stat.size,\n      lastModified: stat.mtime,\n    };\n  }\n\n  async list(prefix: string): Promise<StorageFileInfo[]> {\n    const dirPath = this.resolvePath(prefix);\n    try {\n      const entries = await fs.readdir(dirPath);\n      const results: StorageFileInfo[] = [];\n      for (const entry of entries) {\n        const fullKey = prefix ? `${prefix}/${entry}` : entry;\n        try {\n          const info = await this.getInfo(fullKey);\n          results.push(info);\n        } catch {\n          // Skip entries that can't be stat'd\n        }\n      }\n      return results;\n    } catch {\n      return [];\n    }\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { LocalStorageAdapter } from './local-storage-adapter.js';\nimport type { LocalStorageAdapterOptions } from './local-storage-adapter.js';\n\n/**\n * Configuration options for the StorageServicePlugin.\n */\nexport interface StorageServicePluginOptions {\n  /** Storage adapter type (default: 'local') */\n  adapter?: 'local' | 's3';\n  /** Options for the local storage adapter */\n  local?: LocalStorageAdapterOptions;\n  /** S3 configuration (used when adapter is 's3') */\n  s3?: { bucket: string; region: string; endpoint?: string };\n}\n\n/**\n * StorageServicePlugin — Production IStorageService implementation.\n *\n * Registers a file storage service with the kernel during the init phase.\n * Supports local filesystem and S3 adapters.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { StorageServicePlugin } from '@objectstack/service-storage';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new StorageServicePlugin({\n *   adapter: 'local',\n *   local: { rootDir: './uploads' },\n * }));\n * await kernel.bootstrap();\n *\n * const storage = kernel.getService('file-storage');\n * await storage.upload('file.txt', Buffer.from('hello'));\n * ```\n */\nexport class StorageServicePlugin implements Plugin {\n  name = 'com.objectstack.service.storage';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: StorageServicePluginOptions;\n\n  constructor(options: StorageServicePluginOptions = {}) {\n    this.options = { adapter: 'local', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapter = this.options.adapter;\n    if (adapter === 's3') {\n      throw new Error(\n        'S3 storage adapter is not yet implemented. ' +\n        'Use adapter: \"local\" or provide a custom IStorageService via ctx.registerService(\"file-storage\", impl).'\n      );\n    }\n\n    const rootDir = this.options.local?.rootDir ?? './storage';\n    const storage = new LocalStorageAdapter({ rootDir });\n    ctx.registerService('file-storage', storage);\n    ctx.logger.info(`StorageServicePlugin: registered local storage adapter (root: ${rootDir})`);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration for the S3 storage adapter.\n */\nexport interface S3StorageAdapterOptions {\n  /** S3 bucket name */\n  bucket: string;\n  /** AWS region (e.g. 'us-east-1') */\n  region: string;\n  /** Optional endpoint URL for S3-compatible services (MinIO, etc.) */\n  endpoint?: string;\n  /** AWS access key ID */\n  accessKeyId?: string;\n  /** AWS secret access key */\n  secretAccessKey?: string;\n}\n\n/**\n * S3 storage adapter skeleton implementing IStorageService.\n *\n * This is a placeholder for future AWS S3 integration.\n * Concrete implementation will use the `@aws-sdk/client-s3` package.\n *\n * @example\n * ```ts\n * const storage = new S3StorageAdapter({\n *   bucket: 'my-bucket',\n *   region: 'us-east-1',\n * });\n * await storage.upload('path/to/file.txt', buffer);\n * ```\n */\nexport class S3StorageAdapter implements IStorageService {\n  private readonly bucket: string;\n  private readonly region: string;\n\n  constructor(options: S3StorageAdapterOptions) {\n    this.bucket = options.bucket;\n    this.region = options.region;\n  }\n\n  async upload(_key: string, _data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    throw new Error(`S3StorageAdapter not yet implemented (bucket: ${this.bucket}, region: ${this.region})`);\n  }\n\n  async download(_key: string): Promise<Buffer> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async delete(_key: string): Promise<void> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async exists(_key: string): Promise<boolean> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getInfo(_key: string): Promise<StorageFileInfo> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async list(_prefix: string): Promise<StorageFileInfo[]> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getSignedUrl(_key: string, _expiresIn: number): Promise<string> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,qBAA+B;AAC/B,uBAA8B;AAiBvB,IAAM,sBAAN,MAAqD;AAAA,EAG1D,YAAY,SAAqC;AAC/C,SAAK,UAAU,QAAQ;AAAA,EACzB;AAAA,EAEQ,YAAY,KAAqB;AACvC,eAAO,uBAAK,KAAK,SAAS,GAAG;AAAA,EAC/B;AAAA,EAEA,MAAM,OAAO,KAAa,MAA+B,UAAgD;AACvG,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,UAAM,eAAAA,SAAG,UAAM,0BAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAErD,QAAI,gBAAgB,QAAQ;AAC1B,YAAM,eAAAA,SAAG,UAAU,UAAU,IAAI;AAAA,IACnC,OAAO;AAEL,YAAM,SAAuB,CAAC;AAC9B,YAAM,SAAU,KAAwB,UAAU;AAClD,UAAI,OAAO;AACX,aAAO,CAAC,MAAM;AACZ,cAAM,SAAS,MAAM,OAAO,KAAK;AACjC,eAAO,OAAO;AACd,YAAI,OAAO,MAAO,QAAO,KAAK,OAAO,KAAK;AAAA,MAC5C;AACA,YAAM,eAAAA,SAAG,UAAU,UAAU,OAAO,OAAO,MAAM,CAAC;AAAA,IACpD;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,KAA8B;AAC3C,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,WAAO,eAAAA,SAAG,SAAS,QAAQ;AAAA,EAC7B;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,UAAM,eAAAA,SAAG,OAAO,QAAQ;AAAA,EAC1B;AAAA,EAEA,MAAM,OAAO,KAA+B;AAC1C,QAAI;AACF,YAAM,eAAAA,SAAG,OAAO,KAAK,YAAY,GAAG,CAAC;AACrC,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,KAAuC;AACnD,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,UAAM,OAAO,MAAM,eAAAA,SAAG,KAAK,QAAQ;AACnC,WAAO;AAAA,MACL;AAAA,MACA,MAAM,KAAK;AAAA,MACX,cAAc,KAAK;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,QAA4C;AACrD,UAAM,UAAU,KAAK,YAAY,MAAM;AACvC,QAAI;AACF,YAAM,UAAU,MAAM,eAAAA,SAAG,QAAQ,OAAO;AACxC,YAAM,UAA6B,CAAC;AACpC,iBAAW,SAAS,SAAS;AAC3B,cAAM,UAAU,SAAS,GAAG,MAAM,IAAI,KAAK,KAAK;AAChD,YAAI;AACF,gBAAM,OAAO,MAAM,KAAK,QAAQ,OAAO;AACvC,kBAAQ,KAAK,IAAI;AAAA,QACnB,QAAQ;AAAA,QAER;AAAA,MACF;AACA,aAAO;AAAA,IACT,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;;;AC3DO,IAAM,uBAAN,MAA6C;AAAA,EAOlD,YAAY,UAAuC,CAAC,GAAG;AANvD,gBAAO;AACP,mBAAU;AACV,gBAAO;AAKL,SAAK,UAAU,EAAE,SAAS,SAAS,GAAG,QAAQ;AAAA,EAChD;AAAA,EAEA,MAAM,KAAK,KAAmC;AAC5C,UAAM,UAAU,KAAK,QAAQ;AAC7B,QAAI,YAAY,MAAM;AACpB,YAAM,IAAI;AAAA,QACR;AAAA,MAEF;AAAA,IACF;AAEA,UAAM,UAAU,KAAK,QAAQ,OAAO,WAAW;AAC/C,UAAM,UAAU,IAAI,oBAAoB,EAAE,QAAQ,CAAC;AACnD,QAAI,gBAAgB,gBAAgB,OAAO;AAC3C,QAAI,OAAO,KAAK,iEAAiE,OAAO,GAAG;AAAA,EAC7F;AACF;;;AC9BO,IAAM,mBAAN,MAAkD;AAAA,EAIvD,YAAY,SAAkC;AAC5C,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ;AAAA,EACxB;AAAA,EAEA,MAAM,OAAO,MAAc,OAAgC,UAAgD;AACzG,UAAM,IAAI,MAAM,iDAAiD,KAAK,MAAM,aAAa,KAAK,MAAM,GAAG;AAAA,EACzG;AAAA,EAEA,MAAM,SAAS,MAA+B;AAC5C,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,OAAO,MAA6B;AACxC,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,OAAO,MAAgC;AAC3C,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,QAAQ,MAAwC;AACpD,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,KAAK,SAA6C;AACtD,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,aAAa,MAAc,YAAqC;AACpE,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AACF;","names":["fs"]}
+{"version":3,"sources":["../src/index.ts","../src/local-storage-adapter.ts","../src/storage-service-plugin.ts","../src/s3-storage-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { StorageServicePlugin } from './storage-service-plugin.js';\nexport type { StorageServicePluginOptions } from './storage-service-plugin.js';\nexport { LocalStorageAdapter } from './local-storage-adapter.js';\nexport type { LocalStorageAdapterOptions } from './local-storage-adapter.js';\nexport { S3StorageAdapter } from './s3-storage-adapter.js';\nexport type { S3StorageAdapterOptions } from './s3-storage-adapter.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { promises as fs } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for LocalStorageAdapter.\n */\nexport interface LocalStorageAdapterOptions {\n  /** Root directory for file storage */\n  rootDir: string;\n}\n\n/**\n * Local filesystem storage adapter implementing IStorageService.\n *\n * Stores files on the local disk under a configurable root directory.\n * Suitable for development, testing, and single-server deployments.\n */\nexport class LocalStorageAdapter implements IStorageService {\n  private readonly rootDir: string;\n\n  constructor(options: LocalStorageAdapterOptions) {\n    this.rootDir = options.rootDir;\n  }\n\n  private resolvePath(key: string): string {\n    return join(this.rootDir, key);\n  }\n\n  async upload(key: string, data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.mkdir(dirname(filePath), { recursive: true });\n\n    if (data instanceof Buffer) {\n      await fs.writeFile(filePath, data);\n    } else {\n      // Convert ReadableStream to Buffer\n      const chunks: Uint8Array[] = [];\n      const reader = (data as ReadableStream).getReader();\n      let done = false;\n      while (!done) {\n        const result = await reader.read();\n        done = result.done;\n        if (result.value) chunks.push(result.value);\n      }\n      await fs.writeFile(filePath, Buffer.concat(chunks));\n    }\n  }\n\n  async download(key: string): Promise<Buffer> {\n    const filePath = this.resolvePath(key);\n    return fs.readFile(filePath);\n  }\n\n  async delete(key: string): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.unlink(filePath);\n  }\n\n  async exists(key: string): Promise<boolean> {\n    try {\n      await fs.access(this.resolvePath(key));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async getInfo(key: string): Promise<StorageFileInfo> {\n    const filePath = this.resolvePath(key);\n    const stat = await fs.stat(filePath);\n    return {\n      key,\n      size: stat.size,\n      lastModified: stat.mtime,\n    };\n  }\n\n  async list(prefix: string): Promise<StorageFileInfo[]> {\n    const dirPath = this.resolvePath(prefix);\n    try {\n      const entries = await fs.readdir(dirPath);\n      const results: StorageFileInfo[] = [];\n      for (const entry of entries) {\n        const fullKey = prefix ? `${prefix}/${entry}` : entry;\n        try {\n          const info = await this.getInfo(fullKey);\n          results.push(info);\n        } catch {\n          // Skip entries that can't be stat'd\n        }\n      }\n      return results;\n    } catch {\n      return [];\n    }\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { LocalStorageAdapter } from './local-storage-adapter.js';\nimport type { LocalStorageAdapterOptions } from './local-storage-adapter.js';\n\n/**\n * Configuration options for the StorageServicePlugin.\n */\nexport interface StorageServicePluginOptions {\n  /** Storage adapter type (default: 'local') */\n  adapter?: 'local' | 's3';\n  /** Options for the local storage adapter */\n  local?: LocalStorageAdapterOptions;\n  /** S3 configuration (used when adapter is 's3') */\n  s3?: { bucket: string; region: string; endpoint?: string };\n}\n\n/**\n * StorageServicePlugin — Production IStorageService implementation.\n *\n * Registers a file storage service with the kernel during the init phase.\n * Supports local filesystem and S3 adapters.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { StorageServicePlugin } from '@objectstack/service-storage';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new StorageServicePlugin({\n *   adapter: 'local',\n *   local: { rootDir: './uploads' },\n * }));\n * await kernel.bootstrap();\n *\n * const storage = kernel.getService('file-storage');\n * await storage.upload('file.txt', Buffer.from('hello'));\n * ```\n */\nexport class StorageServicePlugin implements Plugin {\n  name = 'com.objectstack.service.storage';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: StorageServicePluginOptions;\n\n  constructor(options: StorageServicePluginOptions = {}) {\n    this.options = { adapter: 'local', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapter = this.options.adapter;\n    if (adapter === 's3') {\n      throw new Error(\n        'S3 storage adapter is not yet implemented. ' +\n        'Use adapter: \"local\" or provide a custom IStorageService via ctx.registerService(\"file-storage\", impl).'\n      );\n    }\n\n    const rootDir = this.options.local?.rootDir ?? './storage';\n    const storage = new LocalStorageAdapter({ rootDir });\n    ctx.registerService('file-storage', storage);\n    ctx.logger.info(`StorageServicePlugin: registered local storage adapter (root: ${rootDir})`);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration for the S3 storage adapter.\n */\nexport interface S3StorageAdapterOptions {\n  /** S3 bucket name */\n  bucket: string;\n  /** AWS region (e.g. 'us-east-1') */\n  region: string;\n  /** Optional endpoint URL for S3-compatible services (MinIO, etc.) */\n  endpoint?: string;\n  /** AWS access key ID */\n  accessKeyId?: string;\n  /** AWS secret access key */\n  secretAccessKey?: string;\n}\n\n/**\n * S3 storage adapter skeleton implementing IStorageService.\n *\n * This is a placeholder for future AWS S3 integration.\n * Concrete implementation will use the `@aws-sdk/client-s3` package.\n *\n * @example\n * ```ts\n * const storage = new S3StorageAdapter({\n *   bucket: 'my-bucket',\n *   region: 'us-east-1',\n * });\n * await storage.upload('path/to/file.txt', buffer);\n * ```\n */\nexport class S3StorageAdapter implements IStorageService {\n  private readonly bucket: string;\n  private readonly region: string;\n\n  constructor(options: S3StorageAdapterOptions) {\n    this.bucket = options.bucket;\n    this.region = options.region;\n  }\n\n  async upload(_key: string, _data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    throw new Error(`S3StorageAdapter not yet implemented (bucket: ${this.bucket}, region: ${this.region})`);\n  }\n\n  async download(_key: string): Promise<Buffer> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async delete(_key: string): Promise<void> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async exists(_key: string): Promise<boolean> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getInfo(_key: string): Promise<StorageFileInfo> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async list(_prefix: string): Promise<StorageFileInfo[]> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getSignedUrl(_key: string, _expiresIn: number): Promise<string> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async initiateChunkedUpload(_key: string, _options?: StorageUploadOptions): Promise<string> {\n    throw new Error('S3StorageAdapter.initiateChunkedUpload not yet implemented');\n  }\n\n  async uploadChunk(_uploadId: string, _partNumber: number, _data: Buffer): Promise<string> {\n    throw new Error('S3StorageAdapter.uploadChunk not yet implemented');\n  }\n\n  async completeChunkedUpload(_uploadId: string, _parts: Array<{ partNumber: number; eTag: string }>): Promise<string> {\n    throw new Error('S3StorageAdapter.completeChunkedUpload not yet implemented');\n  }\n\n  async abortChunkedUpload(_uploadId: string): Promise<void> {\n    throw new Error('S3StorageAdapter.abortChunkedUpload not yet implemented');\n  }\n}\n"],"mappings":"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","names":["fs"]}

package/dist/index.d.cts

@@ -113,6 +113,13 @@ declare class S3StorageAdapter implements IStorageService {
     getInfo(_key: string): Promise<StorageFileInfo>;
     list(_prefix: string): Promise<StorageFileInfo[]>;
     getSignedUrl(_key: string, _expiresIn: number): Promise<string>;
+    initiateChunkedUpload(_key: string, _options?: StorageUploadOptions): Promise<string>;
+    uploadChunk(_uploadId: string, _partNumber: number, _data: Buffer): Promise<string>;
+    completeChunkedUpload(_uploadId: string, _parts: Array<{
+        partNumber: number;
+        eTag: string;
+    }>): Promise<string>;
+    abortChunkedUpload(_uploadId: string): Promise<void>;
 }
 
 export { LocalStorageAdapter, type LocalStorageAdapterOptions, S3StorageAdapter, type S3StorageAdapterOptions, StorageServicePlugin, type StorageServicePluginOptions };

package/dist/index.d.ts

@@ -113,6 +113,13 @@ declare class S3StorageAdapter implements IStorageService {
     getInfo(_key: string): Promise<StorageFileInfo>;
     list(_prefix: string): Promise<StorageFileInfo[]>;
     getSignedUrl(_key: string, _expiresIn: number): Promise<string>;
+    initiateChunkedUpload(_key: string, _options?: StorageUploadOptions): Promise<string>;
+    uploadChunk(_uploadId: string, _partNumber: number, _data: Buffer): Promise<string>;
+    completeChunkedUpload(_uploadId: string, _parts: Array<{
+        partNumber: number;
+        eTag: string;
+    }>): Promise<string>;
+    abortChunkedUpload(_uploadId: string): Promise<void>;
 }
 
 export { LocalStorageAdapter, type LocalStorageAdapterOptions, S3StorageAdapter, type S3StorageAdapterOptions, StorageServicePlugin, type StorageServicePluginOptions };

package/dist/index.js

@@ -119,6 +119,18 @@ var S3StorageAdapter = class {
   async getSignedUrl(_key, _expiresIn) {
     throw new Error("S3StorageAdapter not yet implemented");
   }
+  async initiateChunkedUpload(_key, _options) {
+    throw new Error("S3StorageAdapter.initiateChunkedUpload not yet implemented");
+  }
+  async uploadChunk(_uploadId, _partNumber, _data) {
+    throw new Error("S3StorageAdapter.uploadChunk not yet implemented");
+  }
+  async completeChunkedUpload(_uploadId, _parts) {
+    throw new Error("S3StorageAdapter.completeChunkedUpload not yet implemented");
+  }
+  async abortChunkedUpload(_uploadId) {
+    throw new Error("S3StorageAdapter.abortChunkedUpload not yet implemented");
+  }
 };
 export {
   LocalStorageAdapter,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/local-storage-adapter.ts","../src/storage-service-plugin.ts","../src/s3-storage-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { promises as fs } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for LocalStorageAdapter.\n */\nexport interface LocalStorageAdapterOptions {\n  /** Root directory for file storage */\n  rootDir: string;\n}\n\n/**\n * Local filesystem storage adapter implementing IStorageService.\n *\n * Stores files on the local disk under a configurable root directory.\n * Suitable for development, testing, and single-server deployments.\n */\nexport class LocalStorageAdapter implements IStorageService {\n  private readonly rootDir: string;\n\n  constructor(options: LocalStorageAdapterOptions) {\n    this.rootDir = options.rootDir;\n  }\n\n  private resolvePath(key: string): string {\n    return join(this.rootDir, key);\n  }\n\n  async upload(key: string, data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.mkdir(dirname(filePath), { recursive: true });\n\n    if (data instanceof Buffer) {\n      await fs.writeFile(filePath, data);\n    } else {\n      // Convert ReadableStream to Buffer\n      const chunks: Uint8Array[] = [];\n      const reader = (data as ReadableStream).getReader();\n      let done = false;\n      while (!done) {\n        const result = await reader.read();\n        done = result.done;\n        if (result.value) chunks.push(result.value);\n      }\n      await fs.writeFile(filePath, Buffer.concat(chunks));\n    }\n  }\n\n  async download(key: string): Promise<Buffer> {\n    const filePath = this.resolvePath(key);\n    return fs.readFile(filePath);\n  }\n\n  async delete(key: string): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.unlink(filePath);\n  }\n\n  async exists(key: string): Promise<boolean> {\n    try {\n      await fs.access(this.resolvePath(key));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async getInfo(key: string): Promise<StorageFileInfo> {\n    const filePath = this.resolvePath(key);\n    const stat = await fs.stat(filePath);\n    return {\n      key,\n      size: stat.size,\n      lastModified: stat.mtime,\n    };\n  }\n\n  async list(prefix: string): Promise<StorageFileInfo[]> {\n    const dirPath = this.resolvePath(prefix);\n    try {\n      const entries = await fs.readdir(dirPath);\n      const results: StorageFileInfo[] = [];\n      for (const entry of entries) {\n        const fullKey = prefix ? `${prefix}/${entry}` : entry;\n        try {\n          const info = await this.getInfo(fullKey);\n          results.push(info);\n        } catch {\n          // Skip entries that can't be stat'd\n        }\n      }\n      return results;\n    } catch {\n      return [];\n    }\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { LocalStorageAdapter } from './local-storage-adapter.js';\nimport type { LocalStorageAdapterOptions } from './local-storage-adapter.js';\n\n/**\n * Configuration options for the StorageServicePlugin.\n */\nexport interface StorageServicePluginOptions {\n  /** Storage adapter type (default: 'local') */\n  adapter?: 'local' | 's3';\n  /** Options for the local storage adapter */\n  local?: LocalStorageAdapterOptions;\n  /** S3 configuration (used when adapter is 's3') */\n  s3?: { bucket: string; region: string; endpoint?: string };\n}\n\n/**\n * StorageServicePlugin — Production IStorageService implementation.\n *\n * Registers a file storage service with the kernel during the init phase.\n * Supports local filesystem and S3 adapters.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { StorageServicePlugin } from '@objectstack/service-storage';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new StorageServicePlugin({\n *   adapter: 'local',\n *   local: { rootDir: './uploads' },\n * }));\n * await kernel.bootstrap();\n *\n * const storage = kernel.getService('file-storage');\n * await storage.upload('file.txt', Buffer.from('hello'));\n * ```\n */\nexport class StorageServicePlugin implements Plugin {\n  name = 'com.objectstack.service.storage';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: StorageServicePluginOptions;\n\n  constructor(options: StorageServicePluginOptions = {}) {\n    this.options = { adapter: 'local', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapter = this.options.adapter;\n    if (adapter === 's3') {\n      throw new Error(\n        'S3 storage adapter is not yet implemented. ' +\n        'Use adapter: \"local\" or provide a custom IStorageService via ctx.registerService(\"file-storage\", impl).'\n      );\n    }\n\n    const rootDir = this.options.local?.rootDir ?? './storage';\n    const storage = new LocalStorageAdapter({ rootDir });\n    ctx.registerService('file-storage', storage);\n    ctx.logger.info(`StorageServicePlugin: registered local storage adapter (root: ${rootDir})`);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration for the S3 storage adapter.\n */\nexport interface S3StorageAdapterOptions {\n  /** S3 bucket name */\n  bucket: string;\n  /** AWS region (e.g. 'us-east-1') */\n  region: string;\n  /** Optional endpoint URL for S3-compatible services (MinIO, etc.) */\n  endpoint?: string;\n  /** AWS access key ID */\n  accessKeyId?: string;\n  /** AWS secret access key */\n  secretAccessKey?: string;\n}\n\n/**\n * S3 storage adapter skeleton implementing IStorageService.\n *\n * This is a placeholder for future AWS S3 integration.\n * Concrete implementation will use the `@aws-sdk/client-s3` package.\n *\n * @example\n * ```ts\n * const storage = new S3StorageAdapter({\n *   bucket: 'my-bucket',\n *   region: 'us-east-1',\n * });\n * await storage.upload('path/to/file.txt', buffer);\n * ```\n */\nexport class S3StorageAdapter implements IStorageService {\n  private readonly bucket: string;\n  private readonly region: string;\n\n  constructor(options: S3StorageAdapterOptions) {\n    this.bucket = options.bucket;\n    this.region = options.region;\n  }\n\n  async upload(_key: string, _data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    throw new Error(`S3StorageAdapter not yet implemented (bucket: ${this.bucket}, region: ${this.region})`);\n  }\n\n  async download(_key: string): Promise<Buffer> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async delete(_key: string): Promise<void> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async exists(_key: string): Promise<boolean> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getInfo(_key: string): Promise<StorageFileInfo> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async list(_prefix: string): Promise<StorageFileInfo[]> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getSignedUrl(_key: string, _expiresIn: number): Promise<string> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/local-storage-adapter.ts","../src/storage-service-plugin.ts","../src/s3-storage-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { promises as fs } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for LocalStorageAdapter.\n */\nexport interface LocalStorageAdapterOptions {\n  /** Root directory for file storage */\n  rootDir: string;\n}\n\n/**\n * Local filesystem storage adapter implementing IStorageService.\n *\n * Stores files on the local disk under a configurable root directory.\n * Suitable for development, testing, and single-server deployments.\n */\nexport class LocalStorageAdapter implements IStorageService {\n  private readonly rootDir: string;\n\n  constructor(options: LocalStorageAdapterOptions) {\n    this.rootDir = options.rootDir;\n  }\n\n  private resolvePath(key: string): string {\n    return join(this.rootDir, key);\n  }\n\n  async upload(key: string, data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.mkdir(dirname(filePath), { recursive: true });\n\n    if (data instanceof Buffer) {\n      await fs.writeFile(filePath, data);\n    } else {\n      // Convert ReadableStream to Buffer\n      const chunks: Uint8Array[] = [];\n      const reader = (data as ReadableStream).getReader();\n      let done = false;\n      while (!done) {\n        const result = await reader.read();\n        done = result.done;\n        if (result.value) chunks.push(result.value);\n      }\n      await fs.writeFile(filePath, Buffer.concat(chunks));\n    }\n  }\n\n  async download(key: string): Promise<Buffer> {\n    const filePath = this.resolvePath(key);\n    return fs.readFile(filePath);\n  }\n\n  async delete(key: string): Promise<void> {\n    const filePath = this.resolvePath(key);\n    await fs.unlink(filePath);\n  }\n\n  async exists(key: string): Promise<boolean> {\n    try {\n      await fs.access(this.resolvePath(key));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async getInfo(key: string): Promise<StorageFileInfo> {\n    const filePath = this.resolvePath(key);\n    const stat = await fs.stat(filePath);\n    return {\n      key,\n      size: stat.size,\n      lastModified: stat.mtime,\n    };\n  }\n\n  async list(prefix: string): Promise<StorageFileInfo[]> {\n    const dirPath = this.resolvePath(prefix);\n    try {\n      const entries = await fs.readdir(dirPath);\n      const results: StorageFileInfo[] = [];\n      for (const entry of entries) {\n        const fullKey = prefix ? `${prefix}/${entry}` : entry;\n        try {\n          const info = await this.getInfo(fullKey);\n          results.push(info);\n        } catch {\n          // Skip entries that can't be stat'd\n        }\n      }\n      return results;\n    } catch {\n      return [];\n    }\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { LocalStorageAdapter } from './local-storage-adapter.js';\nimport type { LocalStorageAdapterOptions } from './local-storage-adapter.js';\n\n/**\n * Configuration options for the StorageServicePlugin.\n */\nexport interface StorageServicePluginOptions {\n  /** Storage adapter type (default: 'local') */\n  adapter?: 'local' | 's3';\n  /** Options for the local storage adapter */\n  local?: LocalStorageAdapterOptions;\n  /** S3 configuration (used when adapter is 's3') */\n  s3?: { bucket: string; region: string; endpoint?: string };\n}\n\n/**\n * StorageServicePlugin — Production IStorageService implementation.\n *\n * Registers a file storage service with the kernel during the init phase.\n * Supports local filesystem and S3 adapters.\n *\n * @example\n * ```ts\n * import { ObjectKernel } from '@objectstack/core';\n * import { StorageServicePlugin } from '@objectstack/service-storage';\n *\n * const kernel = new ObjectKernel();\n * kernel.use(new StorageServicePlugin({\n *   adapter: 'local',\n *   local: { rootDir: './uploads' },\n * }));\n * await kernel.bootstrap();\n *\n * const storage = kernel.getService('file-storage');\n * await storage.upload('file.txt', Buffer.from('hello'));\n * ```\n */\nexport class StorageServicePlugin implements Plugin {\n  name = 'com.objectstack.service.storage';\n  version = '1.0.0';\n  type = 'standard';\n\n  private readonly options: StorageServicePluginOptions;\n\n  constructor(options: StorageServicePluginOptions = {}) {\n    this.options = { adapter: 'local', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const adapter = this.options.adapter;\n    if (adapter === 's3') {\n      throw new Error(\n        'S3 storage adapter is not yet implemented. ' +\n        'Use adapter: \"local\" or provide a custom IStorageService via ctx.registerService(\"file-storage\", impl).'\n      );\n    }\n\n    const rootDir = this.options.local?.rootDir ?? './storage';\n    const storage = new LocalStorageAdapter({ rootDir });\n    ctx.registerService('file-storage', storage);\n    ctx.logger.info(`StorageServicePlugin: registered local storage adapter (root: ${rootDir})`);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IStorageService, StorageUploadOptions, StorageFileInfo } from '@objectstack/spec/contracts';\n\n/**\n * Configuration for the S3 storage adapter.\n */\nexport interface S3StorageAdapterOptions {\n  /** S3 bucket name */\n  bucket: string;\n  /** AWS region (e.g. 'us-east-1') */\n  region: string;\n  /** Optional endpoint URL for S3-compatible services (MinIO, etc.) */\n  endpoint?: string;\n  /** AWS access key ID */\n  accessKeyId?: string;\n  /** AWS secret access key */\n  secretAccessKey?: string;\n}\n\n/**\n * S3 storage adapter skeleton implementing IStorageService.\n *\n * This is a placeholder for future AWS S3 integration.\n * Concrete implementation will use the `@aws-sdk/client-s3` package.\n *\n * @example\n * ```ts\n * const storage = new S3StorageAdapter({\n *   bucket: 'my-bucket',\n *   region: 'us-east-1',\n * });\n * await storage.upload('path/to/file.txt', buffer);\n * ```\n */\nexport class S3StorageAdapter implements IStorageService {\n  private readonly bucket: string;\n  private readonly region: string;\n\n  constructor(options: S3StorageAdapterOptions) {\n    this.bucket = options.bucket;\n    this.region = options.region;\n  }\n\n  async upload(_key: string, _data: Buffer | ReadableStream, _options?: StorageUploadOptions): Promise<void> {\n    throw new Error(`S3StorageAdapter not yet implemented (bucket: ${this.bucket}, region: ${this.region})`);\n  }\n\n  async download(_key: string): Promise<Buffer> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async delete(_key: string): Promise<void> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async exists(_key: string): Promise<boolean> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getInfo(_key: string): Promise<StorageFileInfo> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async list(_prefix: string): Promise<StorageFileInfo[]> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async getSignedUrl(_key: string, _expiresIn: number): Promise<string> {\n    throw new Error('S3StorageAdapter not yet implemented');\n  }\n\n  async initiateChunkedUpload(_key: string, _options?: StorageUploadOptions): Promise<string> {\n    throw new Error('S3StorageAdapter.initiateChunkedUpload not yet implemented');\n  }\n\n  async uploadChunk(_uploadId: string, _partNumber: number, _data: Buffer): Promise<string> {\n    throw new Error('S3StorageAdapter.uploadChunk not yet implemented');\n  }\n\n  async completeChunkedUpload(_uploadId: string, _parts: Array<{ partNumber: number; eTag: string }>): Promise<string> {\n    throw new Error('S3StorageAdapter.completeChunkedUpload not yet implemented');\n  }\n\n  async abortChunkedUpload(_uploadId: string): Promise<void> {\n    throw new Error('S3StorageAdapter.abortChunkedUpload not yet implemented');\n  }\n}\n"],"mappings":";AAEA,SAAS,YAAY,UAAU;AAC/B,SAAS,MAAM,eAAe;AAiBvB,IAAM,sBAAN,MAAqD;AAAA,EAG1D,YAAY,SAAqC;AAC/C,SAAK,UAAU,QAAQ;AAAA,EACzB;AAAA,EAEQ,YAAY,KAAqB;AACvC,WAAO,KAAK,KAAK,SAAS,GAAG;AAAA,EAC/B;AAAA,EAEA,MAAM,OAAO,KAAa,MAA+B,UAAgD;AACvG,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,UAAM,GAAG,MAAM,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAErD,QAAI,gBAAgB,QAAQ;AAC1B,YAAM,GAAG,UAAU,UAAU,IAAI;AAAA,IACnC,OAAO;AAEL,YAAM,SAAuB,CAAC;AAC9B,YAAM,SAAU,KAAwB,UAAU;AAClD,UAAI,OAAO;AACX,aAAO,CAAC,MAAM;AACZ,cAAM,SAAS,MAAM,OAAO,KAAK;AACjC,eAAO,OAAO;AACd,YAAI,OAAO,MAAO,QAAO,KAAK,OAAO,KAAK;AAAA,MAC5C;AACA,YAAM,GAAG,UAAU,UAAU,OAAO,OAAO,MAAM,CAAC;AAAA,IACpD;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,KAA8B;AAC3C,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,WAAO,GAAG,SAAS,QAAQ;AAAA,EAC7B;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,UAAM,GAAG,OAAO,QAAQ;AAAA,EAC1B;AAAA,EAEA,MAAM,OAAO,KAA+B;AAC1C,QAAI;AACF,YAAM,GAAG,OAAO,KAAK,YAAY,GAAG,CAAC;AACrC,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,KAAuC;AACnD,UAAM,WAAW,KAAK,YAAY,GAAG;AACrC,UAAM,OAAO,MAAM,GAAG,KAAK,QAAQ;AACnC,WAAO;AAAA,MACL;AAAA,MACA,MAAM,KAAK;AAAA,MACX,cAAc,KAAK;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,QAA4C;AACrD,UAAM,UAAU,KAAK,YAAY,MAAM;AACvC,QAAI;AACF,YAAM,UAAU,MAAM,GAAG,QAAQ,OAAO;AACxC,YAAM,UAA6B,CAAC;AACpC,iBAAW,SAAS,SAAS;AAC3B,cAAM,UAAU,SAAS,GAAG,MAAM,IAAI,KAAK,KAAK;AAChD,YAAI;AACF,gBAAM,OAAO,MAAM,KAAK,QAAQ,OAAO;AACvC,kBAAQ,KAAK,IAAI;AAAA,QACnB,QAAQ;AAAA,QAER;AAAA,MACF;AACA,aAAO;AAAA,IACT,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;;;AC3DO,IAAM,uBAAN,MAA6C;AAAA,EAOlD,YAAY,UAAuC,CAAC,GAAG;AANvD,gBAAO;AACP,mBAAU;AACV,gBAAO;AAKL,SAAK,UAAU,EAAE,SAAS,SAAS,GAAG,QAAQ;AAAA,EAChD;AAAA,EAEA,MAAM,KAAK,KAAmC;AAC5C,UAAM,UAAU,KAAK,QAAQ;AAC7B,QAAI,YAAY,MAAM;AACpB,YAAM,IAAI;AAAA,QACR;AAAA,MAEF;AAAA,IACF;AAEA,UAAM,UAAU,KAAK,QAAQ,OAAO,WAAW;AAC/C,UAAM,UAAU,IAAI,oBAAoB,EAAE,QAAQ,CAAC;AACnD,QAAI,gBAAgB,gBAAgB,OAAO;AAC3C,QAAI,OAAO,KAAK,iEAAiE,OAAO,GAAG;AAAA,EAC7F;AACF;;;AC9BO,IAAM,mBAAN,MAAkD;AAAA,EAIvD,YAAY,SAAkC;AAC5C,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ;AAAA,EACxB;AAAA,EAEA,MAAM,OAAO,MAAc,OAAgC,UAAgD;AACzG,UAAM,IAAI,MAAM,iDAAiD,KAAK,MAAM,aAAa,KAAK,MAAM,GAAG;AAAA,EACzG;AAAA,EAEA,MAAM,SAAS,MAA+B;AAC5C,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,OAAO,MAA6B;AACxC,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,OAAO,MAAgC;AAC3C,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,QAAQ,MAAwC;AACpD,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,KAAK,SAA6C;AACtD,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,aAAa,MAAc,YAAqC;AACpE,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,MAAM,sBAAsB,MAAc,UAAkD;AAC1F,UAAM,IAAI,MAAM,4DAA4D;AAAA,EAC9E;AAAA,EAEA,MAAM,YAAY,WAAmB,aAAqB,OAAgC;AACxF,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAAA,EAEA,MAAM,sBAAsB,WAAmB,QAAsE;AACnH,UAAM,IAAI,MAAM,4DAA4D;AAAA,EAC9E;AAAA,EAEA,MAAM,mBAAmB,WAAkC;AACzD,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/service-storage",
-  "version": "3.0.7",
+  "version": "3.0.9",
   "license": "Apache-2.0",
   "description": "Storage Service for ObjectStack — implements IStorageService with local filesystem and S3 adapter skeleton",
   "type": "module",
@@ -14,8 +14,8 @@
     }
   },
   "dependencies": {
-    "@objectstack/core": "3.0.7",
-    "@objectstack/spec": "3.0.7"
+    "@objectstack/core": "3.0.9",
+    "@objectstack/spec": "3.0.9"
   },
   "devDependencies": {
     "typescript": "^5.0.0",

package/src/s3-storage-adapter.ts

@@ -69,4 +69,20 @@ export class S3StorageAdapter implements IStorageService {
   async getSignedUrl(_key: string, _expiresIn: number): Promise<string> {
     throw new Error('S3StorageAdapter not yet implemented');
   }
+
+  async initiateChunkedUpload(_key: string, _options?: StorageUploadOptions): Promise<string> {
+    throw new Error('S3StorageAdapter.initiateChunkedUpload not yet implemented');
+  }
+
+  async uploadChunk(_uploadId: string, _partNumber: number, _data: Buffer): Promise<string> {
+    throw new Error('S3StorageAdapter.uploadChunk not yet implemented');
+  }
+
+  async completeChunkedUpload(_uploadId: string, _parts: Array<{ partNumber: number; eTag: string }>): Promise<string> {
+    throw new Error('S3StorageAdapter.completeChunkedUpload not yet implemented');
+  }
+
+  async abortChunkedUpload(_uploadId: string): Promise<void> {
+    throw new Error('S3StorageAdapter.abortChunkedUpload not yet implemented');
+  }
 }