@enbox/api 0.3.2 → 0.4.0

package/dist/esm/typed-enbox.js

@@ -0,0 +1,583 @@
+/**
+ * A protocol-scoped API returned by {@link Enbox.using}.
+ *
+ * `TypedEnbox` is the **primary developer interface** for interacting with
+ * protocol-backed records. It auto-injects the protocol URI, protocolPath,
+ * and schema into every operation, and provides compile-time path
+ * autocompletion plus typed data payloads via the schema map.
+ *
+ * All record-returning methods wrap the underlying `Record` instances in
+ * {@link TypedRecord} so that type information flows through reads, queries,
+ * updates, and subscriptions without manual casts.
+ *
+ * @example
+ * ```ts
+ * const social = enbox.using(SocialProtocol);
+ *
+ * // Install the protocol
+ * await social.configure();
+ *
+ * // Create — path and data type are checked at compile time
+ * const { record } = await social.records.create('thread', {
+ *   data: { title: 'Hello World', body: '...' },
+ * });
+ * // record is TypedRecord<ThreadData>
+ *
+ * const data = await record.data.json(); // ThreadData — no cast needed
+ *
+ * // Query — protocol and protocolPath are auto-injected
+ * const { records } = await social.records.query('thread');
+ * // records is TypedRecord<ThreadData>[]
+ *
+ * // Subscribe — real-time changes via TypedLiveQuery
+ * const { liveQuery } = await social.records.subscribe('thread/reply');
+ * liveQuery.on('create', (record) => {
+ *   // record is TypedRecord<ReplyData>
+ * });
+ * ```
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { TypedLiveQuery } from './typed-live-query.js';
+import { TypedRecord } from './typed-record.js';
+// ---------------------------------------------------------------------------
+// TypedEnbox class
+// ---------------------------------------------------------------------------
+/**
+ * A protocol-scoped API that auto-injects `protocol`, `protocolPath`, and
+ * `schema` into every DWN operation.
+ *
+ * All record-returning methods wrap results in {@link TypedRecord} so that
+ * the data type `T` (resolved from the schema map) flows end-to-end — from
+ * write through read, query, update, and subscribe — without manual casts.
+ *
+ * Obtain an instance via `enbox.using(typedProtocol)`.
+ *
+ * @example
+ * ```ts
+ * const social = enbox.using(SocialProtocol);
+ *
+ * await social.configure();
+ *
+ * const { record } = await social.records.create('friend', {
+ *   data: { did: 'did:example:alice', alias: 'Alice' },
+ * });
+ * const data = await record.data.json(); // FriendData — no cast
+ *
+ * const { records } = await social.records.query('friend', {
+ *   filter: { tags: { did: 'did:example:alice' } },
+ * });
+ * for (const r of records) {
+ *   const d = await r.data.json(); // FriendData
+ * }
+ * ```
+ */
+export class TypedEnbox {
+    /**
+     * @internal Create a new `TypedEnbox` instance. Use `enbox.using(protocol)` instead.
+     * @param dwn - The underlying DWN API instance.
+     * @param protocol - The typed protocol containing the definition and schema map.
+     */
+    constructor(dwn, protocol) {
+        /** @internal */
+        this._configured = false;
+        /** @internal */
+        this._ensureReadyPromise = null;
+        this._dwn = dwn;
+        this._definition = protocol.definition;
+        this._validPaths = collectPaths(this._definition.structure);
+    }
+    /**
+     * The protocol URI string (e.g. `'https://example.com/social'`).
+     *
+     * This is the globally unique identifier for the protocol and is
+     * auto-injected into every record operation.
+     */
+    get protocol() {
+        return this._definition.protocol;
+    }
+    /**
+     * The raw protocol definition object.
+     *
+     * Contains the full `protocol`, `types`, and `structure` that define
+     * the protocol's schema and permission rules.
+     */
+    get definition() {
+        return this._definition;
+    }
+    /**
+     * Configures (installs) this protocol on the local DWN.
+     *
+     * If the protocol is already installed with an identical definition,
+     * this is a no-op and returns the existing protocol with status `200`.
+     * If the definition has changed (e.g. new types, modified structure),
+     * the protocol is re-configured with the updated definition and returns
+     * status `202`.
+     *
+     * **Must be called before any record operations.** Methods like
+     * `records.create()`, `records.query()`, etc. will throw if the protocol
+     * has not been configured.
+     *
+     * @param options - Optional configuration overrides.
+     * @param options.encryption - Whether to enable auto-encryption for the
+     *   protocol. If omitted, follows the protocol definition defaults.
+     * @returns The DWN response status and the installed protocol object.
+     *
+     * @example
+     * ```ts
+     * const proto = enbox.using(NotebookProtocol);
+     *
+     * const { status, protocol } = await proto.configure();
+     * console.log(status.code); // 202 (first install) or 200 (already installed)
+     *
+     * // Now you can use records.create(), records.query(), etc.
+     * ```
+     */
+    configure(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Query for an existing installation of this protocol.
+            const { protocols } = yield this._dwn.protocols.query({
+                filter: { protocol: this._definition.protocol },
+            });
+            // If already installed with the same definition, return it as-is.
+            if (protocols.length > 0) {
+                const existing = protocols[0];
+                if (definitionsEqual(existing.definition, this._definition)) {
+                    this._configured = true;
+                    return { status: { code: 200, detail: 'OK' }, protocol: existing };
+                }
+            }
+            // Not installed or definition has changed — configure the new version.
+            const result = yield this._dwn.protocols.configure({
+                definition: this._definition,
+                encryption: options === null || options === void 0 ? void 0 : options.encryption,
+            });
+            if (result.status.code === 202) {
+                this._configured = true;
+            }
+            return result;
+        });
+    }
+    /**
+     * Whether the protocol has been configured (installed) on the local DWN.
+     *
+     * Returns `true` after a successful call to {@link TypedEnbox.configure | configure()}.
+     * Record operations will throw if this is `false`.
+     */
+    get isConfigured() {
+        return this._configured;
+    }
+    /**
+     * Validates that the path is recognized.
+     * Throws a descriptive error if the path is not a valid protocol path.
+     */
+    _assertValidPath(path) {
+        if (!this._validPaths.has(path)) {
+            throw new Error(`TypedEnbox: invalid protocol path '${path}'. ` +
+                `Valid paths are: ${[...this._validPaths].join(', ')}.`);
+        }
+    }
+    /**
+     * Ensures the protocol is configured before performing record operations.
+     *
+     * On first call, queries for an existing protocol installation:
+     * - If found with an identical definition → marks as configured.
+     * - If found with a different definition → marks as configured but warns
+     *   that the local definition differs from the installed one.
+     * - If not found → installs the protocol via `protocols.configure()`.
+     *
+     * Concurrent calls are deduplicated via a shared Promise so the network
+     * call only happens once.
+     */
+    _ensureReady(path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._configured) {
+                this._assertValidPath(path);
+                return;
+            }
+            if (this._ensureReadyPromise === null) {
+                this._ensureReadyPromise = this._autoConfigureOnce();
+            }
+            yield this._ensureReadyPromise;
+            this._assertValidPath(path);
+        });
+    }
+    /**
+     * Performs the one-time auto-configuration check. Called at most once;
+     * subsequent calls reuse the same Promise via `_ensureReadyPromise`.
+     */
+    _autoConfigureOnce() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { protocols } = yield this._dwn.protocols.query({
+                filter: { protocol: this._definition.protocol },
+            });
+            if (protocols.length > 0) {
+                const existing = protocols[0];
+                if (definitionsEqual(existing.definition, this._definition)) {
+                    this._configured = true;
+                    return;
+                }
+                // Installed but definitions differ — allow operations but warn.
+                console.warn(`TypedEnbox: installed protocol '${this._definition.protocol}' differs from the provided definition. ` +
+                    'Call configure() to update it.');
+                this._configured = true;
+                return;
+            }
+            // Not installed — configure it now.
+            const result = yield this._dwn.protocols.configure({
+                definition: this._definition,
+            });
+            if (result.status.code === 202) {
+                this._configured = true;
+            }
+        });
+    }
+    /**
+     * Protocol-scoped record operations.
+     *
+     * Every method auto-injects the `protocol`, `protocolPath`, and `schema`
+     * from the protocol definition — you never need to specify them manually.
+     * Path parameters provide **compile-time autocompletion** via
+     * `ProtocolPaths<D>`, and data types are resolved from the schema map.
+     *
+     * All methods return {@link TypedRecord} or {@link TypedLiveQuery} instances
+     * that carry the resolved data type from the schema map, providing
+     * end-to-end type safety.
+     *
+     * Available methods:
+     * - {@link TypedEnbox.records.create | create(path, request)} — Create a new record
+     * - {@link TypedEnbox.records.query | query(path, request?)} — Query records with filters
+     * - {@link TypedEnbox.records.read | read(path, request)} — Read a single record
+     * - {@link TypedEnbox.records.delete | delete(path, request)} — Delete a record by ID
+     * - {@link TypedEnbox.records.subscribe | subscribe(path, request?)} — Real-time subscription
+     */
+    get records() {
+        if (this._records !== undefined) {
+            return this._records;
+        }
+        const cached = {
+            /**
+             * Create a new record at the given protocol path.
+             *
+             * The `protocol`, `protocolPath`, and `schema` are auto-injected from
+             * the protocol definition. The `data` field is type-checked against
+             * the schema map for the given path.
+             *
+             * @param path - The protocol path (e.g. `'notebook'`, `'notebook/page'`).
+             *   Provides compile-time autocompletion for valid paths.
+             * @param request - Create options including the typed `data` payload
+             *   and optional fields like `parentContextId`, `tags`, `recipient`.
+             * @returns A {@link TypedCreateResponse} containing the DWN response
+             *   `status` and the created {@link TypedRecord}.
+             *
+             * @example
+             * ```ts
+             * const { status, record } = await proto.records.create('notebook', {
+             *   data: { name: 'My Notebook' },
+             * });
+             *
+             * // Create a child page under the notebook's context
+             * const { record: page } = await proto.records.create('notebook/page', {
+             *   data: { title: 'First Page', body: '' },
+             *   parentContextId: record.contextId,
+             * });
+             * ```
+             */
+            create: (path, request) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                const normalizedPath = normalizePath(path);
+                yield this._ensureReady(normalizedPath);
+                const typeName = lastSegment(normalizedPath);
+                const typeEntry = this._definition.types[typeName];
+                const { status, record } = yield this._dwn.records.write(Object.assign(Object.assign({ data: request.data, store: request.store, encryption: request.encryption, parentContextId: request.parentContextId, published: request.published, datePublished: request.datePublished, recipient: request.recipient, protocolRole: request.protocolRole, tags: request.tags, protocol: this._definition.protocol, protocolPath: normalizedPath }, ((typeEntry === null || typeEntry === void 0 ? void 0 : typeEntry.schema) !== undefined ? { schema: typeEntry.schema } : {})), { dataFormat: (_a = request.dataFormat) !== null && _a !== void 0 ? _a : (_b = typeEntry === null || typeEntry === void 0 ? void 0 : typeEntry.dataFormats) === null || _b === void 0 ? void 0 : _b[0] }));
+                return {
+                    status,
+                    record: record ? new TypedRecord(record) : undefined,
+                };
+            }),
+            /**
+             * Query records at the given protocol path.
+             *
+             * Returns all matching records as an array of typed records, with
+             * an optional pagination cursor for fetching additional pages.
+             *
+             * @param path - The protocol path to query (e.g. `'notebook'`,
+             *   `'notebook/page'`).
+             * @param request - Optional filter, sort, and pagination options.
+             *   Omit entirely to return all records at the path.
+             * @returns A {@link TypedQueryResponse} containing `status`, `records`
+             *   (as {@link TypedRecord | TypedRecord<T>[]}), and an optional
+             *   `cursor` for pagination.
+             *
+             * @example
+             * ```ts
+             * // Query all notebooks
+             * const { records } = await proto.records.query('notebook');
+             *
+             * // Query pages under a specific notebook
+             * const { records: pages } = await proto.records.query('notebook/page', {
+             *   filter: { parentId: notebook.contextId },
+             * });
+             *
+             * for (const page of pages) {
+             *   const data = await page.data.json(); // PageData
+             * }
+             *
+             * // Paginated query
+             * const { records: batch, cursor } = await proto.records.query('notebook', {
+             *   pagination: { limit: 10 },
+             *   dateSort: DateSort.CreatedDescending,
+             * });
+             * ```
+             */
+            query: (path, request) => __awaiter(this, void 0, void 0, function* () {
+                const normalizedPath = normalizePath(path);
+                yield this._ensureReady(normalizedPath);
+                const typeName = lastSegment(normalizedPath);
+                const typeEntry = this._definition.types[typeName];
+                const queryFilter = mapParentContextId(request === null || request === void 0 ? void 0 : request.filter);
+                const { status, records, cursor } = yield this._dwn.records.query({
+                    from: request === null || request === void 0 ? void 0 : request.from,
+                    encryption: request === null || request === void 0 ? void 0 : request.encryption,
+                    filter: Object.assign(Object.assign(Object.assign({}, queryFilter), { protocol: this._definition.protocol, protocolPath: normalizedPath }), ((typeEntry === null || typeEntry === void 0 ? void 0 : typeEntry.schema) !== undefined ? { schema: typeEntry.schema } : {})),
+                    dateSort: request === null || request === void 0 ? void 0 : request.dateSort,
+                    pagination: request === null || request === void 0 ? void 0 : request.pagination,
+                    protocolRole: request === null || request === void 0 ? void 0 : request.protocolRole,
+                });
+                return {
+                    status,
+                    records: records.map((r) => new TypedRecord(r)),
+                    cursor,
+                };
+            }),
+            /**
+             * Read a single record at the given protocol path.
+             *
+             * Unlike `query()`, which returns an array, `read()` returns exactly
+             * one record. Use `filter.recordId` to target a specific record.
+             *
+             * @param path - The protocol path to read from.
+             * @param request - Read options including a `filter` to identify the
+             *   record. See {@link TypedReadRequest} for details.
+             * @returns A {@link TypedReadResponse} containing `status` and the
+             *   matching {@link TypedRecord}.
+             *
+             * @example
+             * ```ts
+             * const { record } = await proto.records.read('notebook', {
+             *   filter: { recordId: notebookId },
+             * });
+             *
+             * const data = await record.data.json(); // NotebookData
+             * console.log(data.name);
+             * ```
+             */
+            read: (path, request) => __awaiter(this, void 0, void 0, function* () {
+                const normalizedPath = normalizePath(path);
+                yield this._ensureReady(normalizedPath);
+                const typeName = lastSegment(normalizedPath);
+                const typeEntry = this._definition.types[typeName];
+                const readFilter = mapParentContextId(request.filter);
+                const { status, record } = yield this._dwn.records.read({
+                    from: request.from,
+                    encryption: request.encryption,
+                    protocol: this._definition.protocol,
+                    filter: Object.assign(Object.assign(Object.assign({}, readFilter), { protocol: this._definition.protocol, protocolPath: normalizedPath }), ((typeEntry === null || typeEntry === void 0 ? void 0 : typeEntry.schema) !== undefined ? { schema: typeEntry.schema } : {})),
+                });
+                return {
+                    status,
+                    record: record ? new TypedRecord(record) : undefined,
+                };
+            }),
+            /**
+             * Delete a record at the given protocol path.
+             *
+             * The path is used for protocol validation and permission scoping,
+             * while the actual record is identified by `recordId`.
+             *
+             * @param path - The protocol path (used for permission scoping and
+             *   path validation).
+             * @param request - Delete options. `recordId` is required; `from` is
+             *   optional for remote deletes.
+             * @returns The DWN response status.
+             *
+             * @example
+             * ```ts
+             * const { status } = await proto.records.delete('notebook', {
+             *   recordId: notebook.id,
+             * });
+             *
+             * if (status.code === 202) {
+             *   console.log('Notebook deleted');
+             * }
+             * ```
+             */
+            delete: (_path, request) => __awaiter(this, void 0, void 0, function* () {
+                yield this._ensureReady(normalizePath(_path));
+                return this._dwn.records.delete({
+                    from: request.from,
+                    protocol: this._definition.protocol,
+                    recordId: request.recordId,
+                });
+            }),
+            /**
+             * Subscribe to real-time changes at the given protocol path.
+             *
+             * Returns a {@link TypedLiveQuery} that atomically provides an initial
+             * snapshot and a real-time stream of deduplicated change events, with
+             * all records typed as `TypedRecord<T>`.
+             *
+             * @param path - The protocol path to subscribe to.
+             * @param request - Optional filter and role. Use `filter.parentId`
+             *   to scope the subscription to children of a specific parent.
+             * @returns A {@link TypedSubscribeResponse} containing `status` and
+             *   a {@link TypedLiveQuery} for receiving events.
+             *
+             * @example
+             * ```ts
+             * const { liveQuery } = await proto.records.subscribe('notebook/page', {
+             *   filter: { parentId: notebook.contextId },
+             * });
+             *
+             * liveQuery.on('create', (record) => {
+             *   // record is TypedRecord<PageData>
+             *   console.log('New page created');
+             * });
+             *
+             * liveQuery.on('update', (record) => {
+             *   const data = await record.data.json(); // PageData
+             * });
+             *
+             * liveQuery.on('delete', (record) => {
+             *   console.log('Page deleted:', record.id);
+             * });
+             *
+             * // Stop listening
+             * liveQuery.close();
+             * ```
+             */
+            subscribe: (path, request) => __awaiter(this, void 0, void 0, function* () {
+                const normalizedPath = normalizePath(path);
+                yield this._ensureReady(normalizedPath);
+                const typeName = lastSegment(normalizedPath);
+                const typeEntry = this._definition.types[typeName];
+                const subFilter = mapParentContextId(request === null || request === void 0 ? void 0 : request.filter);
+                const { status, liveQuery } = yield this._dwn.records.subscribe({
+                    from: request === null || request === void 0 ? void 0 : request.from,
+                    filter: Object.assign(Object.assign(Object.assign({}, subFilter), { protocol: this._definition.protocol, protocolPath: normalizedPath }), ((typeEntry === null || typeEntry === void 0 ? void 0 : typeEntry.schema) !== undefined ? { schema: typeEntry.schema } : {})),
+                    protocolRole: request === null || request === void 0 ? void 0 : request.protocolRole,
+                });
+                return {
+                    status,
+                    liveQuery: liveQuery ? new TypedLiveQuery(liveQuery) : undefined,
+                };
+            }),
+        };
+        this._records = cached;
+        return cached;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Maps the `parentContextId` alias to the underlying `parentId` field
+ * expected by the DWN SDK. If both are provided, `parentId` takes precedence.
+ * Returns a new object (or `undefined` if the input was `undefined`).
+ */
+function mapParentContextId(filter) {
+    if (!filter) {
+        return undefined;
+    }
+    const _a = filter, { parentContextId } = _a, rest = __rest(_a, ["parentContextId"]);
+    if (parentContextId !== undefined && rest.parentId === undefined) {
+        rest.parentId = parentContextId;
+    }
+    return rest;
+}
+/**
+ * Compares two protocol definitions for deep equality using deterministic
+ * JSON serialization.
+ *
+ * Keys are sorted recursively so that semantically identical definitions
+ * with different key ordering are treated as equal.
+ */
+function definitionsEqual(a, b) {
+    return stableStringify(a) === stableStringify(b);
+}
+/**
+ * Strips leading and trailing slashes from a path.
+ *
+ * `'friend/'` → `'friend'`, `'/group/member/'` → `'group/member'`.
+ */
+function normalizePath(path) {
+    return path.replace(/^\/+|\/+$/g, '');
+}
+/**
+ * Returns the last segment of a slash-delimited path.
+ */
+function lastSegment(path) {
+    const parts = path.split('/');
+    return parts[parts.length - 1];
+}
+/**
+ * Recursively collects all valid protocol path strings from a structure object.
+ *
+ * Given `{ foo: { bar: { $actions: [...] } } }`, returns `Set(['foo', 'foo/bar'])`.
+ * Keys starting with `$` are skipped.
+ */
+function collectPaths(structure, prefix = '') {
+    const paths = new Set();
+    for (const key of Object.keys(structure)) {
+        if (key.startsWith('$')) {
+            continue;
+        }
+        const fullPath = prefix ? `${prefix}/${key}` : key;
+        paths.add(fullPath);
+        const child = structure[key];
+        if (child !== null && typeof child === 'object') {
+            for (const nested of collectPaths(child, fullPath)) {
+                paths.add(nested);
+            }
+        }
+    }
+    return paths;
+}
+/**
+ * Deterministic JSON serialization with sorted keys.
+ */
+function stableStringify(value) {
+    if (value === null || value === undefined || typeof value !== 'object') {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return '[' + value.map((item) => stableStringify(item)).join(',') + ']';
+    }
+    const keys = Object.keys(value).sort();
+    const pairs = keys.map((key) => JSON.stringify(key) + ':' + stableStringify(value[key]));
+    return '{' + pairs.join(',') + '}';
+}
+// ---------------------------------------------------------------------------
+// Deprecated alias — migration aid
+// ---------------------------------------------------------------------------
+/** @deprecated Use {@link TypedEnbox} instead. Will be removed in a future version. */
+export const TypedWeb5 = TypedEnbox;
+//# sourceMappingURL=typed-enbox.js.map

package/dist/esm/typed-enbox.js.map

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

package/dist/esm/typed-live-query.js

@@ -45,7 +45,7 @@ import { TypedRecord } from './typed-record.js';
  * A type-safe wrapper around {@link LiveQuery} that preserves the data type `T`
  * through the initial snapshot and all subsequent change events.
  *
- * Obtain instances through `TypedWeb5.records.subscribe()` — never construct
+ * Obtain instances through `TypedEnbox.records.subscribe()` — never construct
  * directly.
  */
 export class TypedLiveQuery {