@f0rbit/corpus 0.1.5 → 0.1.6

package/dist/observations/utils.js

@@ -0,0 +1,272 @@
+/**
+ * @module ObservationUtils
+ * @description Utility functions for working with SnapshotPointers and observations.
+ */
+import { ok, err } from '../types';
+/**
+ * Creates a SnapshotPointer to a location in a snapshot.
+ *
+ * @category Utilities
+ * @group Pointer Utilities
+ * @param store_id - The store identifier
+ * @param version - The snapshot version
+ * @param path - Optional JSONPath expression to a specific element
+ * @param span - Optional character range within text content
+ * @returns A SnapshotPointer instance
+ *
+ * @example
+ * ```ts
+ * // Point to entire snapshot
+ * const pointer = create_pointer('hansard', 'AZJx4vM')
+ *
+ * // Point to specific element
+ * const element = create_pointer('hansard', 'AZJx4vM', '$.speeches[0]')
+ *
+ * // Point to text range
+ * const range = create_pointer('hansard', 'AZJx4vM', '$.speeches[0].text', { start: 100, end: 250 })
+ * ```
+ */
+export function create_pointer(store_id, version, path, span) {
+    const pointer = { store_id, version };
+    if (path !== undefined)
+        pointer.path = path;
+    if (span !== undefined)
+        pointer.span = span;
+    return pointer;
+}
+/**
+ * Converts a SnapshotPointer to a stable string key for Map storage.
+ *
+ * Format: `store_id:version[:path][:start-end]`
+ *
+ * @category Utilities
+ * @group Pointer Utilities
+ * @param pointer - The pointer to convert
+ * @returns A string key suitable for use as a Map key
+ *
+ * @example
+ * ```ts
+ * const key = pointer_to_key({ store_id: 'hansard', version: 'abc' })
+ * // => 'hansard:abc'
+ *
+ * const pathKey = pointer_to_key({ store_id: 'hansard', version: 'abc', path: '$.foo' })
+ * // => 'hansard:abc:$.foo'
+ *
+ * const spanKey = pointer_to_key({ store_id: 'hansard', version: 'abc', span: { start: 0, end: 10 } })
+ * // => 'hansard:abc:0-10'
+ * ```
+ */
+export function pointer_to_key(pointer) {
+    let key = `${pointer.store_id}:${pointer.version}`;
+    if (pointer.path)
+        key += `:${pointer.path}`;
+    if (pointer.span)
+        key += `:${pointer.span.start}-${pointer.span.end}`;
+    return key;
+}
+/**
+ * Parses a pointer key back to a SnapshotPointer.
+ *
+ * Note: This is a best-effort parse - complex paths containing colons may not round-trip perfectly.
+ *
+ * @category Utilities
+ * @group Pointer Utilities
+ * @param key - The string key to parse
+ * @returns A SnapshotPointer or null if parsing fails
+ *
+ * @example
+ * ```ts
+ * const pointer = key_to_pointer('hansard:abc:$.foo:0-10')
+ * // => { store_id: 'hansard', version: 'abc', path: '$.foo', span: { start: 0, end: 10 } }
+ *
+ * const simple = key_to_pointer('hansard:abc')
+ * // => { store_id: 'hansard', version: 'abc' }
+ *
+ * const invalid = key_to_pointer('invalid')
+ * // => null
+ * ```
+ */
+export function key_to_pointer(key) {
+    const parts = key.split(':');
+    if (parts.length < 2)
+        return null;
+    const [store_id, version, ...rest] = parts;
+    if (!store_id || !version)
+        return null;
+    const pointer = { store_id, version };
+    if (rest.length === 0)
+        return pointer;
+    const last = rest[rest.length - 1];
+    const span_match = /^(\d+)-(\d+)$/.exec(last);
+    if (span_match) {
+        const [, start_str, end_str] = span_match;
+        pointer.span = { start: parseInt(start_str, 10), end: parseInt(end_str, 10) };
+        const path_parts = rest.slice(0, -1);
+        if (path_parts.length > 0)
+            pointer.path = path_parts.join(':');
+    }
+    else {
+        pointer.path = rest.join(':');
+    }
+    return pointer;
+}
+/**
+ * Resolves a JSONPath expression against a value.
+ *
+ * Supports simple dot notation with array indices:
+ * - `$` or empty string - Returns the root value
+ * - `$.foo` - Property access
+ * - `$.foo.bar` - Nested property access
+ * - `$.foo[0]` - Array index access
+ * - `$.foo[0].bar` - Combined access
+ *
+ * @category Utilities
+ * @group Pointer Utilities
+ * @param value - The value to resolve against
+ * @param path - The JSONPath expression
+ * @returns Result containing the resolved value or an error
+ *
+ * @example
+ * ```ts
+ * const data = { speeches: [{ text: 'Hello', speaker: 'Alice' }] }
+ *
+ * const result = resolve_path(data, '$.speeches[0].text')
+ * if (result.ok) console.log(result.value) // 'Hello'
+ *
+ * const root = resolve_path(data, '$')
+ * if (root.ok) console.log(root.value) // { speeches: [...] }
+ * ```
+ */
+export function resolve_path(value, path) {
+    if (!path || path === '$')
+        return ok(value);
+    const normalized = path.startsWith('$.')
+        ? path.slice(2)
+        : path.startsWith('$')
+            ? path.slice(1)
+            : path;
+    if (!normalized)
+        return ok(value);
+    const segments = normalized.split(/\.|\[|\]/).filter(s => s !== '');
+    let current = value;
+    for (const segment of segments) {
+        if (current === null || current === undefined) {
+            return err({
+                kind: 'not_found',
+                store_id: '',
+                version: '',
+                message: `Path segment '${segment}' not found - parent is null/undefined`
+            });
+        }
+        if (typeof current !== 'object') {
+            return err({
+                kind: 'not_found',
+                store_id: '',
+                version: '',
+                message: `Path segment '${segment}' not found - parent is not an object`
+            });
+        }
+        const index = /^\d+$/.test(segment) ? parseInt(segment, 10) : segment;
+        current = current[index];
+    }
+    return ok(current);
+}
+/**
+ * Applies a span (character range) to a string value.
+ *
+ * @category Utilities
+ * @group Pointer Utilities
+ * @param value - The string to slice
+ * @param span - The character range to extract
+ * @returns Result containing the substring or an error for invalid spans
+ *
+ * @example
+ * ```ts
+ * const result = apply_span('Hello, world!', { start: 0, end: 5 })
+ * if (result.ok) console.log(result.value) // 'Hello'
+ *
+ * const invalid = apply_span('Hi', { start: 0, end: 10 })
+ * if (!invalid.ok) console.log(invalid.error.kind) // 'validation_error'
+ * ```
+ */
+export function apply_span(value, span) {
+    if (span.start < 0 || span.end > value.length || span.start > span.end) {
+        return err({
+            kind: 'validation_error',
+            cause: new Error(`Invalid span [${span.start}, ${span.end}] for string of length ${value.length}`),
+            message: `Invalid span [${span.start}, ${span.end}] for string of length ${value.length}`
+        });
+    }
+    return ok(value.slice(span.start, span.end));
+}
+/**
+ * Generates a unique observation ID.
+ *
+ * Format: `obs_{timestamp}_{random}` where timestamp is base36-encoded
+ * and random is 8 characters of base36.
+ *
+ * @category Utilities
+ * @group Observation Utilities
+ * @returns A unique observation ID string
+ *
+ * @example
+ * ```ts
+ * const id = generate_observation_id()
+ * // => 'obs_lq9x2k_a7b3c2d1'
+ * ```
+ */
+export function generate_observation_id() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 10);
+    return `obs_${timestamp}_${random}`;
+}
+/**
+ * Checks if two SnapshotPointers reference the same location.
+ *
+ * @category Utilities
+ * @group Pointer Utilities
+ * @param a - First pointer
+ * @param b - Second pointer
+ * @returns True if pointers reference the same location
+ *
+ * @example
+ * ```ts
+ * const p1 = create_pointer('hansard', 'abc', '$.foo')
+ * const p2 = create_pointer('hansard', 'abc', '$.foo')
+ * const p3 = create_pointer('hansard', 'xyz', '$.foo')
+ *
+ * pointers_equal(p1, p2) // true
+ * pointers_equal(p1, p3) // false
+ * ```
+ */
+export function pointers_equal(a, b) {
+    if (a.store_id !== b.store_id)
+        return false;
+    if (a.version !== b.version)
+        return false;
+    if (a.path !== b.path)
+        return false;
+    if (a.span?.start !== b.span?.start)
+        return false;
+    if (a.span?.end !== b.span?.end)
+        return false;
+    return true;
+}
+/**
+ * Creates a pointer to the same snapshot without path or span.
+ *
+ * @category Utilities
+ * @group Pointer Utilities
+ * @param pointer - The source pointer
+ * @returns A pointer to just the snapshot (store_id + version)
+ *
+ * @example
+ * ```ts
+ * const detailed = create_pointer('hansard', 'abc', '$.speeches[0]', { start: 0, end: 100 })
+ * const snapshot = pointer_to_snapshot(detailed)
+ * // => { store_id: 'hansard', version: 'abc' }
+ * ```
+ */
+export function pointer_to_snapshot(pointer) {
+    return { store_id: pointer.store_id, version: pointer.version };
+}

