@powerlines/core 0.48.27 → 0.48.29

package/dist/storage/base.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"base.mjs","names":["#isDisposed"],"sources":["../../src/storage/base.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { appendPath } from \"@stryke/path/append\";\nimport { correctPath } from \"@stryke/path/correct-path\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { MaybePromise } from \"@stryke/types/base\";\nimport { resolve } from \"node:path\";\nimport { Context } from \"../types/context\";\nimport { StorageAdapter, StoragePreset } from \"../types/fs\";\n\nexport interface StorageAdapterOptions {\n  base: string;\n  isReadOnly?: boolean;\n  ignore?: string | string[];\n}\n\n/**\n * Abstract base class for storage adapters, providing a template for storage operations.\n */\nexport abstract class BaseStorageAdapter<\n  TOptions extends StorageAdapterOptions = StorageAdapterOptions\n> implements StorageAdapter {\n  /**\n   * Indicates whether the storage adapter has been disposed.\n   */\n  #isDisposed = false;\n\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public abstract name: string;\n\n  /**\n   * Configuration options for the storage adapter.\n   */\n  public options: TOptions;\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public readonly preset?: StoragePreset | null = null;\n\n  /**\n   * Constructor for the BaseStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(\n    protected context: Context,\n    options: TOptions = { base: \"/\" } as TOptions\n  ) {\n    this.options = options;\n    this.options.base = resolve(options.base);\n    this.options.isReadOnly = !!options.isReadOnly;\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public abstract existsSync(key: string): boolean;\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public async exists(key: string): Promise<boolean> {\n    return this.existsSync(key);\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public abstract getSync(key: string): string | null;\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public async get(key: string): Promise<string | null> {\n    return this.getSync(key);\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public abstract setSync(key: string, value: string): void;\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.setSync(key, value);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param _ - The path of the directory to create.\n   */\n  public mkdirSync(_: string) {}\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public async mkdir(dirPath: string): Promise<void> {\n    return Promise.resolve(this.mkdirSync(dirPath));\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public abstract removeSync(key: string): void;\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      this.removeSync(key);\n    }\n  }\n\n  /**\n   * Synchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   */\n  public clearSync(base?: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = this.listSync(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      keys.map(key =>\n        this.removeSync(\n          base && !key.startsWith(base) ? joinPaths(base, key) : key\n        )\n      );\n    }\n  }\n\n  /**\n   * Asynchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   * @returns A promise that resolves when the operation is complete.\n   */\n  public async clear(base?: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = await this.list(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      await Promise.all(\n        keys.map(async key =>\n          this.remove(\n            base && !key.startsWith(base) ? joinPaths(base, key) : key\n          )\n        )\n      );\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public abstract listSync(base?: string): string[];\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public async list(base?: string): Promise<string[]> {\n    return this.listSync(base);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param _ - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public isDirectorySync(_: string): boolean {\n    return false;\n  }\n\n  /**\n   * Checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.\n   */\n  public async isDirectory(key: string) {\n    return Promise.resolve(this.isDirectorySync(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public isFileSync(key: string): boolean {\n    return this.existsSync(key) && !this.isDirectorySync(key);\n  }\n\n  /**\n   * Checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.\n   */\n  public async isFile(key: string) {\n    return Promise.resolve(this.isFileSync(key));\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public dispose(): MaybePromise<void> {\n    return Promise.resolve();\n  }\n\n  /**\n   * Async dispose method to clean up resources.\n   *\n   * @returns A promise that resolves when disposal is complete.\n   */\n  public async [Symbol.asyncDispose]() {\n    return this._dispose();\n  }\n\n  /**\n   * Determines if the storage adapter is read-only based on the provided options.\n   *\n   * @returns `true` if the storage adapter is read-only, otherwise `false`.\n   */\n  protected get isReadOnly() {\n    return !!this.options.isReadOnly;\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected get overwrite() {\n    return !this.isReadOnly && this.context.config.output.overwrite !== false;\n  }\n\n  /**\n   * Resolves a given key to its full path within the storage adapter.\n   *\n   * @param key - The key to resolve.\n   * @returns The resolved full path for the key.\n   */\n  protected resolve(key?: string) {\n    if (!key) {\n      return this.options.base;\n    }\n\n    if (/\\.\\.:|\\.\\.$/.test(key)) {\n      throw new Error(\n        `[${this.name}]: Invalid key: ${JSON.stringify(key)} provided to storage adapter.`\n      );\n    }\n\n    return appendPath(correctPath(key).replace(/:/g, \"/\"), this.options.base);\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  protected async _dispose(): Promise<void> {\n    if (!this.#isDisposed) {\n      await Promise.resolve(this.dispose());\n      this.#isDisposed = true;\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"base.mjs","names":["#isDisposed"],"sources":["../../src/storage/base.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { appendPath } from \"@stryke/path/append\";\nimport { correctPath } from \"@stryke/path/correct-path\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { MaybePromise } from \"@stryke/types/base\";\nimport { resolve } from \"node:path\";\nimport { Context } from \"../types/context\";\nimport { StorageAdapter, StoragePreset } from \"../types/fs\";\n\nexport interface StorageAdapterOptions {\n  base: string;\n  isReadOnly?: boolean;\n  ignore?: string | string[];\n}\n\n/**\n * Abstract base class for storage adapters, providing a template for storage operations.\n */\nexport abstract class BaseStorageAdapter<\n  TOptions extends StorageAdapterOptions = StorageAdapterOptions\n> implements StorageAdapter {\n  /**\n   * Indicates whether the storage adapter has been disposed.\n   */\n  #isDisposed = false;\n\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public abstract name: string;\n\n  /**\n   * Configuration options for the storage adapter.\n   */\n  public options: TOptions;\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public readonly preset?: StoragePreset | null = null;\n\n  /**\n   * Constructor for the BaseStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(\n    protected context: Context,\n    options: TOptions = { base: \"/\" } as TOptions\n  ) {\n    this.options = options;\n    this.options.base = resolve(options.base);\n    this.options.isReadOnly = !!options.isReadOnly;\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public abstract existsSync(key: string): boolean;\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public async exists(key: string): Promise<boolean> {\n    return this.existsSync(key);\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public abstract getSync(key: string): string | null;\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public async get(key: string): Promise<string | null> {\n    return this.getSync(key);\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public abstract setSync(key: string, value: string): void;\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.setSync(key, value);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param _ - The path of the directory to create.\n   */\n  public mkdirSync(_: string) {}\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public async mkdir(dirPath: string): Promise<void> {\n    return Promise.resolve(this.mkdirSync(dirPath));\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public abstract removeSync(key: string): void;\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      this.removeSync(key);\n    }\n  }\n\n  /**\n   * Synchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   */\n  public clearSync(base?: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = this.listSync(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      keys.map(key =>\n        this.removeSync(\n          base && !key.startsWith(base) ? joinPaths(base, key) : key\n        )\n      );\n    }\n  }\n\n  /**\n   * Asynchronously removes all entries from the storage that match the provided base path.\n   *\n   * @param base - The base path to clear keys from.\n   * @returns A promise that resolves when the operation is complete.\n   */\n  public async clear(base?: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      const keys = await this.list(base || this.options.base);\n      if (!keys.length) {\n        return;\n      }\n\n      await Promise.all(\n        keys.map(async key =>\n          this.remove(\n            base && !key.startsWith(base) ? joinPaths(base, key) : key\n          )\n        )\n      );\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public abstract listSync(base?: string): string[];\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public async list(base?: string): Promise<string[]> {\n    return this.listSync(base);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param _ - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public isDirectorySync(_: string): boolean {\n    return false;\n  }\n\n  /**\n   * Checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.\n   */\n  public async isDirectory(key: string) {\n    return Promise.resolve(this.isDirectorySync(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public isFileSync(key: string): boolean {\n    return this.existsSync(key) && !this.isDirectorySync(key);\n  }\n\n  /**\n   * Checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.\n   */\n  public async isFile(key: string) {\n    return Promise.resolve(this.isFileSync(key));\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public dispose(): MaybePromise<void> {\n    return Promise.resolve();\n  }\n\n  /**\n   * Async dispose method to clean up resources.\n   *\n   * @returns A promise that resolves when disposal is complete.\n   */\n  public async [Symbol.asyncDispose]() {\n    return this._dispose();\n  }\n\n  /**\n   * Determines if the storage adapter is read-only based on the provided options.\n   *\n   * @returns `true` if the storage adapter is read-only, otherwise `false`.\n   */\n  protected get isReadOnly() {\n    return !!this.options.isReadOnly;\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected get overwrite() {\n    return !this.isReadOnly && this.context.config.output.overwrite !== false;\n  }\n\n  /**\n   * Resolves a given key to its full path within the storage adapter.\n   *\n   * @param key - The key to resolve.\n   * @returns The resolved full path for the key.\n   */\n  protected resolve(key?: string) {\n    if (!key) {\n      return this.options.base;\n    }\n\n    if (/\\.\\.:|\\.\\.$/.test(key)) {\n      throw new Error(\n        `[${this.name}]: Invalid key: ${JSON.stringify(key)} provided to storage adapter.`\n      );\n    }\n\n    return appendPath(correctPath(key).replace(/:/g, \"/\"), this.options.base);\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  protected async _dispose(): Promise<void> {\n    if (!this.#isDisposed) {\n      await Promise.resolve(this.dispose());\n      this.#isDisposed = true;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/storage/file-system.cjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_lib_utilities_file_header = require('../lib/utilities/file-header.cjs');
 const require_storage_base = require('./base.cjs');

package/dist/storage/file-system.d.cts

@@ -1,4 +1,4 @@
-import { Context } from "../types/context.cjs";
+import { J as Context } from "../config-BnV_o0Es.cjs";
 import { BaseStorageAdapter, StorageAdapterOptions } from "./base.cjs";
 import { writeFile, writeFileSync } from "@stryke/fs/write-file";
 

package/dist/storage/file-system.d.mts

@@ -1,6 +1,4 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { Context } from "../types/context.mjs";
+import { J as Context } from "../config-DboKmDhl.mjs";
 import { BaseStorageAdapter, StorageAdapterOptions } from "./base.mjs";
 import { writeFile, writeFileSync } from "@stryke/fs/write-file";
 

package/dist/storage/file-system.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.d.mts","names":[],"sources":["../../src/storage/file-system.ts"],"mappings":";;;;;;;KAgCY,cAAA,GAAiB,UAAU,QAAQ,aAAA;AAAA,KACnC,UAAA,GAAa,UAAU,QAAQ,SAAA;;;;cAK9B,wBAAA,SAAiC,kBAAA;;;;EAIrC,IAAA;EAVG;;;;AAAgD;AAC5D;EADY,SAkBe,MAAA;;;AAjByB;AAKpD;;;cAoBqB,OAAA,EAAS,OAAA,EAAS,OAAA,GAAU,qBAAA;EAAA;;;;;;EAUxC,UAAA,CAAW,GAAA;EA9B0B;;;;;;EAwCtB,MAAA,CAAO,GAAA,WAAc,OAAA;EApBf;;;;;;EA8BrB,OAAA,CAAQ,GAAA;EAVc;;;;;;EAoBP,GAAA,CAAI,GAAA,WAAc,OAAA;EAUjC;;;;;;EAAA,OAAA,CAAQ,GAAA,UAAa,KAAA;EA6ErB;;;;;;EAtCe,GAAA,CAAI,GAAA,UAAa,KAAA,WAAgB,OAAA;EAyEjC;;;;;EAnCf,UAAA,CAAW,GAAA;EA6DS;;;;;EA9CL,MAAA,CAAO,GAAA,WAAc,OAAA;EAsEL;AAAA;;;;EA3DtB,SAAA,CAAU,OAAA;;;;;;EASJ,KAAA,CAAM,OAAA,WAAkB,OAAA;;;;;;;EAUvC,QAAA,CAAS,IAAA;;;;;;;EAgBM,IAAA,CAAK,IAAA,YAAgB,OAAA;;;;;;;EAc3B,eAAA,CAAgB,GAAA;;;;;;;EAUhB,UAAA,CAAW,GAAA;AAAA"}
+{"version":3,"file":"file-system.d.mts","names":[],"sources":["../../src/storage/file-system.ts"],"mappings":";;;;;KAgCY,cAAA,GAAiB,UAAU,QAAQ,aAAA;AAAA,KACnC,UAAA,GAAa,UAAU,QAAQ,SAAA;AAD3C;;;AAAA,cAMa,wBAAA,SAAiC,kBAAA;EANc;AAC5D;;EASS,IAAA;EATgB;AAA2B;AAKpD;;;;EALyB,SAiBE,MAAA;EA4BkB;;;;;;cApBxB,OAAA,EAAS,OAAA,EAAS,OAAA,GAAU,qBAAA;EApBe;;;;;;EA8BvD,UAAA,CAAW,GAAA;EAVC;;;;;;EAoBG,MAAA,CAAO,GAAA,WAAc,OAAA;EAAA;;;;;;EAUpC,OAAA,CAAQ,GAAA;EAoBA;;;;;;EAVO,GAAA,CAAI,GAAA,WAAc,OAAA;EAuFtB;;;;;;EA7EX,OAAA,CAAQ,GAAA,UAAa,KAAA;EAgHA;;;;;;EAzEN,GAAA,CAAI,GAAA,UAAa,KAAA,WAAgB,OAAA;EAiHvC;;;;;EA3ET,UAAA,CAAW,GAAA;;;;;;EAeI,MAAA,CAAO,GAAA,WAAc,OAAA;;;;;;EAW3B,SAAA,CAAU,OAAA;;;;;;EASJ,KAAA,CAAM,OAAA,WAAkB,OAAA;;;;;;;EAUvC,QAAA,CAAS,IAAA;;;;;;;EAgBM,IAAA,CAAK,IAAA,YAAgB,OAAA;;;;;;;EAc3B,eAAA,CAAgB,GAAA;;;;;;;EAUhB,UAAA,CAAW,GAAA;AAAA"}

package/dist/storage/file-system.mjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 import { getFileHeaderWarningText } from "../lib/utilities/file-header.mjs";
 import { BaseStorageAdapter } from "./base.mjs";
 import { ignoreNotfound } from "./helpers.mjs";

package/dist/storage/file-system.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.mjs","names":[],"sources":["../../src/storage/file-system.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { exists, existsSync } from \"@stryke/fs/exists\";\nimport { createDirectory, createDirectorySync } from \"@stryke/fs/helpers\";\nimport { isDirectory, isFile } from \"@stryke/fs/is-file\";\nimport { listFiles, listFilesSync } from \"@stryke/fs/list-files\";\nimport { readFile, readFileSync } from \"@stryke/fs/read-file\";\nimport { writeFile, writeFileSync } from \"@stryke/fs/write-file\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { unlinkSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { getFileHeaderWarningText } from \"../lib/utilities/file-header\";\nimport type { Context } from \"../types/context\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\nimport { ignoreNotfound } from \"./helpers\";\n\nexport type SetSyncOptions = Parameters<typeof writeFileSync>[2];\nexport type SetOptions = Parameters<typeof writeFile>[2];\n\n/**\n * File system storage adapter implementation.\n */\nexport class FileSystemStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"file-system\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"fs\";\n\n  /**\n   * Constructor for the FileSystemStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return existsSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public override async exists(key: string): Promise<boolean> {\n    return exists(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return readFileSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public override async get(key: string): Promise<string | null> {\n    return readFile(this.resolve(key));\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = this.getSync(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(\n              true,\n              this.context.config.framework?.name || \"powerlines\"\n            )\n          )\n        ) {\n          return writeFileSync(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(\n                true,\n                this.context.config.framework?.name || \"powerlines\"\n              ),\n              getFileHeaderWarningText(\n                false,\n                this.context.config.framework?.name || \"powerlines\"\n              )\n            )\n          );\n        }\n      } else {\n        return writeFileSync(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public override async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = await this.get(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(\n              true,\n              this.context.config.framework?.name || \"powerlines\"\n            )\n          )\n        ) {\n          return writeFile(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(\n                true,\n                this.context.config.framework?.name || \"powerlines\"\n              ),\n              getFileHeaderWarningText(\n                false,\n                this.context.config.framework?.name || \"powerlines\"\n              )\n            )\n          );\n        }\n      } else {\n        return writeFile(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      try {\n        return unlinkSync(this.resolve(key));\n      } catch (err) {\n        return ignoreNotfound(err);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public override async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      return unlink(this.resolve(key)).catch(ignoreNotfound);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override mkdirSync(dirPath: string) {\n    createDirectorySync(this.resolve(dirPath));\n  }\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override async mkdir(dirPath: string): Promise<void> {\n    await createDirectory(this.resolve(dirPath));\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    try {\n      return listFilesSync(this.resolve(base), {\n        ignore: this.options.ignore\n      });\n    } catch (err) {\n      return ignoreNotfound(err) ?? [];\n    }\n  }\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public override async list(base?: string): Promise<string[]> {\n    return listFiles(this.resolve(base), {\n      ignore: this.options.ignore\n    })\n      .catch(ignoreNotfound)\n      .then(r => r || []);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public override isDirectorySync(key: string): boolean {\n    return isDirectory(this.resolve(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public override isFileSync(key: string): boolean {\n    return isFile(this.resolve(key));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"file-system.mjs","names":[],"sources":["../../src/storage/file-system.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { exists, existsSync } from \"@stryke/fs/exists\";\nimport { createDirectory, createDirectorySync } from \"@stryke/fs/helpers\";\nimport { isDirectory, isFile } from \"@stryke/fs/is-file\";\nimport { listFiles, listFilesSync } from \"@stryke/fs/list-files\";\nimport { readFile, readFileSync } from \"@stryke/fs/read-file\";\nimport { writeFile, writeFileSync } from \"@stryke/fs/write-file\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { unlinkSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { getFileHeaderWarningText } from \"../lib/utilities/file-header\";\nimport type { Context } from \"../types/context\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\nimport { ignoreNotfound } from \"./helpers\";\n\nexport type SetSyncOptions = Parameters<typeof writeFileSync>[2];\nexport type SetOptions = Parameters<typeof writeFile>[2];\n\n/**\n * File system storage adapter implementation.\n */\nexport class FileSystemStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"file-system\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"fs\";\n\n  /**\n   * Constructor for the FileSystemStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return existsSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns A promise that resolves to `true` if the key exists, otherwise `false`.\n   */\n  public override async exists(key: string): Promise<boolean> {\n    return exists(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return readFileSync(this.resolve(key));\n  }\n\n  /**\n   * Asynchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns A promise that resolves to the value associated with the key, or `null` if the key does not exist.\n   */\n  public override async get(key: string): Promise<string | null> {\n    return readFile(this.resolve(key));\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = this.getSync(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(\n              true,\n              this.context.config.framework?.name || \"powerlines\"\n            )\n          )\n        ) {\n          return writeFileSync(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(\n                true,\n                this.context.config.framework?.name || \"powerlines\"\n              ),\n              getFileHeaderWarningText(\n                false,\n                this.context.config.framework?.name || \"powerlines\"\n              )\n            )\n          );\n        }\n      } else {\n        return writeFileSync(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public override async set(key: string, value: string): Promise<void> {\n    if (!this.isReadOnly) {\n      if (this.existsSync(this.resolve(key)) && !this.overwrite) {\n        const existingValue = await this.get(this.resolve(key));\n        if (\n          isSetString(existingValue) &&\n          existingValue.includes(\n            getFileHeaderWarningText(\n              true,\n              this.context.config.framework?.name || \"powerlines\"\n            )\n          )\n        ) {\n          return writeFile(\n            this.resolve(key),\n            existingValue.replace(\n              getFileHeaderWarningText(\n                true,\n                this.context.config.framework?.name || \"powerlines\"\n              ),\n              getFileHeaderWarningText(\n                false,\n                this.context.config.framework?.name || \"powerlines\"\n              )\n            )\n          );\n        }\n      } else {\n        return writeFile(this.resolve(key), value);\n      }\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      try {\n        return unlinkSync(this.resolve(key));\n      } catch (err) {\n        return ignoreNotfound(err);\n      }\n    }\n  }\n\n  /**\n   * Asynchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public override async remove(key: string): Promise<void> {\n    if (!this.isReadOnly && this.overwrite) {\n      return unlink(this.resolve(key)).catch(ignoreNotfound);\n    }\n  }\n\n  /**\n   * Synchronously creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override mkdirSync(dirPath: string) {\n    createDirectorySync(this.resolve(dirPath));\n  }\n\n  /**\n   * Creates a directory at the specified path.\n   *\n   * @param dirPath - The path of the directory to create.\n   */\n  public override async mkdir(dirPath: string): Promise<void> {\n    await createDirectory(this.resolve(dirPath));\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    try {\n      return listFilesSync(this.resolve(base), {\n        ignore: this.options.ignore\n      });\n    } catch (err) {\n      return ignoreNotfound(err) ?? [];\n    }\n  }\n\n  /**\n   * Asynchronously lists all keys under a given base path.\n   *\n   * @param base - The base path to list keys from.\n   * @returns A promise that resolves to an array of keys under the specified base path.\n   */\n  public override async list(base?: string): Promise<string[]> {\n    return listFiles(this.resolve(base), {\n      ignore: this.options.ignore\n    })\n      .catch(ignoreNotfound)\n      .then(r => r || []);\n  }\n\n  /**\n   * Synchronously checks if the given key is a directory.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a directory, otherwise `false`.\n   */\n  public override isDirectorySync(key: string): boolean {\n    return isDirectory(this.resolve(key));\n  }\n\n  /**\n   * Synchronously checks if the given key is a file.\n   *\n   * @param key - The key to check.\n   * @returns `true` if the key is a file, otherwise `false`.\n   */\n  public override isFileSync(key: string): boolean {\n    return isFile(this.resolve(key));\n  }\n}\n"],"mappings":"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"}

