@noy-db/hub 0.2.0-pre.8 → 0.3.0-pre.1

package/dist/mime-magic-CBBSOkjm.d.cts

@@ -1,50 +0,0 @@
-/**
- * Lightweight MIME type detection from magic bytes (file signatures).
- *
- * Designed for the blob store's auto-detection feature. Operates on the first 16 bytes of
- * plaintext — no filesystem access, no filename guessing.
- *
- * ## Detection strategies
- *
- * 1. **Prefix match** — magic bytes at offset 0 (most formats).
- * 2. **Offset match** — magic bytes at a fixed offset > 0 (ISOBMFF: offset 4).
- * 3. **Compound match** — two separate byte sequences at different offsets
- *    (RIFF-based: bytes 0-3 + bytes 8-11).
- *
- * ## Formats excluded (require offset > 16 bytes)
- *
- * - TAR (`ustar` at offset 257)
- * - ISO 9660 (`CD001` at offset 32769)
- *
- * @module
- */
-/**
- * Detect MIME type from the first bytes of a file.
- *
- * @param header - The first 16 bytes (or more) of the plaintext. Passing
- *   fewer than 16 bytes may miss compound and offset-based matches.
- * @returns Detected MIME type, or `'application/octet-stream'` if unknown.
- */
-declare function detectMimeType(header: Uint8Array): string;
-/**
- * Detect MIME type and whether the format is already compressed.
- *
- * Used by `BlobSet.put()` to decide whether to skip gzip compression.
- *
- * @param header - The first 16 bytes (or more) of the plaintext.
- * @returns `{ mime, preCompressed }` or `null` if no match.
- */
-declare function detectMagic(header: Uint8Array): {
-    mime: string;
-    format: string;
-    preCompressed: boolean;
-} | null;
-/**
- * Check whether a format is already compressed (should skip gzip).
- *
- * @param mimeType - A MIME type string.
- * @returns `true` if the format is known to be pre-compressed.
- */
-declare function isPreCompressed(mimeType: string): boolean;
-
-export { detectMimeType as a, detectMagic as d, isPreCompressed as i };

package/dist/mime-magic-CBBSOkjm.d.ts

@@ -1,50 +0,0 @@
-/**
- * Lightweight MIME type detection from magic bytes (file signatures).
- *
- * Designed for the blob store's auto-detection feature. Operates on the first 16 bytes of
- * plaintext — no filesystem access, no filename guessing.
- *
- * ## Detection strategies
- *
- * 1. **Prefix match** — magic bytes at offset 0 (most formats).
- * 2. **Offset match** — magic bytes at a fixed offset > 0 (ISOBMFF: offset 4).
- * 3. **Compound match** — two separate byte sequences at different offsets
- *    (RIFF-based: bytes 0-3 + bytes 8-11).
- *
- * ## Formats excluded (require offset > 16 bytes)
- *
- * - TAR (`ustar` at offset 257)
- * - ISO 9660 (`CD001` at offset 32769)
- *
- * @module
- */
-/**
- * Detect MIME type from the first bytes of a file.
- *
- * @param header - The first 16 bytes (or more) of the plaintext. Passing
- *   fewer than 16 bytes may miss compound and offset-based matches.
- * @returns Detected MIME type, or `'application/octet-stream'` if unknown.
- */
-declare function detectMimeType(header: Uint8Array): string;
-/**
- * Detect MIME type and whether the format is already compressed.
- *
- * Used by `BlobSet.put()` to decide whether to skip gzip compression.
- *
- * @param header - The first 16 bytes (or more) of the plaintext.
- * @returns `{ mime, preCompressed }` or `null` if no match.
- */
-declare function detectMagic(header: Uint8Array): {
-    mime: string;
-    format: string;
-    preCompressed: boolean;
-} | null;
-/**
- * Check whether a format is already compressed (should skip gzip).
- *
- * @param mimeType - A MIME type string.
- * @returns `true` if the format is known to be pre-compressed.
- */
-declare function isPreCompressed(mimeType: string): boolean;
-
-export { detectMimeType as a, detectMagic as d, isPreCompressed as i };

package/dist/noydb-LZBH3XDK.js