package/dist/sst.d.ts

@@ -52,5 +52,5 @@ export declare function createCorpusInfra(name: string, config?: Partial<CorpusI
  * await env.CORPUS_DB.exec(CORPUS_MIGRATION_SQL)
  * ```
  */
-export declare const CORPUS_MIGRATION_SQL = "\nCREATE TABLE IF NOT EXISTS corpus_snapshots (\n  store_id TEXT NOT NULL,\n  version TEXT NOT NULL,\n  parents TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  invoked_at TEXT,\n  content_hash TEXT NOT NULL,\n  content_type TEXT NOT NULL,\n  size_bytes INTEGER NOT NULL,\n  data_key TEXT NOT NULL,\n  tags TEXT,\n  PRIMARY KEY (store_id, version)\n);\n\nCREATE INDEX IF NOT EXISTS idx_store_created ON corpus_snapshots(store_id, created_at);\nCREATE INDEX IF NOT EXISTS idx_content_hash ON corpus_snapshots(store_id, content_hash);\nCREATE INDEX IF NOT EXISTS idx_data_key ON corpus_snapshots(data_key);\n";
+export declare const CORPUS_MIGRATION_SQL = "\nCREATE TABLE IF NOT EXISTS corpus_snapshots (\n  store_id TEXT NOT NULL,\n  version TEXT NOT NULL,\n  parents TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  invoked_at TEXT,\n  content_hash TEXT NOT NULL,\n  content_type TEXT NOT NULL,\n  size_bytes INTEGER NOT NULL,\n  data_key TEXT NOT NULL,\n  tags TEXT,\n  PRIMARY KEY (store_id, version)\n);\n\nCREATE INDEX IF NOT EXISTS idx_store_created ON corpus_snapshots(store_id, created_at);\nCREATE INDEX IF NOT EXISTS idx_content_hash ON corpus_snapshots(store_id, content_hash);\nCREATE INDEX IF NOT EXISTS idx_data_key ON corpus_snapshots(data_key);\n\nCREATE TABLE IF NOT EXISTS corpus_observations (\n  id TEXT PRIMARY KEY,\n  type TEXT NOT NULL,\n  source_store_id TEXT NOT NULL,\n  source_version TEXT NOT NULL,\n  source_path TEXT,\n  source_span_start TEXT,\n  source_span_end TEXT,\n  content TEXT NOT NULL,\n  confidence REAL,\n  observed_at TEXT,\n  created_at TEXT NOT NULL,\n  derived_from TEXT\n);\n\nCREATE INDEX IF NOT EXISTS idx_obs_type ON corpus_observations(type);\nCREATE INDEX IF NOT EXISTS idx_obs_source ON corpus_observations(source_store_id, source_version);\nCREATE INDEX IF NOT EXISTS idx_obs_type_observed ON corpus_observations(type, observed_at);\nCREATE INDEX IF NOT EXISTS idx_obs_type_source ON corpus_observations(type, source_store_id);\n";
 //# sourceMappingURL=sst.d.ts.map

package/dist/sst.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sst.d.ts","sourceRoot":"","sources":["../sst.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,WAAW,CAUb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,imBAkBhC,CAAA"}
+{"version":3,"file":"sst.d.ts","sourceRoot":"","sources":["../sst.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,WAAW,CAUb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,kzCAsChC,CAAA"}

package/dist/sst.js

@@ -64,4 +64,24 @@ CREATE TABLE IF NOT EXISTS corpus_snapshots (
 CREATE INDEX IF NOT EXISTS idx_store_created ON corpus_snapshots(store_id, created_at);
 CREATE INDEX IF NOT EXISTS idx_content_hash ON corpus_snapshots(store_id, content_hash);
 CREATE INDEX IF NOT EXISTS idx_data_key ON corpus_snapshots(data_key);
+
+CREATE TABLE IF NOT EXISTS corpus_observations (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  source_store_id TEXT NOT NULL,
+  source_version TEXT NOT NULL,
+  source_path TEXT,
+  source_span_start TEXT,
+  source_span_end TEXT,
+  content TEXT NOT NULL,
+  confidence REAL,
+  observed_at TEXT,
+  created_at TEXT NOT NULL,
+  derived_from TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_obs_type ON corpus_observations(type);
+CREATE INDEX IF NOT EXISTS idx_obs_source ON corpus_observations(source_store_id, source_version);
+CREATE INDEX IF NOT EXISTS idx_obs_type_observed ON corpus_observations(type, observed_at);
+CREATE INDEX IF NOT EXISTS idx_obs_type_source ON corpus_observations(type, source_store_id);
 `;

package/dist/types.d.ts

@@ -2,6 +2,7 @@
  * @module Types
  * @description Type definitions for the corpus library.
  */
+import type { SnapshotPointer, Observation, ObservationMeta, ObservationTypeDef, ObservationPutOpts, ObservationQueryOpts } from './observations/types';
 /**
  * Error types that can occur during Corpus operations.
  * @category Types
@@ -56,6 +57,13 @@ export type CorpusError = {
 } | {
     kind: 'invalid_config';
     message: string;
+} | {
+    kind: 'validation_error';
+    cause: Error;
+    message: string;
+} | {
+    kind: 'observation_not_found';
+    id: string;
 };
 /**
  * A discriminated union representing either success or failure.
@@ -260,6 +268,7 @@ export type ListOpts = {
 export type Backend = {
     metadata: MetadataClient;
     data: DataClient;
+    observations?: ObservationsClient;
     on_event?: EventHandler;
 };
 /**
@@ -391,11 +400,63 @@ export declare function define_store<Id extends string, T>(id: Id, codec: Codec<
 export type CorpusBuilder<Stores extends Record<string, Store<any>> = {}> = {
     with_backend: (backend: Backend) => CorpusBuilder<Stores>;
     with_store: <Id extends string, T>(definition: StoreDefinition<Id, T>) => CorpusBuilder<Stores & Record<Id, Store<T>>>;
+    with_observations: (types: ObservationTypeDef<unknown>[]) => CorpusBuilder<Stores>;
     build: () => Corpus<Stores>;
 };
 export type Corpus<Stores extends Record<string, Store<any>> = Record<string, Store<any>>> = {
     stores: Stores;
     metadata: MetadataClient;
     data: DataClient;
+    observations?: ObservationsClient;
+    create_pointer: (store_id: string, version: string, path?: string, span?: {
+        start: number;
+        end: number;
+    }) => SnapshotPointer;
+    resolve_pointer: <T>(pointer: SnapshotPointer) => Promise<Result<T, CorpusError>>;
+    is_superseded: (pointer: SnapshotPointer) => Promise<boolean>;
+};
+/**
+ * Client interface for managing observations.
+ *
+ * Observations are structured facts that point back to specific locations
+ * in versioned content. The ObservationsClient provides CRUD operations
+ * with type-safe validation via ObservationTypeDef schemas.
+ *
+ * Key operations:
+ * - `put` - Create a new observation with validated content
+ * - `get` - Retrieve a single observation by ID
+ * - `query` / `query_meta` - Filter observations with various criteria
+ * - `delete` / `delete_by_source` - Remove observations
+ * - `is_stale` - Check if source content has been superseded
+ *
+ * @category Types
+ * @group Observation Types
+ *
+ * @example
+ * ```ts
+ * // Define observation type
+ * const entity_mention = define_observation_type('entity_mention', EntitySchema)
+ *
+ * // Create observation
+ * const result = await observations.put(entity_mention, {
+ *   source: { store_id: 'hansard', version: 'abc123', path: '$.speeches[0]' },
+ *   content: { entity: 'Climate Change', entity_type: 'topic' },
+ *   confidence: 0.95
+ * })
+ *
+ * // Query observations
+ * for await (const obs of observations.query({ type: 'entity_mention' })) {
+ *   console.log(obs.content)
+ * }
+ * ```
+ */
+export type ObservationsClient = {
+    put: <T>(type: ObservationTypeDef<T>, opts: ObservationPutOpts<T>) => Promise<Result<Observation<T>, CorpusError>>;
+    get: (id: string) => Promise<Result<Observation, CorpusError>>;
+    query: (opts?: ObservationQueryOpts) => AsyncIterable<Observation>;
+    query_meta: (opts?: ObservationQueryOpts) => AsyncIterable<ObservationMeta>;
+    delete: (id: string) => Promise<Result<void, CorpusError>>;
+    delete_by_source: (source: SnapshotPointer) => Promise<Result<number, CorpusError>>;
+    is_stale: (pointer: SnapshotPointer) => Promise<boolean>;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -2,7 +2,7 @@
  * @module Utilities
  * @description Utility functions for hashing, versioning, and codecs.
  */
-import type { Codec } from "./types";
+import type { Codec, CorpusEvent, EventHandler, SnapshotMeta, ListOpts, ParentRef } from "./types";
 /**
  * Computes the SHA-256 hash of binary data.
  * @category Utilities
@@ -129,5 +129,42 @@ export declare function text_codec(): Codec<string>;
  * ```
  */
 export declare function binary_codec(): Codec<Uint8Array>;
+/**
+ * Concatenate multiple Uint8Array chunks into a single array.
+ */
+export declare function concat_bytes(chunks: Uint8Array[]): Uint8Array;
+/**
+ * Read a stream into a single Uint8Array.
+ */
+export declare function stream_to_bytes(stream: ReadableStream<Uint8Array>): Promise<Uint8Array>;
+/**
+ * Convert a stream or Uint8Array to Uint8Array.
+ */
+export declare function to_bytes(data: ReadableStream<Uint8Array> | Uint8Array): Promise<Uint8Array>;
+/**
+ * Create an event emitter function from an optional handler.
+ */
+export declare function create_emitter(handler?: EventHandler): (event: CorpusEvent) => void;
+/**
+ * Filter and sort snapshot metadata based on list options.
+ * Used by in-memory storage implementations (memory backend, file backend).
+ */
+export declare function filter_snapshots(metas: SnapshotMeta[], opts?: ListOpts): SnapshotMeta[];
+/**
+ * Parse a raw snapshot object (from JSON or database row) into a proper SnapshotMeta.
+ * Handles date string conversion and JSON parsing of array fields.
+ */
+export declare function parse_snapshot_meta(raw: {
+    store_id: string;
+    version: string;
+    data_key: string;
+    created_at: string | Date;
+    invoked_at?: string | Date | null;
+    parents?: string | ParentRef[] | null;
+    tags?: string | string[] | null;
+    content_hash?: string;
+    content_type?: string;
+    size_bytes?: number;
+}): SnapshotMeta;
 export {};
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpE;AAKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CA0BzC;AAGD,KAAK,OAAO,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;CAAE,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAM1D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,CAM1C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAAC,UAAU,CAAC,CAMhD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAe,MAAM,SAAS,CAAC;AAEhH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpE;AAKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CA0BzC;AAGD,KAAK,OAAO,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;CAAE,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAM1D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,CAM1C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAAC,UAAU,CAAC,CAMhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS7D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAS7F;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAEjG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAEnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,YAAY,EAAE,EACrB,IAAI,GAAE,QAAa,GACjB,YAAY,EAAE,CAuBhB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,IAAI,CAAA;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,YAAY,CAmBf"}

package/dist/utils.js

@@ -172,3 +172,87 @@ export function binary_codec() {
         decode: (bytes) => bytes,
     };
 }
+/**
+ * Concatenate multiple Uint8Array chunks into a single array.
+ */
+export function concat_bytes(chunks) {
+    const total = chunks.reduce((sum, c) => sum + c.length, 0);
+    const result = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+/**
+ * Read a stream into a single Uint8Array.
+ */
+export async function stream_to_bytes(stream) {
+    const chunks = [];
+    const reader = stream.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+    }
+    return concat_bytes(chunks);
+}
+/**
+ * Convert a stream or Uint8Array to Uint8Array.
+ */
+export async function to_bytes(data) {
+    return data instanceof Uint8Array ? data : await stream_to_bytes(data);
+}
+/**
+ * Create an event emitter function from an optional handler.
+ */
+export function create_emitter(handler) {
+    return (event) => handler?.(event);
+}
+/**
+ * Filter and sort snapshot metadata based on list options.
+ * Used by in-memory storage implementations (memory backend, file backend).
+ */
+export function filter_snapshots(metas, opts = {}) {
+    let filtered = metas;
+    if (opts.before) {
+        filtered = filtered.filter(m => m.created_at < opts.before);
+    }
+    if (opts.after) {
+        filtered = filtered.filter(m => m.created_at > opts.after);
+    }
+    if (opts.tags && opts.tags.length > 0) {
+        filtered = filtered.filter(m => opts.tags.every(tag => m.tags?.includes(tag)));
+    }
+    filtered.sort((a, b) => b.created_at.getTime() - a.created_at.getTime());
+    if (opts.limit) {
+        filtered = filtered.slice(0, opts.limit);
+    }
+    return filtered;
+}
+/**
+ * Parse a raw snapshot object (from JSON or database row) into a proper SnapshotMeta.
+ * Handles date string conversion and JSON parsing of array fields.
+ */
+export function parse_snapshot_meta(raw) {
+    return {
+        store_id: raw.store_id,
+        version: raw.version,
+        data_key: raw.data_key,
+        created_at: raw.created_at instanceof Date ? raw.created_at : new Date(raw.created_at),
+        invoked_at: raw.invoked_at
+            ? (raw.invoked_at instanceof Date ? raw.invoked_at : new Date(raw.invoked_at))
+            : undefined,
+        parents: raw.parents
+            ? (typeof raw.parents === 'string' ? JSON.parse(raw.parents) : raw.parents)
+            : [],
+        tags: raw.tags
+            ? (typeof raw.tags === 'string' ? JSON.parse(raw.tags) : raw.tags)
+            : undefined,
+        content_hash: raw.content_hash ?? '',
+        content_type: (raw.content_type ?? 'application/octet-stream'),
+        size_bytes: raw.size_bytes ?? 0,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f0rbit/corpus",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "A functional snapshotting library for TypeScript with versioned data storage, lineage tracking, and multiple backend support",
   "module": "dist/index.js",
   "main": "dist/index.js",

package/dist/codecs.d.ts

@@ -1,8 +0,0 @@
-/**
- * Codec implementations for serializing and deserializing data.
- * @module Codecs
- * @packageDocumentation
- */
-export { json_codec, text_codec, binary_codec } from './utils';
-export type { Codec, ContentType } from './types';
-//# sourceMappingURL=codecs.d.ts.map

package/dist/codecs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../codecs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC9D,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA"}

package/dist/codecs.js

@@ -1,6 +0,0 @@
-/**
- * Codec implementations for serializing and deserializing data.
- * @module Codecs
- * @packageDocumentation
- */
-export { json_codec, text_codec, binary_codec } from './utils';

package/dist/core.d.ts

@@ -1,9 +0,0 @@
-/**
- * Core corpus functionality for creating and managing versioned data stores.
- * @module Core
- * @packageDocumentation
- */
-export { create_corpus, create_store } from './corpus';
-export { define_store, ok, err } from './types';
-export type { Corpus, CorpusBuilder, Store, StoreDefinition, Result, CorpusError, PutOpts, } from './types';
-//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC/C,YAAY,EACV,MAAM,EACN,aAAa,EACb,KAAK,EACL,eAAe,EACf,MAAM,EACN,WAAW,EACX,OAAO,GACR,MAAM,SAAS,CAAA"}

package/dist/core.js

@@ -1,7 +0,0 @@
-/**
- * Core corpus functionality for creating and managing versioned data stores.
- * @module Core
- * @packageDocumentation
- */
-export { create_corpus, create_store } from './corpus';
-export { define_store, ok, err } from './types';