package/dist/storage/helpers.cjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
 

package/dist/storage/helpers.d.mts

@@ -1,5 +1,3 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
 //#region src/storage/helpers.d.ts
 /**
  * Checks if an error is a file system error.

package/dist/storage/helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/storage/helpers.ts"],"mappings":";;;;;;;;;iBA0BgB,WAAA,CAAY,GAAQ;;;AAApC;;;;iBAUgB,cAAA,CAAe,GAAQ;AAAvC;;;;AAAuC;AAavC;AAbA,iBAagB,YAAA,CAAa,GAAQ"}
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/storage/helpers.ts"],"mappings":";;AA0BA;;;;AAAoC;iBAApB,WAAA,CAAY,GAAQ;;;;AAUG;AAavC;;iBAbgB,cAAA,CAAe,GAAQ;;AAaF;;;;;iBAArB,YAAA,CAAa,GAAQ"}

package/dist/storage/helpers.mjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 import { isError } from "@stryke/type-checks/is-error";
 
 //#region src/storage/helpers.ts

package/dist/storage/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/storage/helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isError } from \"@stryke/type-checks/is-error\";\n\n/**\n * Checks if an error is a file system error.\n *\n * @param err - The error to check.\n * @returns `true` if the error is a file system error, otherwise `false`.\n */\nexport function isFileError(err: any) {\n  return isError(err) && \"code\" in err && err.code;\n}\n\n/**\n * Ignores file not found errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file not found error, otherwise returns the error.\n */\nexport function ignoreNotfound(err: any) {\n  return (\n    isFileError(err) &&\n    (err.code === \"ENOENT\" || err.code === \"EISDIR\" ? null : err)\n  );\n}\n\n/**\n * Ignores file exists errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file exists error, otherwise returns the error.\n */\nexport function ignoreExists(err: any) {\n  return isFileError(err) && err.code === \"EEXIST\" ? null : err;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,SAAgB,YAAY,KAAU;CACpC,OAAO,QAAQ,GAAG,KAAK,UAAU,OAAO,IAAI;AAC9C;;;;;;;AAQA,SAAgB,eAAe,KAAU;CACvC,OACE,YAAY,GAAG,MACd,IAAI,SAAS,YAAY,IAAI,SAAS,WAAW,OAAO;AAE7D;;;;;;;AAQA,SAAgB,aAAa,KAAU;CACrC,OAAO,YAAY,GAAG,KAAK,IAAI,SAAS,WAAW,OAAO;AAC5D"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/storage/helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isError } from \"@stryke/type-checks/is-error\";\n\n/**\n * Checks if an error is a file system error.\n *\n * @param err - The error to check.\n * @returns `true` if the error is a file system error, otherwise `false`.\n */\nexport function isFileError(err: any) {\n  return isError(err) && \"code\" in err && err.code;\n}\n\n/**\n * Ignores file not found errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file not found error, otherwise returns the error.\n */\nexport function ignoreNotfound(err: any) {\n  return (\n    isFileError(err) &&\n    (err.code === \"ENOENT\" || err.code === \"EISDIR\" ? null : err)\n  );\n}\n\n/**\n * Ignores file exists errors.\n *\n * @param err - The error to check.\n * @returns `null` if the error is a file exists error, otherwise returns the error.\n */\nexport function ignoreExists(err: any) {\n  return isFileError(err) && err.code === \"EEXIST\" ? null : err;\n}\n"],"mappings":";;;;;;;;;AA0BA,SAAgB,YAAY,KAAU;CACpC,OAAO,QAAQ,GAAG,KAAK,UAAU,OAAO,IAAI;AAC9C;;;;;;;AAQA,SAAgB,eAAe,KAAU;CACvC,OACE,YAAY,GAAG,MACd,IAAI,SAAS,YAAY,IAAI,SAAS,WAAW,OAAO;AAE7D;;;;;;;AAQA,SAAgB,aAAa,KAAU;CACrC,OAAO,YAAY,GAAG,KAAK,IAAI,SAAS,WAAW,OAAO;AAC5D"}