@@ -1,34 +0,0 @@
-import {
-  Noydb,
-  createNoydb
-} from "./chunk-6774ZOQ7.js";
-import "./chunk-EMIGCR7X.js";
-import "./chunk-TFBP23BX.js";
-import "./chunk-DJHHA6XH.js";
-import "./chunk-2WUSG3IT.js";
-import "./chunk-I5FOWO4J.js";
-import "./chunk-ML236QKC.js";
-import "./chunk-JWRVQKRZ.js";
-import "./chunk-UF3BUNQZ.js";
-import "./chunk-22DWZL57.js";
-import "./chunk-3YPCK6JX.js";
-import "./chunk-U26HQ6KJ.js";
-import "./chunk-DONMZAD2.js";
-import "./chunk-2QR2PQTT.js";
-import "./chunk-FZU343FL.js";
-import "./chunk-PE2FR4J3.js";
-import "./chunk-Z6FNBOTC.js";
-import "./chunk-2GLDA55J.js";
-import "./chunk-OIF6LZUR.js";
-import "./chunk-W6EQLGMB.js";
-import "./chunk-5XHKQ56N.js";
-import "./chunk-TV3YZ35S.js";
-import "./chunk-3BFJOWSU.js";
-import "./chunk-WIRRPTFH.js";
-import "./chunk-PP6W64Y3.js";
-import "./chunk-B6PB7JLN.js";
-export {
-  Noydb,
-  createNoydb
-};
-//# sourceMappingURL=noydb-LZBH3XDK.js.map

package/dist/overlay-views/index.cjs

