@medicine-wheel/client 0.14.0

package/README.md

@@ -0,0 +1,17 @@
+# @medicine-wheel/client
+
+The door to a Medicine Wheel over HTTP: nodes, edges, ceremonies, beats and the ceremonial diary, typed against `@medicine-wheel/ontology-core`, with the wheel's paging honesty (`count`, `total`, `matched`, `truncated`) carried through and fail-fast errors that name the status.
+
+```ts
+import { createMedicineWheelClient, wheelUrlFromEnv } from '@medicine-wheel/client';
+
+const wheel = createMedicineWheelClient(wheelUrlFromEnv() ?? 'http://127.0.0.1:8040');
+const page = await wheel.ceremonies.list({ episode_path: '2026-09-17-episode-349-…', limit: 'all' });
+const opened = await wheel.ceremonies.create({ type: 'talking_circle', direction: 'east', participants: [], medicines_used: [], intentions: ['…'], circle_id: 'circle:…' });
+const turn = await wheel.beats.create({ direction: 'east', title: 'Guillaume speaks', description: '…', ceremonies: [opened.id], speaker: 'node:human:…' });
+await wheel.beats.witness(turn.id, { witnesses: ['node:human:…'] });
+```
+
+No retry: an unreachable wheel throws `MedicineWheelClientError` with status 502; a refusal carries the wheel's status and body. `limit: 'all'` asks for the whole store.
+
+Extracted in 0.14.0 from the MCP's `http-store.ts` and Miadi's `lib/chronicle-wheel.ts` (jgwill/Miadi#647). Spec: `rispecs/client.spec.md`.

package/dist/index.d.ts

@@ -0,0 +1,190 @@
+/**
+ * @medicine-wheel/client — the door to a wheel over HTTP.
+ *
+ * Until 0.14.0 no package in the suite could reach a wheel over HTTP
+ * (`rispecs/client.spec.md`, measured 2026-09-08); the one working client was
+ * sealed inside the MCP server and every consumer (Miadi, gmtermux,
+ * forgewright) hand-rolled its own. This package is that door, extracted from
+ * the MCP's `http-store.ts` and from Miadi's `lib/chronicle-wheel.ts` seed.
+ *
+ * Three commitments, each answering one open question of the spec:
+ * 1. It sits BESIDE `storage-provider`, it does not wrap it. A consumer on the
+ *    same host as the store may read the provider; a consumer on another host
+ *    reads this.
+ * 2. It carries the paging honesty the routes gained in 0.9–0.11: every list
+ *    returns `count`, `total` (when the wheel reports it) and `truncated`, so a
+ *    caller can tell a page from an answer. `limit: 'all'` asks for the whole
+ *    store, always.
+ * 3. It fails fast and lets the caller decide. No retry. An unreachable wheel
+ *    is an error with status 502; a refusal carries the wheel's status and body.
+ */
+import type { CeremonyLog, CeremonyType, DirectionName, NarrativeBeat, NodeType, RelationalEdge, RelationalNode } from '@medicine-wheel/ontology-core';
+import type { DiaryEntryRecord } from '@medicine-wheel/storage-provider';
+export type { CeremonyLog, CeremonyType, DirectionName, NarrativeBeat, NodeType, RelationalEdge, RelationalNode, DiaryEntryRecord };
+export declare class MedicineWheelClientError extends Error {
+    /** 502 when the wheel could not be reached or refused; 503 when no URL was configured; else the wheel's own status. */
+    readonly status: number;
+    readonly url: string;
+    /** The wheel's response body when it refused, truncated. */
+    readonly body?: string | undefined;
+    constructor(message: string, 
+    /** 502 when the wheel could not be reached or refused; 503 when no URL was configured; else the wheel's own status. */
+    status: number, url: string, 
+    /** The wheel's response body when it refused, truncated. */
+    body?: string | undefined);
+}
+export type Limit = number | 'all';
+/** The honesty contract: a caller must be able to tell a page from an answer. */
+export interface Paged<T> {
+    items: T[];
+    /** Items in this page. */
+    count: number;
+    /** The whole collection, when the wheel reports it. */
+    total?: number;
+    /** What the filters selected before paging, when the wheel reports it. */
+    matched?: number;
+    /** True when `count < matched` (or `< total` unfiltered). */
+    truncated: boolean;
+    provider?: string;
+}
+export interface ListNodesOptions {
+    type?: NodeType;
+    direction?: DirectionName;
+    /** The wheel's `kind` metadata query (e.g. `chronicle_episode`). */
+    kind?: string;
+    limit?: Limit;
+}
+export interface NewNode {
+    id?: string;
+    name: string;
+    type: NodeType;
+    direction?: DirectionName;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface NodePatch {
+    name?: string;
+    type?: NodeType;
+    description?: string;
+    direction?: DirectionName | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ListEdgesOptions {
+    from?: string;
+    to?: string;
+    limit?: Limit;
+}
+export interface NewEdge {
+    from_id: string;
+    to_id: string;
+    relationship_type: string;
+    strength?: number;
+    ceremony_honored?: boolean;
+    obligations?: string[];
+}
+export interface ListCeremoniesOptions {
+    direction?: DirectionName;
+    type?: CeremonyType;
+    episode_path?: string;
+    circle_id?: string;
+    /** The opening id: answers "which record closes this ceremony". */
+    closes?: string;
+    limit?: Limit;
+}
+/** The wheel mints the id and stamps `timestamp` unless one is given. */
+export type NewCeremony = Omit<CeremonyLog, 'id' | 'timestamp'> & {
+    id?: string;
+    timestamp?: string;
+};
+export interface ListBeatsOptions {
+    direction?: DirectionName;
+    /** Only beats that name this ceremony in `ceremonies[]`. Filtered client-side: the beats door has no query. */
+    ceremony?: string;
+    limit?: Limit;
+}
+export type NewBeat = Omit<NarrativeBeat, 'id' | 'timestamp' | 'act' | 'ceremonies' | 'learnings' | 'relations_honored'> & {
+    id?: string;
+    timestamp?: string;
+    act?: number;
+    ceremonies?: string[];
+    learnings?: string[];
+    relations_honored?: string[];
+};
+export interface ListDiaryOptions {
+    participant?: string;
+    phase?: DiaryEntryRecord['phase'];
+    entryType?: DiaryEntryRecord['entryType'];
+    chronicle?: string;
+    ceremony_id?: string;
+    tags?: string[];
+    limit?: Limit;
+}
+export type NewDiaryEntry = Omit<DiaryEntryRecord, 'id' | 'timestamp' | 'metadata'> & {
+    id?: string;
+    timestamp?: string;
+    metadata?: DiaryEntryRecord['metadata'];
+    ceremony_id?: string;
+};
+export interface ClientOptions {
+    baseUrl: string;
+    /** Defaults to the global fetch. Inject one in tests. */
+    fetch?: typeof fetch;
+    /** Per-request timeout. Default 10 000 ms. */
+    timeoutMs?: number;
+    /** Extra headers on every request (an Authorization header, for a wheel that asks for one). */
+    headers?: Record<string, string>;
+}
+export interface MedicineWheelClient {
+    readonly baseUrl: string;
+    health(): Promise<{
+        ok: boolean;
+        status: number;
+    }>;
+    nodes: {
+        list(opts?: ListNodesOptions): Promise<Paged<RelationalNode>>;
+        get(id: string): Promise<RelationalNode | null>;
+        create(input: NewNode): Promise<RelationalNode>;
+        patch(id: string, patch: NodePatch): Promise<RelationalNode>;
+    };
+    edges: {
+        list(opts?: ListEdgesOptions): Promise<Paged<RelationalEdge>>;
+        create(input: NewEdge): Promise<RelationalEdge>;
+        remove(from_id: string, to_id: string): Promise<void>;
+    };
+    ceremonies: {
+        list(opts?: ListCeremoniesOptions): Promise<Paged<CeremonyLog>>;
+        get(id: string): Promise<CeremonyLog | null>;
+        create(input: NewCeremony): Promise<CeremonyLog>;
+    };
+    beats: {
+        list(opts?: ListBeatsOptions): Promise<Paged<NarrativeBeat>>;
+        get(id: string): Promise<NarrativeBeat | null>;
+        create(input: NewBeat): Promise<NarrativeBeat & {
+            warnings?: string[];
+        }>;
+        /** Add witnesses (a set) and, when given, name the speaker. */
+        witness(id: string, patch: {
+            witnesses?: string[];
+            speaker?: string;
+        }): Promise<NarrativeBeat>;
+    };
+    diary: {
+        list(opts?: ListDiaryOptions): Promise<Paged<DiaryEntryRecord>>;
+        get(id: string): Promise<DiaryEntryRecord | null>;
+        create(input: NewDiaryEntry): Promise<DiaryEntryRecord>;
+        remove(id: string): Promise<void>;
+    };
+}
+/** Build a client for one wheel. Throws (503) when the URL is empty. */
+export declare function createMedicineWheelClient(options: ClientOptions | string): MedicineWheelClient;
+/** The episode a ceremony is bound to: the typed field first (0.14.0), then the legacy JSON string in `research_context`. */
+export declare function episodeOf(ceremony: Pick<CeremonyLog, 'episode_path' | 'episode_number' | 'source' | 'research_context'>): {
+    episode_path: string;
+    episode_number?: number;
+    source?: string;
+} | null;
+/** The opening a closing closes: the typed field first (0.14.0), then the MCP's convention of naming it in `research_context`. */
+export declare function closingOf(ceremony: Pick<CeremonyLog, 'type' | 'closes' | 'research_context'>): string | null;
+/** Read the wheel URL the way every Miadi tool does: `MIADI_CHRONICLE_MW_URL` first, then `MW_API_URL`. */
+export declare function wheelUrlFromEnv(env?: Record<string, string | undefined>): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,313 @@
+/**
+ * @medicine-wheel/client — the door to a wheel over HTTP.
+ *
+ * Until 0.14.0 no package in the suite could reach a wheel over HTTP
+ * (`rispecs/client.spec.md`, measured 2026-09-08); the one working client was
+ * sealed inside the MCP server and every consumer (Miadi, gmtermux,
+ * forgewright) hand-rolled its own. This package is that door, extracted from
+ * the MCP's `http-store.ts` and from Miadi's `lib/chronicle-wheel.ts` seed.
+ *
+ * Three commitments, each answering one open question of the spec:
+ * 1. It sits BESIDE `storage-provider`, it does not wrap it. A consumer on the
+ *    same host as the store may read the provider; a consumer on another host
+ *    reads this.
+ * 2. It carries the paging honesty the routes gained in 0.9–0.11: every list
+ *    returns `count`, `total` (when the wheel reports it) and `truncated`, so a
+ *    caller can tell a page from an answer. `limit: 'all'` asks for the whole
+ *    store, always.
+ * 3. It fails fast and lets the caller decide. No retry. An unreachable wheel
+ *    is an error with status 502; a refusal carries the wheel's status and body.
+ */
+// ── errors ──────────────────────────────────────────────────────────────────
+export class MedicineWheelClientError extends Error {
+    status;
+    url;
+    body;
+    constructor(message, 
+    /** 502 when the wheel could not be reached or refused; 503 when no URL was configured; else the wheel's own status. */
+    status, url, 
+    /** The wheel's response body when it refused, truncated. */
+    body) {
+        super(message);
+        this.status = status;
+        this.url = url;
+        this.body = body;
+        this.name = 'MedicineWheelClientError';
+    }
+}
+function trimBase(url) {
+    return url.trim().replace(/\/+$/, '');
+}
+function limitParam(limit) {
+    if (limit === undefined)
+        return undefined;
+    return limit === 'all' ? 'all' : String(limit);
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function pageFrom(body, key) {
+    if (Array.isArray(body)) {
+        return { items: body, count: body.length, truncated: false };
+    }
+    const record = (body ?? {});
+    const items = Array.isArray(record[key]) ? record[key] : [];
+    const total = num(record.total);
+    const matched = num(record.matched);
+    const truncated = typeof record.truncated === 'boolean'
+        ? record.truncated
+        : matched !== undefined
+            ? items.length < matched
+            : total !== undefined
+                ? items.length < total
+                : false;
+    return {
+        items,
+        count: items.length,
+        ...(total !== undefined ? { total } : {}),
+        ...(matched !== undefined ? { matched } : {}),
+        truncated,
+        ...(typeof record.provider === 'string' ? { provider: record.provider } : {}),
+    };
+}
+/** Build a client for one wheel. Throws (503) when the URL is empty. */
+export function createMedicineWheelClient(options) {
+    const opts = typeof options === 'string' ? { baseUrl: options } : options;
+    const base = trimBase(opts.baseUrl ?? '');
+    if (!base) {
+        throw new MedicineWheelClientError('No wheel URL configured', 503, '');
+    }
+    const doFetch = opts.fetch ?? globalThis.fetch;
+    if (typeof doFetch !== 'function') {
+        throw new MedicineWheelClientError('No fetch available in this runtime', 503, base);
+    }
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    async function call(path, init) {
+        const url = `${base}${path}`;
+        const headers = { ...(opts.headers ?? {}) };
+        if (init?.body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        try {
+            return await doFetch(url, {
+                ...init,
+                headers: { ...headers, ...(init?.headers ?? {}) },
+                cache: 'no-store',
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new MedicineWheelClientError(`wheel unreachable: ${reason}`, 502, url);
+        }
+    }
+    async function refused(res, what) {
+        let body = '';
+        try {
+            body = (await res.text()).slice(0, 500);
+        }
+        catch {
+            /* the status is enough */
+        }
+        throw new MedicineWheelClientError(`wheel ${what} (${res.status})`, res.status >= 500 ? 502 : res.status, res.url, body);
+    }
+    async function json(res, what) {
+        if (!res.ok)
+            return refused(res, what);
+        return (await res.json());
+    }
+    function query(params) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(params))
+            if (v !== undefined && v !== '')
+                qs.set(k, v);
+        const s = qs.toString();
+        return s ? `?${s}` : '';
+    }
+    async function getOrNull(path, key, what) {
+        const res = await call(path);
+        if (res.status === 404)
+            return null;
+        const body = await json(res, what);
+        return (body && typeof body === 'object' && key in body ? body[key] : body) ?? null;
+    }
+    return {
+        baseUrl: base,
+        async health() {
+            try {
+                const res = await call('/api/health');
+                return { ok: res.ok, status: res.status };
+            }
+            catch (err) {
+                return { ok: false, status: err instanceof MedicineWheelClientError ? err.status : 502 };
+            }
+        },
+        nodes: {
+            async list(o = {}) {
+                const res = await call(`/api/nodes${query({ type: o.type, direction: o.direction, kind: o.kind, limit: limitParam(o.limit) })}`);
+                return pageFrom(await json(res, 'refused the node list'), 'nodes');
+            },
+            async get(id) {
+                return getOrNull(`/api/nodes/${encodeURIComponent(id)}`, 'node', 'refused the node read');
+            },
+            async create(input) {
+                const res = await call('/api/nodes', { method: 'POST', body: JSON.stringify(input) });
+                const body = await json(res, 'refused the node');
+                if (!body?.node?.id)
+                    throw new MedicineWheelClientError('wheel returned no node', 502, res.url);
+                return body.node;
+            },
+            async patch(id, patch) {
+                const res = await call(`/api/nodes/${encodeURIComponent(id)}`, { method: 'PATCH', body: JSON.stringify(patch) });
+                const body = await json(res, 'refused the node patch');
+                if (!body?.node?.id)
+                    throw new MedicineWheelClientError('wheel returned no node', 502, res.url);
+                return body.node;
+            },
+        },
+        edges: {
+            async list(o = {}) {
+                const res = await call(`/api/edges${query({ from: o.from, to: o.to, limit: limitParam(o.limit) })}`);
+                return pageFrom(await json(res, 'refused the edge list'), 'edges');
+            },
+            async create(input) {
+                const res = await call('/api/edges', { method: 'POST', body: JSON.stringify(input) });
+                const body = await json(res, 'refused the edge');
+                if (!body?.edge)
+                    throw new MedicineWheelClientError('wheel returned no edge', 502, res.url);
+                return body.edge;
+            },
+            async remove(from_id, to_id) {
+                const res = await call(`/api/edges${query({ from: from_id, to: to_id })}`, { method: 'DELETE' });
+                if (!res.ok && res.status !== 404)
+                    await refused(res, 'refused the edge removal');
+            },
+        },
+        ceremonies: {
+            async list(o = {}) {
+                const res = await call(`/api/ceremonies${query({ direction: o.direction, type: o.type, episode_path: o.episode_path, circle_id: o.circle_id, closes: o.closes, limit: limitParam(o.limit) })}`);
+                return pageFrom(await json(res, 'refused the ceremony list'), 'ceremonies');
+            },
+            async get(id) {
+                return getOrNull(`/api/ceremonies/${encodeURIComponent(id)}`, 'ceremony', 'refused the ceremony read');
+            },
+            async create(input) {
+                const res = await call('/api/ceremonies', { method: 'POST', body: JSON.stringify(input) });
+                const body = await json(res, 'refused the ceremony');
+                if (!body?.ceremony?.id)
+                    throw new MedicineWheelClientError('wheel returned no ceremony', 502, res.url);
+                return body.ceremony;
+            },
+        },
+        beats: {
+            async list(o = {}) {
+                // The beats door returns the whole collection as a bare array and takes no query.
+                const res = await call('/api/narrative/beats');
+                const all = pageFrom(await json(res, 'refused the beat list'), 'beats');
+                let items = all.items;
+                if (o.direction)
+                    items = items.filter((b) => b.direction === o.direction);
+                if (o.ceremony)
+                    items = items.filter((b) => Array.isArray(b.ceremonies) && b.ceremonies.includes(o.ceremony));
+                const matched = items.length;
+                if (typeof o.limit === 'number' && items.length > o.limit)
+                    items = items.slice(0, o.limit);
+                return { items, count: items.length, total: all.items.length, matched, truncated: items.length < matched, ...(all.provider ? { provider: all.provider } : {}) };
+            },
+            async get(id) {
+                const res = await call(`/api/narrative/beats/${encodeURIComponent(id)}`);
+                if (res.status === 404)
+                    return null;
+                return json(res, 'refused the beat read');
+            },
+            async create(input) {
+                const res = await call('/api/narrative/beats', { method: 'POST', body: JSON.stringify(input) });
+                const beat = await json(res, 'refused the beat');
+                if (!beat?.id)
+                    throw new MedicineWheelClientError('wheel returned no beat', 502, res.url);
+                return beat;
+            },
+            async witness(id, patch) {
+                const res = await call(`/api/narrative/beats/${encodeURIComponent(id)}`, { method: 'PATCH', body: JSON.stringify(patch) });
+                const beat = await json(res, 'refused the witnessing');
+                if (!beat?.id)
+                    throw new MedicineWheelClientError('wheel returned no beat', 502, res.url);
+                return beat;
+            },
+        },
+        diary: {
+            async list(o = {}) {
+                const params = {
+                    participant: o.participant,
+                    phase: o.phase,
+                    entryType: o.entryType,
+                    chronicle: o.chronicle,
+                    ceremony_id: o.ceremony_id,
+                    limit: limitParam(o.limit),
+                };
+                let q = query(params);
+                for (const tag of o.tags ?? [])
+                    q += `${q ? '&' : '?'}tag=${encodeURIComponent(tag)}`;
+                const res = await call(`/api/diary${q}`);
+                return pageFrom(await json(res, 'refused the diary list'), 'entries');
+            },
+            async get(id) {
+                return getOrNull(`/api/diary/${encodeURIComponent(id)}`, 'entry', 'refused the diary read');
+            },
+            async create(input) {
+                const res = await call('/api/diary', { method: 'POST', body: JSON.stringify(input) });
+                const body = await json(res, 'refused the diary entry');
+                if (!body?.entry?.id)
+                    throw new MedicineWheelClientError('wheel returned no entry', 502, res.url);
+                return body.entry;
+            },
+            async remove(id) {
+                const res = await call(`/api/diary/${encodeURIComponent(id)}`, { method: 'DELETE' });
+                if (!res.ok && res.status !== 404)
+                    await refused(res, 'refused the diary removal');
+            },
+        },
+    };
+}
+// ── readers every consumer needs ────────────────────────────────────────────
+/** The episode a ceremony is bound to: the typed field first (0.14.0), then the legacy JSON string in `research_context`. */
+export function episodeOf(ceremony) {
+    if (typeof ceremony.episode_path === 'string' && ceremony.episode_path) {
+        return {
+            episode_path: ceremony.episode_path,
+            ...(typeof ceremony.episode_number === 'number' ? { episode_number: ceremony.episode_number } : {}),
+            ...(typeof ceremony.source === 'string' ? { source: ceremony.source } : {}),
+        };
+    }
+    if (typeof ceremony.research_context !== 'string')
+        return null;
+    try {
+        const parsed = JSON.parse(ceremony.research_context);
+        const path = parsed?.episode_path ?? parsed?.episodePath;
+        if (typeof path !== 'string' || !path)
+            return null;
+        return {
+            episode_path: path,
+            ...(typeof parsed?.episode_number === 'number' ? { episode_number: parsed.episode_number } : {}),
+            ...(typeof parsed?.source === 'string' ? { source: parsed.source } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** The opening a closing closes: the typed field first (0.14.0), then the MCP's convention of naming it in `research_context`. */
+export function closingOf(ceremony) {
+    if (ceremony.type !== 'closing')
+        return null;
+    if (typeof ceremony.closes === 'string' && ceremony.closes)
+        return ceremony.closes;
+    const rc = ceremony.research_context;
+    return typeof rc === 'string' && /^ceremony:\d+:[a-z0-9]+$/.test(rc.trim()) ? rc.trim() : null;
+}
+/** Read the wheel URL the way every Miadi tool does: `MIADI_CHRONICLE_MW_URL` first, then `MW_API_URL`. */
+export function wheelUrlFromEnv(env = process.env) {
+    const raw = env.MIADI_CHRONICLE_MW_URL ?? env.MW_API_URL ?? '';
+    const trimmed = trimBase(raw);
+    return trimmed || null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@medicine-wheel/client",
+  "version": "0.14.0",
+  "type": "module",
+  "description": "Typed HTTP client for a Medicine Wheel — nodes, edges, ceremonies, beats and the ceremonial diary — with the wheel's paging honesty carried through (count, total, truncated) and fail-fast errors that name the status.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "client",
+    "http",
+    "ceremony",
+    "talking-circle",
+    "relational-accountability"
+  ],
+  "author": "IAIP Collaborative - Shawinigan, QC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jgwill/medicine-wheel.git",
+    "directory": "src/client"
+  },
+  "dependencies": {
+    "@medicine-wheel/ontology-core": "^0.14.0",
+    "@medicine-wheel/storage-provider": "^0.14.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}