package/dist/storage/index.cjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_storage_base = require('./base.cjs');
 const require_storage_helpers = require('./helpers.cjs');

package/dist/storage/index.d.mts

@@ -1,5 +1,3 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
 import { BaseStorageAdapter, StorageAdapterOptions } from "./base.mjs";
 import { FileSystemStorageAdapter, SetOptions, SetSyncOptions } from "./file-system.mjs";
 import { ignoreExists, ignoreNotfound, isFileError } from "./helpers.mjs";

package/dist/storage/index.mjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 import { BaseStorageAdapter } from "./base.mjs";
 import { ignoreExists, ignoreNotfound, isFileError } from "./helpers.mjs";
 import { FileSystemStorageAdapter } from "./file-system.mjs";

package/dist/storage/virtual.cjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_storage_base = require('./base.cjs');
 let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");

package/dist/storage/virtual.d.cts

@@ -1,4 +1,4 @@
-import { Context } from "../types/context.cjs";
+import { J as Context } from "../config-BnV_o0Es.cjs";
 import { BaseStorageAdapter, StorageAdapterOptions } from "./base.cjs";
 
 //#region src/storage/virtual.d.ts

package/dist/storage/virtual.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual.d.cts","names":[],"sources":["../../src/storage/virtual.ts"],"mappings":";;;;;;AAyBA;cAAa,qBAAA,SAA8B,kBAAA;;;;EAIlC,IAAA;EAuF0B;;;;;;EAAA,SA/ER,MAAA;EAKf;;;EAAA,UAAA,IAAA,EAAI,GAAA;EAQK;;;;;;cAAA,OAAA,EAAS,OAAA,EAAS,OAAA,GAAU,qBAAA;EA8BxC;;;;;;EApBA,UAAA,CAAW,GAAA;EAwDI;;;;AASU;;EAvDzB,OAAA,CAAQ,GAAA;;;;;;;EAUR,OAAA,CAAQ,GAAA,UAAa,KAAA;;;;;;EAWrB,UAAA,CAAW,GAAA;;;;;;;EAYX,QAAA,CAAS,IAAA;;;;;;EAaM,OAAA,CAAA,GAAW,OAAA;;;;;;gBASV,SAAA,CAAA;AAAA"}
+{"version":3,"file":"virtual.d.cts","names":[],"sources":["../../src/storage/virtual.ts"],"mappings":";;;;;;AAyBA;cAAa,qBAAA,SAA8B,kBAAA;;;;EAIlC,IAAA;EAuF0B;;;;;;EAAA,SA/ER,MAAA;EAKf;;;EAAA,UAAA,IAAA,EAAI,GAAA;EAQK;;;;;;cAAA,OAAA,EAAS,OAAA,EAAS,OAAA,GAAU,qBAAA;EA8BxC;;;;;;EApBA,UAAA,CAAW,GAAA;EAwDI;;;;AASU;;EAvDzB,OAAA,CAAQ,GAAA;;;;;;;EAUR,OAAA,CAAQ,GAAA,UAAa,KAAA;;;;;;EAWrB,UAAA,CAAW,GAAA;;;;;;;EAYX,QAAA,CAAS,IAAA;;;;;;EAaM,OAAA,IAAW,OAAA;;;;;;gBASV,SAAA;AAAA"}