@@ -1,359 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/overlay-views/index.ts
-var overlay_views_exports = {};
-__export(overlay_views_exports, {
-  OverlayBaseIsVirtualError: () => OverlayBaseIsVirtualError,
-  OverlayCollectionUnavailableError: () => OverlayCollectionUnavailableError,
-  OverlayIdMismatchError: () => OverlayIdMismatchError,
-  OverlayNameCollisionError: () => OverlayNameCollisionError,
-  OverlayedCollection: () => OverlayedCollection,
-  OverlayedViewRegistry: () => OverlayedViewRegistry,
-  withOverlayedView: () => withOverlayedView
-});
-module.exports = __toCommonJS(overlay_views_exports);
-
-// src/errors.ts
-var NoydbError = class extends Error {
-  /** Machine-readable error code. Stable across library versions. */
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "NoydbError";
-    this.code = code;
-  }
-};
-var ValidationError = class extends NoydbError {
-  constructor(message = "Validation error") {
-    super("VALIDATION_ERROR", message);
-    this.name = "ValidationError";
-  }
-};
-var OverlayBaseIsVirtualError = class extends NoydbError {
-  overlayName;
-  base;
-  constructor(overlayName, base) {
-    super(
-      "OVERLAY_BASE_IS_VIRTUAL",
-      `withOverlayedView "${overlayName}": base "${base}" is another overlay's virtual name. Multi-overlay stacking is a v3 feature; base must reference a concrete collection (a real source or an MV output).`
-    );
-    this.name = "OverlayBaseIsVirtualError";
-    this.overlayName = overlayName;
-    this.base = base;
-  }
-};
-var OverlayCollectionUnavailableError = class extends NoydbError {
-  overlayName;
-  overlay;
-  constructor(overlayName, overlay) {
-    super(
-      "OVERLAY_COLLECTION_UNAVAILABLE",
-      `withOverlayedView "${overlayName}": overlay collection "${overlay}" is unavailable. It must be a real vault-known collection that is NOT itself an MV output collection.`
-    );
-    this.name = "OverlayCollectionUnavailableError";
-    this.overlayName = overlayName;
-    this.overlay = overlay;
-  }
-};
-var OverlayNameCollisionError = class extends NoydbError {
-  overlayName;
-  constructor(overlayName) {
-    super(
-      "OVERLAY_NAME_COLLISION",
-      `withOverlayedView "${overlayName}": virtual name collides with an MV output or a concrete source collection. Pick a unique name for the virtual collection.`
-    );
-    this.name = "OverlayNameCollisionError";
-    this.overlayName = overlayName;
-  }
-};
-var OverlayIdMismatchError = class extends NoydbError {
-  actual;
-  expected;
-  constructor(actual, expected) {
-    super(
-      "OVERLAY_ID_MISMATCH",
-      `Overlay put(id, record): id "${actual}" does not match the base MV's rowKey(record) \u2192 "${expected}". Pass the row directly via .put(record) to derive the id, or fix the id to match the base MV's rowKey output.`
-    );
-    this.name = "OverlayIdMismatchError";
-    this.actual = actual;
-    this.expected = expected;
-  }
-};
-
-// src/overlay-views/with-overlayed-view.ts
-function withOverlayedView(spec) {
-  if (!spec.name || spec.name.length === 0) {
-    throw new ValidationError("withOverlayedView: name is required");
-  }
-  if (!spec.base || spec.base.length === 0) {
-    throw new ValidationError("withOverlayedView: base is required");
-  }
-  if (!spec.overlay || spec.overlay.length === 0) {
-    throw new ValidationError("withOverlayedView: overlay is required");
-  }
-  if (spec.base === spec.overlay) {
-    throw new ValidationError("withOverlayedView: base and overlay must be different collections");
-  }
-  if (spec.base === spec.name || spec.overlay === spec.name) {
-    throw new ValidationError(
-      "withOverlayedView: virtual name must differ from both base and overlay collection names"
-    );
-  }
-  if (!spec.shadowField || spec.shadowField.length === 0) {
-    throw new ValidationError("withOverlayedView: shadowField is required");
-  }
-  return {
-    __noydb_strategy: "overlayed-view",
-    spec
-  };
-}
-
-// src/overlay-views/registry.ts
-var OverlayedViewRegistry = class {
-  _byName = /* @__PURE__ */ new Map();
-  /**
-   * Register an overlay. Validates name uniqueness, base concreteness,
-   * and overlay availability AGAINST the MV registry — overlays
-   * declared without the MV registry context skip cross-registry
-   * checks but still validate self-consistency.
-   */
-  register(spec, options) {
-    const { isOverlayName, isMVOutput, isKnownCollection } = options;
-    if (isMVOutput?.(spec.name) || isOverlayName?.(spec.name)) {
-      throw new OverlayNameCollisionError(spec.name);
-    }
-    if (isOverlayName?.(spec.base)) {
-      throw new OverlayBaseIsVirtualError(spec.name, spec.base);
-    }
-    if (isMVOutput?.(spec.overlay)) {
-      throw new OverlayCollectionUnavailableError(spec.name, spec.overlay);
-    }
-    void isKnownCollection;
-    this._byName.set(spec.name, spec);
-  }
-  byName(name) {
-    return this._byName.get(name);
-  }
-  /** All overlay virtual names. */
-  names() {
-    return new Set(this._byName.keys());
-  }
-  isOverlay(name) {
-    return this._byName.has(name);
-  }
-  /**
-   * Resolve the `rowKey` function for an overlay's base MV. Returns
-   * `undefined` if the base isn't an MV (raw source collection) or
-   * if the MV registry isn't supplied. Used by the virtual-collection
-   * proxy to derive ids from `put(record)` calls.
-   */
-  resolveBaseRowKey(name, mvRegistry) {
-    const spec = this._byName.get(name);
-    if (!spec || !mvRegistry) return void 0;
-    for (const reg of mvRegistry.all()) {
-      if (reg.outputCollection === spec.base || reg.spec.name === spec.base) {
-        return (row) => reg.spec.rowKey(row);
-      }
-    }
-    return void 0;
-  }
-};
-
-// src/overlay-views/virtual-collection.ts
-var OverlayedCollection = class {
-  constructor(spec, baseCollection, overlayCollection, baseRowKey) {
-    this.spec = spec;
-    this.baseCollection = baseCollection;
-    this.overlayCollection = overlayCollection;
-    this.baseRowKey = baseRowKey;
-  }
-  spec;
-  baseCollection;
-  overlayCollection;
-  baseRowKey;
-  /**
-   * Convenience accessors for advanced callers that need to bypass the
-   * virtual layer (bulk imports, direct overlay queries). Mirrors the
-   * spec's "direct writes to the underlying overlay collection skip
-   * the validation" escape hatch.
-   */
-  overlay = {
-    rowKey: (row) => {
-      if (!this.baseRowKey) {
-        throw new Error(
-          `Overlay "${this.spec.name}": base "${this.spec.base}" is not an MV \u2014 cannot auto-derive id from the row. Use \`put(id, record)\` instead.`
-        );
-      }
-      return this.baseRowKey(row);
-    }
-  };
-  /** Get the merged row by id. */
-  async get(id) {
-    const overlayRow = await this.overlayCollection.get(id);
-    if (overlayRow !== null && this.shadowPredicateApplies(overlayRow)) {
-      return overlayRow;
-    }
-    const baseRow = await this.baseCollection.get(id);
-    if (baseRow !== null) return baseRow;
-    return null;
-  }
-  /** List union of base + overlay ids, applying the merge per row. */
-  async list() {
-    const baseRows = await this.baseCollection.list();
-    const overlayRows = await this.overlayCollection.list();
-    const merged = /* @__PURE__ */ new Map();
-    const idOf = (row) => {
-      if (this.baseRowKey) return this.baseRowKey(row);
-      const idField = row.id;
-      return typeof idField === "string" ? idField : "";
-    };
-    for (const row of baseRows) {
-      const id = idOf(row);
-      if (id) merged.set(id, row);
-    }
-    for (const row of overlayRows) {
-      const id = idOf(row);
-      if (!id) continue;
-      if (this.shadowPredicateApplies(row)) {
-        merged.set(id, row);
-      } else if (!merged.has(id)) {
-        continue;
-      }
-    }
-    return [...merged.values()];
-  }
-  /**
-   * Write to the overlay. Two forms:
-   * - `put(record)`: id is derived via the base MV's `rowKey(record)`.
-   *   Throws if the base isn't an MV.
-   * - `put(id, record)`: validates `id === rowKey(record)`; throws
-   *   `OverlayIdMismatchError` on mismatch.
-   */
-  async put(idOrRecord, maybeRecord) {
-    let id;
-    let record;
-    if (maybeRecord === void 0) {
-      record = idOrRecord;
-      if (!this.baseRowKey) {
-        throw new Error(
-          `Overlay "${this.spec.name}".put(record): base "${this.spec.base}" is not an MV. Use put(id, record) explicitly.`
-        );
-      }
-      id = this.baseRowKey(record);
-    } else {
-      id = idOrRecord;
-      record = maybeRecord;
-      if (this.baseRowKey) {
-        const expected = this.baseRowKey(record);
-        if (id !== expected) {
-          throw new OverlayIdMismatchError(id, expected);
-        }
-      }
-    }
-    await this.overlayCollection.put(id, record);
-  }
-  /**
-   * Remove the overlay row only. Idempotent (no-op on absent).
-   * The base row is untouched — if a base row exists for `id`,
-   * subsequent reads return it.
-   */
-  async delete(id) {
-    await this.overlayCollection.delete(id);
-  }
-  /** True when `overlay[shadowField] === shadowValue`. */
-  shadowPredicateApplies(row) {
-    return row[this.spec.shadowField] === this.spec.shadowValue;
-  }
-  // ─── Throw-stubs for the unimplemented Collection<T> surface ───────
-  //
-  // `Vault.collection(name)` widens the return type to `Collection<T>`
-  // for the overlay intercept, but `OverlayedCollection` doesn't
-  // implement the full surface. These stubs catch the common
-  // reactive / chainable APIs with a clear "not yet implemented"
-  // error pointing at the relevant issue — so consumers don't hit a
-  // cryptic `undefined is not a function` runtime crash.
-  //
-  // Throw-stubs so consumers get actionable errors rather than cryptic crashes.
-  /** @throws — chainable Query<T> over a virtual collection is deferred. */
-  query() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".query() is not yet implemented for overlay views (#154). Use \`list()\` + filter for now, or read from the underlying \`${this.spec.base}\` / \`${this.spec.overlay}\` collections directly. Reactive APIs land in a future MV sub-issue.`
-    );
-  }
-  /** @throws — change-stream subscription over a virtual collection is deferred. */
-  subscribe() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".subscribe() is not yet implemented for overlay views (#154). Subscribe to the underlying \`${this.spec.base}\` / \`${this.spec.overlay}\` collections individually for now. Merged change-stream lands in a future MV sub-issue.`
-    );
-  }
-  /** @throws — live query over a virtual collection is deferred. */
-  live() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".live() is not yet implemented for overlay views (#154). Reactive APIs land in a future MV sub-issue.`
-    );
-  }
-  /** @throws — async iteration over a virtual collection is deferred. */
-  scan() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".scan() is not yet implemented for overlay views (#154). Use \`list()\` for now (no row-count ceiling at niwat scale), or scan the underlying collections directly.`
-    );
-  }
-  /** @throws — lazy-mode query is not applicable to virtual collections. */
-  lazyQuery() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".lazyQuery() is not supported. Virtual collections always materialize through base + overlay reads \u2014 lazy-mode indexed lookups don't apply.`
-    );
-  }
-  /** @throws — bulk-atomic put is deferred to a future MV sub-issue. */
-  putManyAtomic() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".putManyAtomic() is not yet implemented for overlay views (#154). Use sequential \`.put(record)\` calls for now, or write to \`${this.spec.overlay}\` directly.`
-    );
-  }
-  /** @throws — bulk delete is deferred to a future MV sub-issue. */
-  deleteMany() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".deleteMany() is not yet implemented for overlay views (#154). Use sequential \`.delete(id)\` calls for now, or operate on \`${this.spec.overlay}\` directly.`
-    );
-  }
-  /** @throws — `.first()` over a virtual collection is deferred. */
-  first() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".first() is not yet implemented for overlay views (#154). Use \`(await list())[0]\` for now.`
-    );
-  }
-  /** @throws — `.count()` over a virtual collection is deferred. */
-  count() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".count() is not yet implemented for overlay views (#154). Use \`(await list()).length\` for now.`
-    );
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  OverlayBaseIsVirtualError,
-  OverlayCollectionUnavailableError,
-  OverlayIdMismatchError,
-  OverlayNameCollisionError,
-  OverlayedCollection,
-  OverlayedViewRegistry,
-  withOverlayedView
-});
-//# sourceMappingURL=index.cjs.map