@lunora/bindings 1.0.0-alpha.7 → 1.0.0-alpha.9

package/dist/kv/index.d.mts

@@ -1,16 +1,16 @@
 /**
-* The value types Workers KV can store / return. Mirrors Cloudflare's
-* `KVNamespace` `get`/`put` body unions; declared here so the package stays
-* runtime-agnostic and the `*Like` interfaces don't pull in
-* `@cloudflare/workers-types` at runtime.
-*/
+ * The value types Workers KV can store / return. Mirrors Cloudflare's
+ * `KVNamespace` `get`/`put` body unions; declared here so the package stays
+ * runtime-agnostic and the `*Like` interfaces don't pull in
+ * `@cloudflare/workers-types` at runtime.
+ */
 type KvValue = ReadableStream | ArrayBuffer | ArrayBufferView | string;
 /** How a raw KV read should decode the stored value. Mirrors KV's `type` option. */
 type KvValueType = "text" | "json" | "arrayBuffer" | "stream";
 /**
-* Per-read options forwarded to the binding. `cacheTtl` is KV's edge-cache TTL
-* (seconds, min 60); `type` selects the decode mode for {@link Kv.getRaw}.
-*/
+ * Per-read options forwarded to the binding. `cacheTtl` is KV's edge-cache TTL
+ * (seconds, min 60); `type` selects the decode mode for {@link Kv.getRaw}.
+ */
 interface KvGetOptions {
   /** KV edge-cache TTL in seconds (minimum 60). Forwarded verbatim. */
   cacheTtl?: number;
@@ -18,23 +18,23 @@ interface KvGetOptions {
   type?: KvValueType;
 }
 /**
-* Minimal projection of Cloudflare's `KVNamespace`. Declared structurally so
-* unit tests can pass a plain `Map`-backed double; the real binding satisfies
-* the same shape. Mirrors `R2BucketLike` in `@lunora/storage`.
-*/
+ * Minimal projection of Cloudflare's `KVNamespace`. Declared structurally so
+ * unit tests can pass a plain `Map`-backed double; the real binding satisfies
+ * the same shape. Mirrors `R2BucketLike` in `@lunora/storage`.
+ */
 interface KVNamespaceLike {
   /** Delete a key. No-op if the key is absent. */
   delete: (key: string) => Promise<void>;
   /**
-  * Read a value. The real binding overloads on `options.type`; declared here
-  * as the broad union so a structural double need only return the value (or
-  * `null` when absent).
-  */
+   * Read a value. The real binding overloads on `options.type`; declared here
+   * as the broad union so a structural double need only return the value (or
+   * `null` when absent).
+   */
   get: (key: string, options?: KvGetOptions | KvValueType) => Promise<unknown>;
   /**
-  * Read a value together with its associated metadata. Returns
-  * `{ value: null, metadata: null }` when the key is absent.
-  */
+   * Read a value together with its associated metadata. Returns
+   * `{ value: null, metadata: null }` when the key is absent.
+   */
   getWithMetadata: (key: string, options?: KvGetOptions | KvValueType) => Promise<{
     metadata: unknown;
     value: unknown;
@@ -80,11 +80,11 @@ type KvNamespaceListResult<Metadata = unknown> = {
 /** Construction options for the `createKv` factory. */
 interface LunoraKvOptions {
   /**
-  * Optional per-instance key prefix applied to every operation (get/put/
-  * delete/list). Use for multi-tenant key namespacing — equivalent to
-  * calling the `scopeKey` helper on every key. Combined via `scopeKey`, so a
-  * `..` or NUL in the prefix is rejected.
-  */
+   * Optional per-instance key prefix applied to every operation (get/put/
+   * delete/list). Use for multi-tenant key namespacing — equivalent to
+   * calling the `scopeKey` helper on every key. Combined via `scopeKey`, so a
+   * `..` or NUL in the prefix is rejected.
+   */
   keyPrefix?: string;
   /** The bound KV namespace (`env.&lt;BINDING>`). */
   namespace: KVNamespaceLike;
@@ -98,9 +98,9 @@ interface KvPutOptions {
   /** Arbitrary metadata stored alongside the value (returned by `getWithMetadata`/`list`). */
   metadata?: unknown;
   /**
-  * When true, write `value` to KV verbatim (no `JSON.stringify`). `value`
-  * must already be a KV-writable type (string/ArrayBuffer/stream).
-  */
+   * When true, write `value` to KV verbatim (no `JSON.stringify`). `value`
+   * must already be a KV-writable type (string/ArrayBuffer/stream).
+   */
   raw?: boolean;
 }
 /** Options for {@link Kv.list}. */
@@ -117,9 +117,9 @@ interface KvListResult<Metadata = unknown> {
   /** Cursor for the next page; `undefined` when the listing is complete. */
   cursor?: string;
   /**
-  * The key names, with any instance `keyPrefix` stripped back off so callers
-  * see the same keys they wrote.
-  */
+   * The key names, with any instance `keyPrefix` stripped back off so callers
+   * see the same keys they wrote.
+   */
   keys: KvListKey<Metadata>[];
   /** True when this is the final page (no further `cursor`). */
   listComplete: boolean;
@@ -132,46 +132,46 @@ interface KvValueWithMetadata<Value, Metadata> {
   value: Value | null;
 }
 /**
-* The typed Workers KV client bound to `ctx.kv`. JSON-decodes/encodes by
-* default; a raw escape hatch ({@link Kv.getRaw} / `put(..., { raw: true })`)
-* handles text/binary/stream values.
-*/
+ * The typed Workers KV client bound to `ctx.kv`. JSON-decodes/encodes by
+ * default; a raw escape hatch ({@link Kv.getRaw} / `put(..., { raw: true })`)
+ * handles text/binary/stream values.
+ */
 interface Kv {
   /** Delete a key. No-op if absent. */
   delete: (key: string) => Promise<void>;
   /**
-  * Read a key and `JSON.parse` it into `T`. Returns `null` when the key is
-  * absent. Throws if the stored value isn't valid JSON — use
-  * {@link Kv.getRaw} for non-JSON values.
-  */
+   * Read a key and `JSON.parse` it into `T`. Returns `null` when the key is
+   * absent. Throws if the stored value isn't valid JSON — use
+   * {@link Kv.getRaw} for non-JSON values.
+   */
   get: <T = unknown>(key: string, options?: {
     cacheTtl?: number;
   }) => Promise<T | null>;
   /** Read a raw value with an explicit decode `type` (default `"text"`). Returns `null` when absent. */
   getRaw: <T = string>(key: string, options?: KvGetOptions) => Promise<T | null>;
   /**
-  * Read a key's JSON value together with its metadata. Returns
-  * `{ value: null, metadata: null }` when the key is absent.
-  */
+   * Read a key's JSON value together with its metadata. Returns
+   * `{ value: null, metadata: null }` when the key is absent.
+   */
   getWithMetadata: <T = unknown, M = unknown>(key: string, options?: {
     cacheTtl?: number;
   }) => Promise<KvValueWithMetadata<T, M>>;
   /** List keys (optionally `prefix`-filtered, paginated via `cursor`). */
   list: <M = unknown>(options?: KvListOptions) => Promise<KvListResult<M>>;
   /**
-  * Write `value` to `key`. JSON-stringifies `value` unless `options.raw` is
-  * set (in which case `value` must be a KV-writable type). Forwards
-  * `expirationTtl`/`expiration`/`metadata` to the binding.
-  */
+   * Write `value` to `key`. JSON-stringifies `value` unless `options.raw` is
+   * set (in which case `value` must be a KV-writable type). Forwards
+   * `expirationTtl`/`expiration`/`metadata` to the binding.
+   */
   put: <T = unknown>(key: string, value: T, options?: KvPutOptions) => Promise<void>;
 }
 /**
-* Compose a per-tenant key from a scope prefix and a caller-supplied key. Both
-* halves are validated — the prefix may not contain `..` or NUL either, and the
-* resulting key must stay under KV's length ceiling. Recommended for any
-* multi-tenant deployment so client-supplied keys can't address peer data.
-* Mirrors `scopeKey` from `@lunora/storage`.
-*/
+ * Compose a per-tenant key from a scope prefix and a caller-supplied key. Both
+ * halves are validated — the prefix may not contain `..` or NUL either, and the
+ * resulting key must stay under KV's length ceiling. Recommended for any
+ * multi-tenant deployment so client-supplied keys can't address peer data.
+ * Mirrors `scopeKey` from `@lunora/storage`.
+ */
 declare const scopeKey: (prefix: string, key: string) => string;
 declare const createKv: (options: LunoraKvOptions) => Kv;
 /** One KV namespace as the studio's KV browser surfaces it (mirrors the runtime's KvNamespaceSummary). */
@@ -196,9 +196,9 @@ interface KvValueResultLike {
   value: null | string;
 }
 /**
-* The structural shape of a KV introspector — mirrors `KvIntrospector` from
-* `@lunora/runtime` without importing it, keeping the dependency graph clean.
-*/
+ * The structural shape of a KV introspector — mirrors `KvIntrospector` from
+ * `@lunora/runtime` without importing it, keeping the dependency graph clean.
+ */
 interface KvIntrospectorLike {
   deleteKey: (options: {
     key: string;
@@ -227,45 +227,45 @@ interface KvIntrospectorLike {
 /** Construction options for {@link createKvIntrospector}. */
 interface CreateKvIntrospectorOptions {
   /**
-  * Map of binding name → bound KV namespace. Each entry becomes one
-  * namespace the studio can browse. Example:
-  * ```ts
-  * createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } })
-  * ```
-  */
+   * Map of binding name → bound KV namespace. Each entry becomes one
+   * namespace the studio can browse. Example:
+   * ```ts
+   * createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } })
+   * ```
+   */
   namespaces: Record<string, KVNamespaceLike>;
 }
 /**
-* Build a `KvIntrospector`-compatible object from a map of bound KV namespaces.
-* Pass the result as `kvIntrospector` on `WorkerOptions` to enable the studio's
-* KV browser (`/_lunora/admin/kv/*` endpoints).
-* @example
-* ```ts
-* createWorker({
-*   // …
-*   kvIntrospector: createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } }),
-* });
-* ```
-*/
+ * Build a `KvIntrospector`-compatible object from a map of bound KV namespaces.
+ * Pass the result as `kvIntrospector` on `WorkerOptions` to enable the studio's
+ * KV browser (`/_lunora/admin/kv/*` endpoints).
+ * @example
+ * ```ts
+ * createWorker({
+ *   // …
+ *   kvIntrospector: createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } }),
+ * });
+ * ```
+ */
 declare const createKvIntrospector: (options: CreateKvIntrospectorOptions) => KvIntrospectorLike;
 /**
-* Zero-config KV introspector: scan a worker `env` for every bound Workers KV
-* namespace and register each under its binding name. Every `kv_namespaces` entry
-* in `wrangler.jsonc` then appears in the studio's KV browser automatically — no
-* hand-written `createKvIntrospector({ namespaces: … })` call, and any binding
-* name (not just `KV`) and any number of namespaces light up. Non-KV bindings
-* (R2, Durable Objects, queues, secrets, …) are skipped via {@link isKvNamespace}.
-*
-* Returns an introspector even when `env` holds no KV namespaces — its
-* `listNamespaces()` resolves to `[]`, so the studio renders an empty state
-* rather than a "not configured" error.
-* @example
-* ```ts
-* createWorker({
-*   // …
-*   kvIntrospector: createKvIntrospectorFromEnv(env),
-* });
-* ```
-*/
+ * Zero-config KV introspector: scan a worker `env` for every bound Workers KV
+ * namespace and register each under its binding name. Every `kv_namespaces` entry
+ * in `wrangler.jsonc` then appears in the studio's KV browser automatically — no
+ * hand-written `createKvIntrospector({ namespaces: … })` call, and any binding
+ * name (not just `KV`) and any number of namespaces light up. Non-KV bindings
+ * (R2, Durable Objects, queues, secrets, …) are skipped via {@link isKvNamespace}.
+ *
+ * Returns an introspector even when `env` holds no KV namespaces — its
+ * `listNamespaces()` resolves to `[]`, so the studio renders an empty state
+ * rather than a "not configured" error.
+ * @example
+ * ```ts
+ * createWorker({
+ *   // …
+ *   kvIntrospector: createKvIntrospectorFromEnv(env),
+ * });
+ * ```
+ */
 declare const createKvIntrospectorFromEnv: (env: unknown) => KvIntrospectorLike;
 export { type CreateKvIntrospectorOptions, type KVNamespaceLike, type Kv, type KvGetOptions, type KvIntrospectorLike, type KvListKey, type KvListOptions, type KvListResult, type KvNamespaceListResult, type KvNamespacePutOptions, type KvPutOptions, type KvValue, type KvValueType, type KvValueWithMetadata, type LunoraKvOptions, createKv, createKvIntrospector, createKvIntrospectorFromEnv, scopeKey };

package/dist/kv/index.d.ts

@@ -1,16 +1,16 @@
 /**
-* The value types Workers KV can store / return. Mirrors Cloudflare's
-* `KVNamespace` `get`/`put` body unions; declared here so the package stays
-* runtime-agnostic and the `*Like` interfaces don't pull in
-* `@cloudflare/workers-types` at runtime.
-*/
+ * The value types Workers KV can store / return. Mirrors Cloudflare's
+ * `KVNamespace` `get`/`put` body unions; declared here so the package stays
+ * runtime-agnostic and the `*Like` interfaces don't pull in
+ * `@cloudflare/workers-types` at runtime.
+ */
 type KvValue = ReadableStream | ArrayBuffer | ArrayBufferView | string;
 /** How a raw KV read should decode the stored value. Mirrors KV's `type` option. */
 type KvValueType = "text" | "json" | "arrayBuffer" | "stream";
 /**
-* Per-read options forwarded to the binding. `cacheTtl` is KV's edge-cache TTL
-* (seconds, min 60); `type` selects the decode mode for {@link Kv.getRaw}.
-*/
+ * Per-read options forwarded to the binding. `cacheTtl` is KV's edge-cache TTL
+ * (seconds, min 60); `type` selects the decode mode for {@link Kv.getRaw}.
+ */
 interface KvGetOptions {
   /** KV edge-cache TTL in seconds (minimum 60). Forwarded verbatim. */
   cacheTtl?: number;
@@ -18,23 +18,23 @@ interface KvGetOptions {
   type?: KvValueType;
 }
 /**
-* Minimal projection of Cloudflare's `KVNamespace`. Declared structurally so
-* unit tests can pass a plain `Map`-backed double; the real binding satisfies
-* the same shape. Mirrors `R2BucketLike` in `@lunora/storage`.
-*/
+ * Minimal projection of Cloudflare's `KVNamespace`. Declared structurally so
+ * unit tests can pass a plain `Map`-backed double; the real binding satisfies
+ * the same shape. Mirrors `R2BucketLike` in `@lunora/storage`.
+ */
 interface KVNamespaceLike {
   /** Delete a key. No-op if the key is absent. */
   delete: (key: string) => Promise<void>;
   /**
-  * Read a value. The real binding overloads on `options.type`; declared here
-  * as the broad union so a structural double need only return the value (or
-  * `null` when absent).
-  */
+   * Read a value. The real binding overloads on `options.type`; declared here
+   * as the broad union so a structural double need only return the value (or
+   * `null` when absent).
+   */
   get: (key: string, options?: KvGetOptions | KvValueType) => Promise<unknown>;
   /**
-  * Read a value together with its associated metadata. Returns
-  * `{ value: null, metadata: null }` when the key is absent.
-  */
+   * Read a value together with its associated metadata. Returns
+   * `{ value: null, metadata: null }` when the key is absent.
+   */
   getWithMetadata: (key: string, options?: KvGetOptions | KvValueType) => Promise<{
     metadata: unknown;
     value: unknown;
@@ -80,11 +80,11 @@ type KvNamespaceListResult<Metadata = unknown> = {
 /** Construction options for the `createKv` factory. */
 interface LunoraKvOptions {
   /**
-  * Optional per-instance key prefix applied to every operation (get/put/
-  * delete/list). Use for multi-tenant key namespacing — equivalent to
-  * calling the `scopeKey` helper on every key. Combined via `scopeKey`, so a
-  * `..` or NUL in the prefix is rejected.
-  */
+   * Optional per-instance key prefix applied to every operation (get/put/
+   * delete/list). Use for multi-tenant key namespacing — equivalent to
+   * calling the `scopeKey` helper on every key. Combined via `scopeKey`, so a
+   * `..` or NUL in the prefix is rejected.
+   */
   keyPrefix?: string;
   /** The bound KV namespace (`env.&lt;BINDING>`). */
   namespace: KVNamespaceLike;
@@ -98,9 +98,9 @@ interface KvPutOptions {
   /** Arbitrary metadata stored alongside the value (returned by `getWithMetadata`/`list`). */
   metadata?: unknown;
   /**
-  * When true, write `value` to KV verbatim (no `JSON.stringify`). `value`
-  * must already be a KV-writable type (string/ArrayBuffer/stream).
-  */
+   * When true, write `value` to KV verbatim (no `JSON.stringify`). `value`
+   * must already be a KV-writable type (string/ArrayBuffer/stream).
+   */
   raw?: boolean;
 }
 /** Options for {@link Kv.list}. */
@@ -117,9 +117,9 @@ interface KvListResult<Metadata = unknown> {
   /** Cursor for the next page; `undefined` when the listing is complete. */
   cursor?: string;
   /**
-  * The key names, with any instance `keyPrefix` stripped back off so callers
-  * see the same keys they wrote.
-  */
+   * The key names, with any instance `keyPrefix` stripped back off so callers
+   * see the same keys they wrote.
+   */
   keys: KvListKey<Metadata>[];
   /** True when this is the final page (no further `cursor`). */
   listComplete: boolean;
@@ -132,46 +132,46 @@ interface KvValueWithMetadata<Value, Metadata> {
   value: Value | null;
 }
 /**
-* The typed Workers KV client bound to `ctx.kv`. JSON-decodes/encodes by
-* default; a raw escape hatch ({@link Kv.getRaw} / `put(..., { raw: true })`)
-* handles text/binary/stream values.
-*/
+ * The typed Workers KV client bound to `ctx.kv`. JSON-decodes/encodes by
+ * default; a raw escape hatch ({@link Kv.getRaw} / `put(..., { raw: true })`)
+ * handles text/binary/stream values.
+ */
 interface Kv {
   /** Delete a key. No-op if absent. */
   delete: (key: string) => Promise<void>;
   /**
-  * Read a key and `JSON.parse` it into `T`. Returns `null` when the key is
-  * absent. Throws if the stored value isn't valid JSON — use
-  * {@link Kv.getRaw} for non-JSON values.
-  */
+   * Read a key and `JSON.parse` it into `T`. Returns `null` when the key is
+   * absent. Throws if the stored value isn't valid JSON — use
+   * {@link Kv.getRaw} for non-JSON values.
+   */
   get: <T = unknown>(key: string, options?: {
     cacheTtl?: number;
   }) => Promise<T | null>;
   /** Read a raw value with an explicit decode `type` (default `"text"`). Returns `null` when absent. */
   getRaw: <T = string>(key: string, options?: KvGetOptions) => Promise<T | null>;
   /**
-  * Read a key's JSON value together with its metadata. Returns
-  * `{ value: null, metadata: null }` when the key is absent.
-  */
+   * Read a key's JSON value together with its metadata. Returns
+   * `{ value: null, metadata: null }` when the key is absent.
+   */
   getWithMetadata: <T = unknown, M = unknown>(key: string, options?: {
     cacheTtl?: number;
   }) => Promise<KvValueWithMetadata<T, M>>;
   /** List keys (optionally `prefix`-filtered, paginated via `cursor`). */
   list: <M = unknown>(options?: KvListOptions) => Promise<KvListResult<M>>;
   /**
-  * Write `value` to `key`. JSON-stringifies `value` unless `options.raw` is
-  * set (in which case `value` must be a KV-writable type). Forwards
-  * `expirationTtl`/`expiration`/`metadata` to the binding.
-  */
+   * Write `value` to `key`. JSON-stringifies `value` unless `options.raw` is
+   * set (in which case `value` must be a KV-writable type). Forwards
+   * `expirationTtl`/`expiration`/`metadata` to the binding.
+   */
   put: <T = unknown>(key: string, value: T, options?: KvPutOptions) => Promise<void>;
 }
 /**
-* Compose a per-tenant key from a scope prefix and a caller-supplied key. Both
-* halves are validated — the prefix may not contain `..` or NUL either, and the
-* resulting key must stay under KV's length ceiling. Recommended for any
-* multi-tenant deployment so client-supplied keys can't address peer data.
-* Mirrors `scopeKey` from `@lunora/storage`.
-*/
+ * Compose a per-tenant key from a scope prefix and a caller-supplied key. Both
+ * halves are validated — the prefix may not contain `..` or NUL either, and the
+ * resulting key must stay under KV's length ceiling. Recommended for any
+ * multi-tenant deployment so client-supplied keys can't address peer data.
+ * Mirrors `scopeKey` from `@lunora/storage`.
+ */
 declare const scopeKey: (prefix: string, key: string) => string;
 declare const createKv: (options: LunoraKvOptions) => Kv;
 /** One KV namespace as the studio's KV browser surfaces it (mirrors the runtime's KvNamespaceSummary). */
@@ -196,9 +196,9 @@ interface KvValueResultLike {
   value: null | string;
 }
 /**
-* The structural shape of a KV introspector — mirrors `KvIntrospector` from
-* `@lunora/runtime` without importing it, keeping the dependency graph clean.
-*/
+ * The structural shape of a KV introspector — mirrors `KvIntrospector` from
+ * `@lunora/runtime` without importing it, keeping the dependency graph clean.
+ */
 interface KvIntrospectorLike {
   deleteKey: (options: {
     key: string;
@@ -227,45 +227,45 @@ interface KvIntrospectorLike {
 /** Construction options for {@link createKvIntrospector}. */
 interface CreateKvIntrospectorOptions {
   /**
-  * Map of binding name → bound KV namespace. Each entry becomes one
-  * namespace the studio can browse. Example:
-  * ```ts
-  * createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } })
-  * ```
-  */
+   * Map of binding name → bound KV namespace. Each entry becomes one
+   * namespace the studio can browse. Example:
+   * ```ts
+   * createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } })
+   * ```
+   */
   namespaces: Record<string, KVNamespaceLike>;
 }
 /**
-* Build a `KvIntrospector`-compatible object from a map of bound KV namespaces.
-* Pass the result as `kvIntrospector` on `WorkerOptions` to enable the studio's
-* KV browser (`/_lunora/admin/kv/*` endpoints).
-* @example
-* ```ts
-* createWorker({
-*   // …
-*   kvIntrospector: createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } }),
-* });
-* ```
-*/
+ * Build a `KvIntrospector`-compatible object from a map of bound KV namespaces.
+ * Pass the result as `kvIntrospector` on `WorkerOptions` to enable the studio's
+ * KV browser (`/_lunora/admin/kv/*` endpoints).
+ * @example
+ * ```ts
+ * createWorker({
+ *   // …
+ *   kvIntrospector: createKvIntrospector({ namespaces: { MY_KV: env.MY_KV } }),
+ * });
+ * ```
+ */
 declare const createKvIntrospector: (options: CreateKvIntrospectorOptions) => KvIntrospectorLike;
 /**
-* Zero-config KV introspector: scan a worker `env` for every bound Workers KV
-* namespace and register each under its binding name. Every `kv_namespaces` entry
-* in `wrangler.jsonc` then appears in the studio's KV browser automatically — no
-* hand-written `createKvIntrospector({ namespaces: … })` call, and any binding
-* name (not just `KV`) and any number of namespaces light up. Non-KV bindings
-* (R2, Durable Objects, queues, secrets, …) are skipped via {@link isKvNamespace}.
-*
-* Returns an introspector even when `env` holds no KV namespaces — its
-* `listNamespaces()` resolves to `[]`, so the studio renders an empty state
-* rather than a "not configured" error.
-* @example
-* ```ts
-* createWorker({
-*   // …
-*   kvIntrospector: createKvIntrospectorFromEnv(env),
-* });
-* ```
-*/
+ * Zero-config KV introspector: scan a worker `env` for every bound Workers KV
+ * namespace and register each under its binding name. Every `kv_namespaces` entry
+ * in `wrangler.jsonc` then appears in the studio's KV browser automatically — no
+ * hand-written `createKvIntrospector({ namespaces: … })` call, and any binding
+ * name (not just `KV`) and any number of namespaces light up. Non-KV bindings
+ * (R2, Durable Objects, queues, secrets, …) are skipped via {@link isKvNamespace}.
+ *
+ * Returns an introspector even when `env` holds no KV namespaces — its
+ * `listNamespaces()` resolves to `[]`, so the studio renders an empty state
+ * rather than a "not configured" error.
+ * @example
+ * ```ts
+ * createWorker({
+ *   // …
+ *   kvIntrospector: createKvIntrospectorFromEnv(env),
+ * });
+ * ```
+ */
 declare const createKvIntrospectorFromEnv: (env: unknown) => KvIntrospectorLike;
 export { type CreateKvIntrospectorOptions, type KVNamespaceLike, type Kv, type KvGetOptions, type KvIntrospectorLike, type KvListKey, type KvListOptions, type KvListResult, type KvNamespaceListResult, type KvNamespacePutOptions, type KvPutOptions, type KvValue, type KvValueType, type KvValueWithMetadata, type LunoraKvOptions, createKv, createKvIntrospector, createKvIntrospectorFromEnv, scopeKey };

package/dist/pipelines/index.d.mts

@@ -1,40 +1,40 @@
 /**
-* Structural types for the Cloudflare Pipelines write path (R2-backed streaming
-* ingestion). Pipelines is the other "emit data to a sink" surface alongside
-* Analytics Engine — telemetry/events out, no in-handler read-back. The binding
-* is mirrored structurally (`*Like`) so a plain-object fake satisfies it in unit
-* tests, like `@lunora/bindings/analytics`'s `AnalyticsEngineDatasetLike`.
-*/
+ * Structural types for the Cloudflare Pipelines write path (R2-backed streaming
+ * ingestion). Pipelines is the other "emit data to a sink" surface alongside
+ * Analytics Engine — telemetry/events out, no in-handler read-back. The binding
+ * is mirrored structurally (`*Like`) so a plain-object fake satisfies it in unit
+ * tests, like `@lunora/bindings/analytics`'s `AnalyticsEngineDatasetLike`.
+ */
 /** One Pipelines record — a JSON object matching the stream's schema. */
 type PipelineRecord = Record<string, unknown>;
 /**
-* Minimal structural projection of workers-types' `Pipeline&lt;T>` binding. The
-* real binding's `send` takes an array of records and resolves once accepted.
-*/
+ * Minimal structural projection of workers-types' `Pipeline&lt;T>` binding. The
+ * real binding's `send` takes an array of records and resolves once accepted.
+ */
 interface PipelineBindingLike<T extends PipelineRecord = PipelineRecord> {
   send: (records: T[]) => Promise<void>;
 }
 /**
-* The write-side client bound to `ctx.pipelines` (the generated context imports
-* this exact type as `import("@lunora/bindings/pipelines").PipelineClient`).
-* Ingestion is durable, batched, and fire-and-forget — never read a record back
-* in-handler.
-*/
+ * The write-side client bound to `ctx.pipelines` (the generated context imports
+ * this exact type as `import("@lunora/bindings/pipelines").PipelineClient`).
+ * Ingestion is durable, batched, and fire-and-forget — never read a record back
+ * in-handler.
+ */
 interface PipelineClient<T extends PipelineRecord = PipelineRecord> {
   /** Ingest one record or an array of records into the R2-backed sink. */
   send: (records: T | T[]) => Promise<void>;
 }
 /**
-* Wrap a Cloudflare Pipelines binding in the write-side {@link PipelineClient}
-* bound to `ctx.pipelines`. The binding is `env.PIPELINES` (the `pipelines`
-* binding the config layer recognizes; the remote pipeline name is minted with
-* `wrangler pipelines create`).
-*
-* Ingestion is durable and batched: `send` accepts one record or an array and
-* resolves once Cloudflare has accepted them for delivery to the R2-backed sink.
-* There is no in-handler read-back — this is a fire-and-forget egress path, so
-* it belongs on ActionCtx only (external I/O), mirroring `ctx.images`.
-*/
+ * Wrap a Cloudflare Pipelines binding in the write-side {@link PipelineClient}
+ * bound to `ctx.pipelines`. The binding is `env.PIPELINES` (the `pipelines`
+ * binding the config layer recognizes; the remote pipeline name is minted with
+ * `wrangler pipelines create`).
+ *
+ * Ingestion is durable and batched: `send` accepts one record or an array and
+ * resolves once Cloudflare has accepted them for delivery to the R2-backed sink.
+ * There is no in-handler read-back — this is a fire-and-forget egress path, so
+ * it belongs on ActionCtx only (external I/O), mirroring `ctx.images`.
+ */
 declare const createPipelines: <T extends PipelineRecord = PipelineRecord>(options: {
   binding: PipelineBindingLike<T>;
 }) => PipelineClient<T>;