package/dist/storage/virtual.d.mts

@@ -1,6 +1,4 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { Context } from "../types/context.mjs";
+import { J as Context } from "../config-DboKmDhl.mjs";
 import { BaseStorageAdapter, StorageAdapterOptions } from "./base.mjs";
 
 //#region src/storage/virtual.d.ts

package/dist/storage/virtual.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual.d.mts","names":[],"sources":["../../src/storage/virtual.ts"],"mappings":";;;;;;;;;cAyBa,qBAAA,SAA8B,kBAAA;;;;EAIlC,IAAA;;;AAJT;;;;WAY2B,MAAA;EAasB;;;EAAA,UARrC,IAAA,EAAI,GAAA;EAjB6C;;;;;;cAyBxC,OAAA,EAAS,OAAA,EAAS,OAAA,GAAU,qBAAA;EAAnB;;;;;;EAUrB,UAAA,CAAW,GAAA;EAUH;;;;;;EAAR,OAAA,CAAQ,GAAA;EAiCC;;;;;AAsBgB;EA7CzB,OAAA,CAAQ,GAAA,UAAa,KAAA;;;;;;EAWrB,UAAA,CAAW,GAAA;;;;;;;EAYX,QAAA,CAAS,IAAA;;;;;;EAaM,OAAA,CAAA,GAAW,OAAA;;;;;;gBASV,SAAA,CAAA;AAAA"}
+{"version":3,"file":"virtual.d.mts","names":[],"sources":["../../src/storage/virtual.ts"],"mappings":";;;;;;AAyBA;cAAa,qBAAA,SAA8B,kBAAA;;;;EAIlC,IAAA;EAuF0B;;;;;;EAAA,SA/ER,MAAA;EAKf;;;EAAA,UAAA,IAAA,EAAI,GAAA;EAQK;;;;;;cAAA,OAAA,EAAS,OAAA,EAAS,OAAA,GAAU,qBAAA;EA8BxC;;;;;;EApBA,UAAA,CAAW,GAAA;EAwDI;;;;AASU;;EAvDzB,OAAA,CAAQ,GAAA;;;;;;;EAUR,OAAA,CAAQ,GAAA,UAAa,KAAA;;;;;;EAWrB,UAAA,CAAW,GAAA;;;;;;;EAYX,QAAA,CAAS,IAAA;;;;;;EAaM,OAAA,IAAW,OAAA;;;;;;gBASV,SAAA;AAAA"}

package/dist/storage/virtual.mjs

@@ -1,11 +1,3 @@
-
-
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
-
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
-
 import { BaseStorageAdapter } from "./base.mjs";
 import { isParentPath } from "@stryke/path/is-parent-path";
 

package/dist/storage/virtual.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"virtual.mjs","names":[],"sources":["../../src/storage/virtual.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport type { Context } from \"../types/context\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\n\n/**\n * Virtual/in-memory storage adapter implementation.\n */\nexport class VirtualStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"virtual\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"virtual\";\n\n  /**\n   * In-memory data storage.\n   */\n  protected data = new Map<string, any>();\n\n  /**\n   * Constructor for the VirtualStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return this.data.has(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return this.data.get(this.resolve(key)) ?? null;\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.data.set(this.resolve(key), value);\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      this.data.delete(this.resolve(key));\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    return [\n      ...this.data\n        .keys()\n        .filter(key => (!base ? true : isParentPath(key, this.resolve(base))))\n    ];\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public override async dispose(): Promise<void> {\n    return this.clear();\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected override get overwrite() {\n    return !this.isReadOnly;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyBA,IAAa,wBAAb,cAA2C,mBAAmB;;;;CAI5D,AAAO,OAAO;;;;;;;CAQd,AAAyB,SAAS;;;;CAKlC,AAAU,uBAAO,IAAI,IAAiB;;;;;;;CAQtC,AAAO,YAAY,SAAkB,SAAiC;EACpE,MAAM,SAAS,OAAO;CACxB;;;;;;;CAQA,AAAO,WAAW,KAAsB;EACtC,OAAO,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG,CAAC;CACxC;;;;;;;CAQA,AAAO,QAAQ,KAA4B;EACzC,OAAO,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG,CAAC,KAAK;CAC7C;;;;;;;CAQA,AAAO,QAAQ,KAAa,OAAe;EACzC,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,WAAW,GAAG,KAAK,KAAK,YACrD,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG,GAAG,KAAK;CAE1C;;;;;;CAOA,AAAO,WAAW,KAAa;EAC7B,IAAI,CAAC,KAAK,cAAc,KAAK,WAC3B,KAAK,KAAK,OAAO,KAAK,QAAQ,GAAG,CAAC;CAEtC;;;;;;;CAQA,AAAO,SAAS,MAAyB;EACvC,OAAO,CACL,GAAG,KAAK,KACL,KAAK,EACL,QAAO,QAAQ,CAAC,OAAO,OAAO,aAAa,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAE,CACzE;CACF;;;;;;CAOA,MAAsB,UAAyB;EAC7C,OAAO,KAAK,MAAM;CACpB;;;;;;CAOA,IAAuB,YAAY;EACjC,OAAO,CAAC,KAAK;CACf;AACF"}
+{"version":3,"file":"virtual.mjs","names":[],"sources":["../../src/storage/virtual.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport type { Context } from \"../types/context\";\nimport { BaseStorageAdapter, StorageAdapterOptions } from \"./base\";\n\n/**\n * Virtual/in-memory storage adapter implementation.\n */\nexport class VirtualStorageAdapter extends BaseStorageAdapter {\n  /**\n   * A name identifying the storage adapter type.\n   */\n  public name = \"virtual\";\n\n  /**\n   * The storage preset for the adapter.\n   *\n   * @remarks\n   * This can be used as an alternate way to identify the type of storage being used.\n   */\n  public override readonly preset = \"virtual\";\n\n  /**\n   * In-memory data storage.\n   */\n  protected data = new Map<string, any>();\n\n  /**\n   * Constructor for the VirtualStorageAdapter.\n   *\n   * @param context - The Powerlines context.\n   * @param options - Configuration options for the storage adapter.\n   */\n  public constructor(context: Context, options?: StorageAdapterOptions) {\n    super(context, options);\n  }\n\n  /**\n   * Synchronously checks if a key exists in the storage.\n   *\n   * @param key - The key to check for existence.\n   * @returns Returns `true` if the key exists, otherwise `false`.\n   */\n  public existsSync(key: string): boolean {\n    return this.data.has(this.resolve(key));\n  }\n\n  /**\n   * Synchronously retrieves the value associated with a given key.\n   *\n   * @param key - The key whose value is to be retrieved.\n   * @returns The value associated with the key, or `null` if the key does not exist.\n   */\n  public getSync(key: string): string | null {\n    return this.data.get(this.resolve(key)) ?? null;\n  }\n\n  /**\n   * Synchronously sets the value for a given key.\n   *\n   * @param key - The key to set the value for.\n   * @param value - The value to set.\n   */\n  public setSync(key: string, value: string) {\n    if (!this.isReadOnly && (!this.existsSync(key) || this.overwrite)) {\n      this.data.set(this.resolve(key), value);\n    }\n  }\n\n  /**\n   * Synchronously removes a key from the storage.\n   *\n   * @param key - The key to remove.\n   */\n  public removeSync(key: string) {\n    if (!this.isReadOnly && this.overwrite) {\n      this.data.delete(this.resolve(key));\n    }\n  }\n\n  /**\n   * Lists all keys under a given base path synchronously.\n   *\n   * @param base - The base path to list keys from.\n   * @returns An array of keys under the specified base path.\n   */\n  public listSync(base?: string): string[] {\n    return [\n      ...this.data\n        .keys()\n        .filter(key => (!base ? true : isParentPath(key, this.resolve(base))))\n    ];\n  }\n\n  /**\n   * Disposes of the storage adapter, releasing any held resources.\n   *\n   * @returns A promise that resolves when the disposal is complete.\n   */\n  public override async dispose(): Promise<void> {\n    return this.clear();\n  }\n\n  /**\n   * Determines if the storage adapter should overwrite existing keys based on the provided options and context configuration.\n   *\n   * @returns `true` if the storage adapter should overwrite existing keys, otherwise `false`.\n   */\n  protected override get overwrite() {\n    return !this.isReadOnly;\n  }\n}\n"],"mappings":";;;;;;;AAyBA,IAAa,wBAAb,cAA2C,mBAAmB;;;;CAI5D,AAAO,OAAO;;;;;;;CAQd,AAAyB,SAAS;;;;CAKlC,AAAU,uBAAO,IAAI,IAAiB;;;;;;;CAQtC,AAAO,YAAY,SAAkB,SAAiC;EACpE,MAAM,SAAS,OAAO;CACxB;;;;;;;CAQA,AAAO,WAAW,KAAsB;EACtC,OAAO,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG,CAAC;CACxC;;;;;;;CAQA,AAAO,QAAQ,KAA4B;EACzC,OAAO,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG,CAAC,KAAK;CAC7C;;;;;;;CAQA,AAAO,QAAQ,KAAa,OAAe;EACzC,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,WAAW,GAAG,KAAK,KAAK,YACrD,KAAK,KAAK,IAAI,KAAK,QAAQ,GAAG,GAAG,KAAK;CAE1C;;;;;;CAOA,AAAO,WAAW,KAAa;EAC7B,IAAI,CAAC,KAAK,cAAc,KAAK,WAC3B,KAAK,KAAK,OAAO,KAAK,QAAQ,GAAG,CAAC;CAEtC;;;;;;;CAQA,AAAO,SAAS,MAAyB;EACvC,OAAO,CACL,GAAG,KAAK,KACL,KAAK,EACL,QAAO,QAAQ,CAAC,OAAO,OAAO,aAAa,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAE,CACzE;CACF;;;;;;CAOA,MAAsB,UAAyB;EAC7C,OAAO,KAAK,MAAM;CACpB;;;;;;CAOA,IAAuB,YAAY;EACjC,OAAO,CAAC,KAAK;CACf;AACF"}

package/dist/streaming-channel-CiyFd_6l.d.cts

@@ -0,0 +1,126 @@
+import { EventEmitter } from "devframe/types";
+
+//#region src/lib/streaming-channel.d.ts
+/**
+ * Serialized error shape sent over the wire when a stream ends with a failure.
+ * Stays JSON-safe so the strict-JSON encoder can carry it without coercion.
+ */
+interface StreamErrorPayload {
+  name: string;
+  message: string;
+}
+/**
+ * Single buffered chunk in the server-side ring buffer.
+ *
+ * Sequence numbers start at 1 and increment per write. Subscribers track
+ * `lastSeenSeq` and ask for `afterSeq` on resubscribe so the server can
+ * replay any chunks the client missed during a brief disconnect.
+ */
+interface BufferedChunk<T> {
+  seq: number;
+  chunk: T;
+}
+interface StreamSinkEvents<T> {
+  /** Fired for each `write()`. The RPC layer subscribes and broadcasts. */
+  chunk: (seq: number, chunk: T) => void;
+  /** Terminal — fired exactly once per sink lifetime. */
+  end: (error?: StreamErrorPayload) => void;
+}
+interface CreateStreamSinkOptions {
+  id?: string;
+  /**
+   * Size of the per-stream ring buffer kept for replay-on-resubscribe.
+   * `0` (default) disables replay.
+   */
+  replayWindow?: number;
+}
+/**
+ * Server-side producer handle. Two equivalent surfaces share one piece of
+ * state: the imperative `write/error/close` triple, and a `WritableStream<T>`
+ * for `pipeTo`-style consumption.
+ */
+interface StreamSink<T> {
+  /** Stable id used by clients to subscribe. */
+  readonly id: string;
+  /**
+   * Aborts when the consumer cancels (server-side) or when the transport
+   * loses every subscriber. Producers should poll `signal.aborted` and exit
+   * cleanly.
+   */
+  readonly signal: AbortSignal;
+  /** `true` after `close()` / `error()`. Further writes throw. */
+  readonly closed: boolean;
+  /** Last allocated sequence number. `0` until the first write. */
+  readonly lastSeq: number;
+  write: (chunk: T) => void;
+  error: (reason: unknown) => void;
+  close: () => void;
+  /** External-cancel path. Aborts the signal so handlers can short-circuit. */
+  abort: (reason?: unknown) => void;
+  /** `WritableStream<T>` adapter — same in-memory state as the imperative API. */
+  readonly writable: WritableStream<T>;
+  /**
+   * Internal — RPC layer subscribes to receive chunk/end notifications.
+   * Not part of the public contract; do not call directly.
+   *
+   * @internal
+   */
+  readonly events: EventEmitter<StreamSinkEvents<T>>;
+  /**
+   * Internal — replay buffer. RPC layer reads on (re)subscribe to feed
+   * missed chunks before going live.
+   *
+   * @internal
+   */
+  readonly buffer: ReadonlyArray<BufferedChunk<T>>;
+}
+interface CreateStreamReaderOptions {
+  id?: string;
+  /**
+   * Maximum number of buffered chunks held client-side while the consumer
+   * isn't draining. On overflow, the oldest chunk is dropped.
+   */
+  highWaterMark?: number;
+  /**
+   * Called when the chunk queue overflows the high-water mark. The RPC
+   * layer wires this to a coded warning; the primitive itself is
+   * RPC-agnostic.
+   */
+  onOverflow?: (dropped: number) => void;
+  /** Called when the consumer cancels — the RPC layer sends `:cancel` upstream. */
+  onCancel?: () => void;
+}
+/**
+ * Client-side consumer handle. Both an `AsyncIterable<T>` (for `for await`)
+ * and exposes `readable: ReadableStream<T>` (for `pipeTo`). Pick one — they
+ * share a single internal queue, so concurrent draining will race.
+ */
+interface StreamReader<T> extends AsyncIterable<T> {
+  readonly id: string;
+  readonly cancelled: boolean;
+  readonly done: boolean;
+  /** Highest `seq` observed. Used for replay on reconnect. */
+  readonly lastSeenSeq: number;
+  /** `ReadableStream<T>` adapter for `pipeTo`-style consumption. */
+  readonly readable: ReadableStream<T>;
+  cancel: () => void;
+  /** @internal */
+  _push: (seq: number, chunk: T) => void;
+  /** @internal */
+  _end: (error?: StreamErrorPayload) => void;
+}
+/**
+ * Build a server-side stream sink. RPC-agnostic — the RPC host wires
+ * `events.on('chunk' | 'end')` to broadcast, and reads `buffer` to replay
+ * for late or reconnecting subscribers.
+ */
+declare function createStreamSink<T>(options?: CreateStreamSinkOptions): StreamSink<T>;
+/**
+ * Build a client-side stream reader. RPC-agnostic — the RPC host calls
+ * `_push(seq, chunk)` on each incoming chunk and `_end(error?)` on the
+ * terminal frame. Consumers iterate with `for await` or pipe `readable`.
+ */
+declare function createStreamReader<T>(options?: CreateStreamReaderOptions): StreamReader<T>;
+//#endregion
+export { StreamReader as a, createStreamReader as c, StreamErrorPayload as i, createStreamSink as l, CreateStreamReaderOptions as n, StreamSink as o, CreateStreamSinkOptions as r, StreamSinkEvents as s, BufferedChunk as t };
+//# sourceMappingURL=streaming-channel-CiyFd_6l.d.cts.map

package/dist/streaming-channel-CiyFd_6l.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-channel-CiyFd_6l.d.cts","names":[],"sources":["../src/lib/streaming-channel.ts"],"mappings":";;;;;AA0BA;;UAAiB,kBAAA;EACf,IAAA;EACA,OAAO;AAAA;;;;;;;;UAUQ,aAAA;EACf,GAAA;EACA,KAAA,EAAO,CAAC;AAAA;AAAA,UAGO,gBAAA;EAIiB;EAFhC,KAAA,GAAQ,GAAA,UAAa,KAAA,EAAO,CAAA;EAA5B;EAEA,GAAA,GAAM,KAAA,GAAQ,kBAAkB;AAAA;AAAA,UAGjB,uBAAA;EACf,EAAA;EAJc;;;AAAkB;EAShC,YAAY;AAAA;;;AAAA;AAQd;;UAAiB,UAAA;EAQE;EAAA,SANR,EAAA;EAmByB;;;;;EAAA,SAbzB,MAAA,EAAQ,WAAA;EA6Bc;EAAA,SA3BtB,MAAA;EA2BqB;EAAA,SAzBrB,OAAA;EAET,KAAA,GAAQ,KAAA,EAAO,CAAA;EACf,KAAA,GAAQ,MAAA;EACR,KAAA;EARiB;EAUjB,KAAA,GAAQ,MAAA;EANC;EAAA,SASA,QAAA,EAAU,cAAA,CAAe,CAAA;EAPnB;;;;;;EAAA,SAeN,MAAA,EAAQ,YAAA,CAAa,gBAAA,CAAiB,CAAA;EARtC;;;;;;EAAA,SAgBA,MAAA,EAAQ,aAAA,CAAc,aAAA,CAAc,CAAA;AAAA;AAAA,UAG9B,yBAAA;EACf,EAAA;EAJ6C;;AAAC;AAGhD;EAME,aAAA;;;;;;EAMA,UAAA,IAAc,OAAA;EAEd;EAAA,QAAA;AAAA;AAQF;;;;;AAAA,UAAiB,YAAA,YAAwB,aAAA,CAAc,CAAA;EAAA,SAC5C,EAAA;EAAA,SACA,SAAA;EAAA,SACA,IAAA;EAH2C;EAAA,SAK3C,WAAA;EALmB;EAAA,SAOnB,QAAA,EAAU,cAAA,CAAe,CAAA;EAElC,MAAA;EARS;EAWT,KAAA,GAAQ,GAAA,UAAa,KAAA,EAAO,CAAA;EATnB;EAWT,IAAA,GAAO,KAAA,GAAQ,kBAAA;AAAA;;;;;;iBAcD,gBAAA,IACd,OAAA,GAAS,uBAAA,GACR,UAAA,CAAW,CAAA;;;;;;iBA+EE,kBAAA,IACd,OAAA,GAAS,yBAAA,GACR,YAAA,CAAa,CAAA"}

package/dist/streaming-channel-CiyFd_6l.d.mts

@@ -0,0 +1,126 @@
+import { EventEmitter } from "devframe/types";
+
+//#region src/lib/streaming-channel.d.ts
+/**
+ * Serialized error shape sent over the wire when a stream ends with a failure.
+ * Stays JSON-safe so the strict-JSON encoder can carry it without coercion.
+ */
+interface StreamErrorPayload {
+  name: string;
+  message: string;
+}
+/**
+ * Single buffered chunk in the server-side ring buffer.
+ *
+ * Sequence numbers start at 1 and increment per write. Subscribers track
+ * `lastSeenSeq` and ask for `afterSeq` on resubscribe so the server can
+ * replay any chunks the client missed during a brief disconnect.
+ */
+interface BufferedChunk<T> {
+  seq: number;
+  chunk: T;
+}
+interface StreamSinkEvents<T> {
+  /** Fired for each `write()`. The RPC layer subscribes and broadcasts. */
+  chunk: (seq: number, chunk: T) => void;
+  /** Terminal — fired exactly once per sink lifetime. */
+  end: (error?: StreamErrorPayload) => void;
+}
+interface CreateStreamSinkOptions {
+  id?: string;
+  /**
+   * Size of the per-stream ring buffer kept for replay-on-resubscribe.
+   * `0` (default) disables replay.
+   */
+  replayWindow?: number;
+}
+/**
+ * Server-side producer handle. Two equivalent surfaces share one piece of
+ * state: the imperative `write/error/close` triple, and a `WritableStream<T>`
+ * for `pipeTo`-style consumption.
+ */
+interface StreamSink<T> {
+  /** Stable id used by clients to subscribe. */
+  readonly id: string;
+  /**
+   * Aborts when the consumer cancels (server-side) or when the transport
+   * loses every subscriber. Producers should poll `signal.aborted` and exit
+   * cleanly.
+   */
+  readonly signal: AbortSignal;
+  /** `true` after `close()` / `error()`. Further writes throw. */
+  readonly closed: boolean;
+  /** Last allocated sequence number. `0` until the first write. */
+  readonly lastSeq: number;
+  write: (chunk: T) => void;
+  error: (reason: unknown) => void;
+  close: () => void;
+  /** External-cancel path. Aborts the signal so handlers can short-circuit. */
+  abort: (reason?: unknown) => void;
+  /** `WritableStream<T>` adapter — same in-memory state as the imperative API. */
+  readonly writable: WritableStream<T>;
+  /**
+   * Internal — RPC layer subscribes to receive chunk/end notifications.
+   * Not part of the public contract; do not call directly.
+   *
+   * @internal
+   */
+  readonly events: EventEmitter<StreamSinkEvents<T>>;
+  /**
+   * Internal — replay buffer. RPC layer reads on (re)subscribe to feed
+   * missed chunks before going live.
+   *
+   * @internal
+   */
+  readonly buffer: ReadonlyArray<BufferedChunk<T>>;
+}
+interface CreateStreamReaderOptions {
+  id?: string;
+  /**
+   * Maximum number of buffered chunks held client-side while the consumer
+   * isn't draining. On overflow, the oldest chunk is dropped.
+   */
+  highWaterMark?: number;
+  /**
+   * Called when the chunk queue overflows the high-water mark. The RPC
+   * layer wires this to a coded warning; the primitive itself is
+   * RPC-agnostic.
+   */
+  onOverflow?: (dropped: number) => void;
+  /** Called when the consumer cancels — the RPC layer sends `:cancel` upstream. */
+  onCancel?: () => void;
+}
+/**
+ * Client-side consumer handle. Both an `AsyncIterable<T>` (for `for await`)
+ * and exposes `readable: ReadableStream<T>` (for `pipeTo`). Pick one — they
+ * share a single internal queue, so concurrent draining will race.
+ */
+interface StreamReader<T> extends AsyncIterable<T> {
+  readonly id: string;
+  readonly cancelled: boolean;
+  readonly done: boolean;
+  /** Highest `seq` observed. Used for replay on reconnect. */
+  readonly lastSeenSeq: number;
+  /** `ReadableStream<T>` adapter for `pipeTo`-style consumption. */
+  readonly readable: ReadableStream<T>;
+  cancel: () => void;
+  /** @internal */
+  _push: (seq: number, chunk: T) => void;
+  /** @internal */
+  _end: (error?: StreamErrorPayload) => void;
+}
+/**
+ * Build a server-side stream sink. RPC-agnostic — the RPC host wires
+ * `events.on('chunk' | 'end')` to broadcast, and reads `buffer` to replay
+ * for late or reconnecting subscribers.
+ */
+declare function createStreamSink<T>(options?: CreateStreamSinkOptions): StreamSink<T>;
+/**
+ * Build a client-side stream reader. RPC-agnostic — the RPC host calls
+ * `_push(seq, chunk)` on each incoming chunk and `_end(error?)` on the
+ * terminal frame. Consumers iterate with `for await` or pipe `readable`.
+ */
+declare function createStreamReader<T>(options?: CreateStreamReaderOptions): StreamReader<T>;
+//#endregion
+export { StreamReader as a, createStreamReader as c, StreamErrorPayload as i, createStreamSink as l, CreateStreamReaderOptions as n, StreamSink as o, CreateStreamSinkOptions as r, StreamSinkEvents as s, BufferedChunk as t };
+//# sourceMappingURL=streaming-channel-CiyFd_6l.d.mts.map

package/dist/streaming-channel-CiyFd_6l.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-channel-CiyFd_6l.d.mts","names":[],"sources":["../src/lib/streaming-channel.ts"],"mappings":";;;;;AA0BA;;UAAiB,kBAAA;EACf,IAAA;EACA,OAAO;AAAA;;;;;;;;UAUQ,aAAA;EACf,GAAA;EACA,KAAA,EAAO,CAAC;AAAA;AAAA,UAGO,gBAAA;EAIiB;EAFhC,KAAA,GAAQ,GAAA,UAAa,KAAA,EAAO,CAAA;EAA5B;EAEA,GAAA,GAAM,KAAA,GAAQ,kBAAkB;AAAA;AAAA,UAGjB,uBAAA;EACf,EAAA;EAJc;;;AAAkB;EAShC,YAAY;AAAA;;;AAAA;AAQd;;UAAiB,UAAA;EAQE;EAAA,SANR,EAAA;EAmByB;;;;;EAAA,SAbzB,MAAA,EAAQ,WAAA;EA6Bc;EAAA,SA3BtB,MAAA;EA2BqB;EAAA,SAzBrB,OAAA;EAET,KAAA,GAAQ,KAAA,EAAO,CAAA;EACf,KAAA,GAAQ,MAAA;EACR,KAAA;EARiB;EAUjB,KAAA,GAAQ,MAAA;EANC;EAAA,SASA,QAAA,EAAU,cAAA,CAAe,CAAA;EAPnB;;;;;;EAAA,SAeN,MAAA,EAAQ,YAAA,CAAa,gBAAA,CAAiB,CAAA;EARtC;;;;;;EAAA,SAgBA,MAAA,EAAQ,aAAA,CAAc,aAAA,CAAc,CAAA;AAAA;AAAA,UAG9B,yBAAA;EACf,EAAA;EAJ6C;;AAAC;AAGhD;EAME,aAAA;;;;;;EAMA,UAAA,IAAc,OAAA;EAEd;EAAA,QAAA;AAAA;AAQF;;;;;AAAA,UAAiB,YAAA,YAAwB,aAAA,CAAc,CAAA;EAAA,SAC5C,EAAA;EAAA,SACA,SAAA;EAAA,SACA,IAAA;EAH2C;EAAA,SAK3C,WAAA;EALmB;EAAA,SAOnB,QAAA,EAAU,cAAA,CAAe,CAAA;EAElC,MAAA;EARS;EAWT,KAAA,GAAQ,GAAA,UAAa,KAAA,EAAO,CAAA;EATnB;EAWT,IAAA,GAAO,KAAA,GAAQ,kBAAA;AAAA;;;;;;iBAcD,gBAAA,IACd,OAAA,GAAS,uBAAA,GACR,UAAA,CAAW,CAAA;;;;;;iBA+EE,kBAAA,IACd,OAAA,GAAS,yBAAA,GACR,YAAA,CAAa,CAAA"}