@thingd/sdk 0.31.0

package/dist/stores/native-thing-store.d.ts

@@ -0,0 +1,53 @@
+import type { ListEventsOptions, ListObjectsOptions, MemoryEvent, MemoryObject, MemorySearchOptions, MemorySearchResult, QueueClaimOptions, QueueJob, QueueJobOptions, QueueJobPayload, QueueJobResult, QueueNackOptions, StoredMemoryEvent, StoredMemoryObject, ThingDeleteResult, ThingStore } from "../types.js";
+export declare class NativeThingStore implements ThingStore {
+    private readonly binding;
+    static open(path: string): Promise<NativeThingStore>;
+    static isAvailable(): Promise<boolean>;
+    static getLoadedPath(): Promise<string | undefined>;
+    private constructor();
+    put(collection: string, object: MemoryObject): Promise<StoredMemoryObject>;
+    get<T = StoredMemoryObject>(collection: string, id: string): Promise<T | null>;
+    delete(collection: string, id: string): Promise<ThingDeleteResult>;
+    listObjects<T = StoredMemoryObject>(collection: string, options?: ListObjectsOptions): Promise<T[]>;
+    appendEvent(stream: string, event: MemoryEvent): Promise<StoredMemoryEvent>;
+    listEvents<T = StoredMemoryEvent>(stream?: string, options?: ListEventsOptions): Promise<T[]>;
+    pushJob(queue: string, payload: QueueJobPayload, options?: QueueJobOptions): Promise<QueueJob>;
+    claimJob(queue: string, options?: QueueClaimOptions): Promise<QueueJob | null>;
+    ackJob(queue: string, jobId: string): Promise<QueueJobResult>;
+    nackJob(queue: string, jobId: string, options?: QueueNackOptions): Promise<QueueJobResult>;
+    listJobs(queue: string): Promise<QueueJob[]>;
+    listDeadJobs(queue: string): Promise<QueueJob[]>;
+    search(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
+    putObjectsBatch(objects: Array<{
+        collection: string;
+        id: string;
+        body: string;
+    }>): Promise<StoredMemoryObject[]>;
+    appendEventsBatch(events: Array<{
+        stream: string;
+        eventType: string;
+        body: string;
+    }>): Promise<StoredMemoryEvent[]>;
+    pushJobsBatch(jobs: Array<{
+        queue: string;
+        id: string;
+        body: string;
+        maxAttempts: number;
+        delayMs: number;
+    }>): Promise<QueueJob[]>;
+    countObjects(): Promise<number>;
+    countEvents(): Promise<number>;
+    countActiveJobs(): Promise<number>;
+    countDeadJobs(): Promise<number>;
+    countLinks(): Promise<number>;
+    putBatch(collection: string, objects: MemoryObject[]): Promise<StoredMemoryObject[]>;
+    deleteBatch(collection: string, ids: string[]): Promise<number>;
+    createLink(fromRef: string, linkType: string, toRef: string, weight?: number, metadataJson?: string): Promise<import("../types.js").Link>;
+    deleteLink(id: string): Promise<boolean>;
+    getLink(id: string): Promise<import("../types.js").Link | null>;
+    getNeighbors(reference: string, direction: import("../types.js").LinkDirection, options: import("../types.js").LinkQueryOptions): Promise<import("../types.js").Link[]>;
+    listCollections(): Promise<string[]>;
+    listStreams(): Promise<string[]>;
+    listQueues(): Promise<string[]>;
+}
+//# sourceMappingURL=native-thing-store.d.ts.map

package/dist/stores/native-thing-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-thing-store.d.ts","sourceRoot":"","sources":["../../src/stores/native-thing-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACX,MAAM,aAAa,CAAC;AAmIrB,qBAAa,gBAAiB,YAAW,UAAU;IAwB7B,OAAO,CAAC,QAAQ,CAAC,OAAO;WAvB/B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;WAK7C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;WAS/B,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IASzD,OAAO;IAED,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ1E,GAAG,CAAC,CAAC,GAAG,kBAAkB,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAM9E,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMlE,WAAW,CAAC,CAAC,GAAG,kBAAkB,EACtC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,CAAC,EAAE,CAAC;IAiBT,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQ3E,UAAU,CAAC,CAAC,GAAG,iBAAiB,EACpC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC;IAMT,OAAO,CACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,QAAQ,CAAC;IAcd,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAMlF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D,OAAO,CACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC;IAUpB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI5C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMhD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgDvF,eAAe,CACnB,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAC/D,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAM1B,iBAAiB,CACrB,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GACjE,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAMzB,aAAa,CACjB,IAAI,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAC7F,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMhB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAIlC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAIhC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOpF,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D,UAAU,CACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,aAAa,EAAE,IAAI,CAAC;IAQhC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAK/D,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,aAAa,EAAE,aAAa,EAC9C,OAAO,EAAE,OAAO,aAAa,EAAE,gBAAgB,GAC9C,OAAO,CAAC,OAAO,aAAa,EAAE,IAAI,EAAE,CAAC;IAMlC,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAGtC"}

package/dist/stores/native-thing-store.js

@@ -0,0 +1,312 @@
+import { randomUUID } from "node:crypto";
+import { createRequire } from "node:module";
+const DEFAULT_LEASE_MS = 30_000;
+const NATIVE_PACKAGE_NAME = "@thingd/native";
+export class NativeThingStore {
+    binding;
+    static async open(path) {
+        const native = await loadNativeModule();
+        return new NativeThingStore(native.NativeThingStore.open(path));
+    }
+    static async isAvailable() {
+        try {
+            await loadNativeModule();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    static async getLoadedPath() {
+        try {
+            const native = await loadNativeModule();
+            return native.loadedPath;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    constructor(binding) {
+        this.binding = binding;
+    }
+    async put(collection, object) {
+        const record = parseJson(this.binding.putObjectJson(collection, object.id, JSON.stringify(object)));
+        return objectFromNative(record);
+    }
+    async get(collection, id) {
+        const record = this.binding.getObjectJson(collection, id);
+        return record ? objectFromNative(parseJson(record)) : null;
+    }
+    async delete(collection, id) {
+        return {
+            deleted: this.binding.deleteObject(collection, id),
+        };
+    }
+    async listObjects(collection, options) {
+        const collectionsJson = JSON.stringify([collection]);
+        const filterJson = options?.filter ? JSON.stringify(options.filter) : undefined;
+        const sortField = options?.sortBy?.field;
+        const sortDirection = options?.sortBy?.direction;
+        return parseJson(this.binding.listObjectsJson(collectionsJson, filterJson, options?.limit, options?.offset, sortField, sortDirection)).map(objectFromNative);
+    }
+    async appendEvent(stream, event) {
+        const record = parseJson(this.binding.appendEventJson(stream, JSON.stringify(event)));
+        return eventFromNative(record);
+    }
+    async listEvents(stream, options) {
+        return parseJson(this.binding.listEventsJson(stream, options?.fromSequence, options?.limit)).map(eventFromNative);
+    }
+    async pushJob(queue, payload, options = {}) {
+        const record = parseJson(this.binding.pushJobJson(queue, options.idempotencyKey ?? randomUUID(), JSON.stringify(payload), options.maxAttempts ?? 3, options.delayMs ?? 0));
+        return jobFromNative(record);
+    }
+    async claimJob(queue, options = {}) {
+        const record = this.binding.claimJobJson(queue, options.leaseMs ?? DEFAULT_LEASE_MS);
+        return record ? jobFromNative(parseJson(record)) : null;
+    }
+    async ackJob(queue, jobId) {
+        return resultFromNative(parseJson(this.binding.ackJobJson(queue, jobId)));
+    }
+    async nackJob(queue, jobId, options = {}) {
+        const result = resultFromNative(parseJson(this.binding.nackJobJson(queue, jobId, options.delayMs ?? 0, options.error)));
+        return result;
+    }
+    async listJobs(queue) {
+        return parseJson(this.binding.listJobsJson(queue)).map(jobFromNative);
+    }
+    async listDeadJobs(queue) {
+        return parseJson(this.binding.listDeadJobsJson(queue)).map(jobFromNative);
+    }
+    async search(query, options = {}) {
+        const collectionsJson = options.collections ? JSON.stringify(options.collections) : undefined;
+        const filterJson = options.filter ? JSON.stringify(options.filter) : undefined;
+        const hits = parseJson(this.binding.searchJson(query, collectionsJson, options.limit, filterJson));
+        return hits.map((hit) => {
+            if (hit.kind === "object") {
+                const objectRecord = {
+                    collection: hit.collection,
+                    id: hit.id,
+                    body: hit.body,
+                    version: hit.version ?? 0,
+                    createdAt: hit.createdAt ?? "",
+                    updatedAt: hit.updatedAt ?? "",
+                };
+                const storedObject = objectFromNative(objectRecord);
+                return {
+                    kind: "object",
+                    id: hit.id,
+                    collection: hit.collection,
+                    score: hit.score,
+                    value: storedObject,
+                };
+            }
+            else {
+                const eventRecord = {
+                    stream: hit.collection,
+                    eventType: hit.eventType ?? "event",
+                    body: hit.body,
+                    sequence: Number(hit.id) || 0,
+                    createdAt: hit.createdAt ?? "",
+                };
+                const storedEvent = eventFromNative(eventRecord);
+                return {
+                    kind: "event",
+                    id: hit.id,
+                    stream: hit.collection,
+                    score: hit.score,
+                    value: storedEvent,
+                };
+            }
+        });
+    }
+    async putObjectsBatch(objects) {
+        return parseJson(this.binding.putObjectsBatchJson(JSON.stringify(objects))).map(objectFromNative);
+    }
+    async appendEventsBatch(events) {
+        return parseJson(this.binding.appendEventsBatchJson(JSON.stringify(events))).map(eventFromNative);
+    }
+    async pushJobsBatch(jobs) {
+        return parseJson(this.binding.pushJobsBatchJson(JSON.stringify(jobs))).map(jobFromNative);
+    }
+    async countObjects() {
+        return this.binding.countObjectsJson();
+    }
+    async countEvents() {
+        return this.binding.countEventsJson();
+    }
+    async countActiveJobs() {
+        return this.binding.countActiveJobsJson();
+    }
+    async countDeadJobs() {
+        return this.binding.countDeadJobsJson();
+    }
+    async countLinks() {
+        return this.binding.countLinksJson();
+    }
+    async putBatch(collection, objects) {
+        const inputs = objects.map((obj) => ({ collection, id: obj.id, body: JSON.stringify(obj) }));
+        return parseJson(this.binding.putObjectsBatchJson(JSON.stringify(inputs))).map(objectFromNative);
+    }
+    async deleteBatch(collection, ids) {
+        const keys = ids.map((id) => [collection, id]);
+        return this.binding.deleteObjectsBatchJson(JSON.stringify(keys));
+    }
+    async createLink(fromRef, linkType, toRef, weight, metadataJson) {
+        return linkFromNative(parseJson(this.binding.createLinkJson(fromRef, linkType, toRef, weight, metadataJson)));
+    }
+    async deleteLink(id) {
+        return this.binding.deleteLink(id);
+    }
+    async getLink(id) {
+        const record = this.binding.getLinkJson(id);
+        return record ? linkFromNative(parseJson(record)) : null;
+    }
+    async getNeighbors(reference, direction, options) {
+        return parseJson(this.binding.getNeighborsJson(reference, direction, options.linkType, options.limit)).map(linkFromNative);
+    }
+    async listCollections() {
+        return parseJson(await this.binding.listCollectionsJson());
+    }
+    async listStreams() {
+        return parseJson(await this.binding.listStreamsJson());
+    }
+    async listQueues() {
+        return parseJson(await this.binding.listQueuesJson());
+    }
+}
+async function loadNativeModule() {
+    const customPath = process.env.THINGD_NATIVE_PATH;
+    if (customPath) {
+        try {
+            const require = createRequire(import.meta.url);
+            const binding = require(customPath);
+            return {
+                NativeThingStore: binding.NativeThingStore,
+                loadedPath: customPath,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to load native store from THINGD_NATIVE_PATH="${customPath}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Try direct import (resolves via node_modules when published, or workspace link locally)
+    try {
+        const mod = (await import(NATIVE_PACKAGE_NAME));
+        return {
+            NativeThingStore: mod.NativeThingStore,
+            loadedPath: mod.loadedPath,
+        };
+    }
+    catch (importError) {
+        // Fallback: scan workspace-relative paths for local development
+        try {
+            const { existsSync } = await import("node:fs");
+            const { join, dirname } = await import("node:path");
+            const { fileURLToPath } = await import("node:url");
+            const __dirname = dirname(fileURLToPath(import.meta.url));
+            const platform = process.platform;
+            const arch = process.arch;
+            const candidates = [
+                // monorepo: packages/thingd/dist/stores/ -> ../../../../thingd-native/
+                join(__dirname, "../../../../thingd-native/dist/thingd_native.node"),
+                join(__dirname, "../../../../thingd-native/prebuilds", `${platform}-${arch}`, "thingd_native.node"),
+                // global install: sibling to thingd-cli in node_modules
+                join(__dirname, "../../../../../../thingd-native/dist/thingd_native.node"),
+                join(__dirname, "../../../../../../thingd-native/prebuilds", `${platform}-${arch}`, "thingd_native.node"),
+            ];
+            for (const candidate of candidates) {
+                if (existsSync(candidate)) {
+                    try {
+                        const require = createRequire(import.meta.url);
+                        const binding = require(candidate);
+                        if (binding?.NativeThingStore) {
+                            return {
+                                NativeThingStore: binding.NativeThingStore,
+                                loadedPath: candidate,
+                            };
+                        }
+                    }
+                    catch {
+                        // candidate failed to load, try next
+                    }
+                }
+            }
+        }
+        catch {
+            // fallback resolution failed
+        }
+        throw new Error(`The native thingd driver is not available. Run "pnpm --filter thingd-native build" before using driver: "native". ${formatUnknownError(importError)}`);
+    }
+}
+function objectFromNative(record) {
+    const value = parseJson(record.body);
+    return {
+        ...value,
+        id: record.id,
+        collection: record.collection,
+        createdAt: record.createdAt ?? new Date().toISOString(),
+        updatedAt: record.updatedAt ?? new Date().toISOString(),
+        version: record.version,
+    };
+}
+function eventFromNative(record) {
+    const value = parseJson(record.body);
+    return {
+        ...value,
+        type: value.type ?? record.eventType,
+        id: String(record.sequence),
+        sequence: record.sequence,
+        stream: record.stream,
+        createdAt: record.createdAt ?? new Date().toISOString(),
+    };
+}
+function jobFromNative(record) {
+    return {
+        id: record.id,
+        queue: record.queue,
+        payload: parseJson(record.body),
+        status: record.status,
+        attempts: record.attempts,
+        maxAttempts: record.maxAttempts,
+        createdAt: record.createdAt ?? new Date().toISOString(),
+        availableAt: timestampToIso(record.availableAtMs),
+        leasedAt: optionalTimestampToIso(record.leasedAtMs),
+        leaseExpiresAt: optionalTimestampToIso(record.leaseExpiresAtMs),
+        completedAt: optionalTimestampToIso(record.completedAtMs),
+        deadAt: optionalTimestampToIso(record.deadAtMs),
+        lastError: record.lastError || undefined,
+    };
+}
+function linkFromNative(record) {
+    return {
+        ...record,
+        createdAt: record.createdAt ?? new Date().toISOString(),
+    };
+}
+function resultFromNative(result) {
+    if (!result.ok) {
+        return result;
+    }
+    return {
+        ok: true,
+        job: jobFromNative(result.job),
+    };
+}
+function parseJson(json) {
+    return JSON.parse(json);
+}
+function timestampToIso(value) {
+    if (value <= 0) {
+        return new Date().toISOString();
+    }
+    return new Date(value).toISOString();
+}
+function optionalTimestampToIso(value) {
+    return value === undefined ? undefined : timestampToIso(value);
+}
+function formatUnknownError(error) {
+    if (error instanceof Error) {
+        return `Original error: ${error.message}`;
+    }
+    return `Original error: ${String(error)}`;
+}

package/dist/stores/remote-thing-store.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryEvent, MemoryObject, MemorySearchOptions, MemorySearchResult, QueueClaimOptions, QueueJob, QueueJobOptions, QueueJobPayload, QueueJobResult, QueueNackOptions, StoredMemoryEvent, StoredMemoryObject, ThingDeleteResult, ThingStore } from "../types.js";
+export type RemoteThingStoreOptions = {
+    url: string;
+    authToken?: string;
+    clientName?: string;
+    clientVersion?: string;
+};
+export declare class RemoteThingStore implements ThingStore {
+    private readonly client;
+    static open(urlOrOptions: string | RemoteThingStoreOptions): Promise<RemoteThingStore>;
+    private constructor();
+    put(collection: string, object: MemoryObject): Promise<StoredMemoryObject>;
+    get(collection: string, id: string): Promise<StoredMemoryObject | null>;
+    delete(collection: string, id: string): Promise<ThingDeleteResult>;
+    appendEvent(stream: string, event: MemoryEvent): Promise<StoredMemoryEvent>;
+    listEvents(stream?: string): Promise<StoredMemoryEvent[]>;
+    pushJob(queue: string, payload: QueueJobPayload, options?: QueueJobOptions): Promise<QueueJob>;
+    claimJob(queue: string, options?: QueueClaimOptions): Promise<QueueJob | null>;
+    ackJob(queue: string, jobId: string): Promise<QueueJobResult>;
+    nackJob(queue: string, jobId: string, options?: QueueNackOptions): Promise<QueueJobResult>;
+    listJobs(queue: string): Promise<QueueJob[]>;
+    listDeadJobs(queue: string): Promise<QueueJob[]>;
+    search(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
+    close(): Promise<void>;
+    private callTool;
+}
+//# sourceMappingURL=remote-thing-store.d.ts.map

package/dist/stores/remote-thing-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-thing-store.d.ts","sourceRoot":"","sources":["../../src/stores/remote-thing-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAiB,YAAW,UAAU;IA2B7B,OAAO,CAAC,QAAQ,CAAC,MAAM;WA1B9B,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0B5F,OAAO;IAEP,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAO1E,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAOvE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOlE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO3E,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAMzD,OAAO,CACL,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,QAAQ,CAAC;IAUpB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAOlF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7D,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAS9F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAM5C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMhD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,QAAQ;CAQvB"}

package/dist/stores/remote-thing-store.js

@@ -0,0 +1,131 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+export class RemoteThingStore {
+    client;
+    static async open(urlOrOptions) {
+        const options = typeof urlOrOptions === "string"
+            ? {
+                url: urlOrOptions,
+            }
+            : urlOrOptions;
+        const client = new Client({
+            name: options.clientName ?? "thingd-node-sdk",
+            version: options.clientVersion ?? "0.1.0",
+        });
+        const transport = new StreamableHTTPClientTransport(new URL(resolveMcpUrl(options.url)), {
+            requestInit: options.authToken
+                ? {
+                    headers: {
+                        Authorization: `Bearer ${options.authToken}`,
+                    },
+                }
+                : undefined,
+        });
+        await client.connect(transport);
+        return new RemoteThingStore(client);
+    }
+    constructor(client) {
+        this.client = client;
+    }
+    put(collection, object) {
+        return this.callTool("thing.put", {
+            collection,
+            object,
+        });
+    }
+    get(collection, id) {
+        return this.callTool("thing.get", {
+            collection,
+            id,
+        });
+    }
+    delete(collection, id) {
+        return this.callTool("thing.delete", {
+            collection,
+            id,
+        });
+    }
+    appendEvent(stream, event) {
+        return this.callTool("thing.events.append", {
+            stream,
+            event,
+        });
+    }
+    listEvents(stream) {
+        return this.callTool("thing.events.list", {
+            stream,
+        });
+    }
+    pushJob(queue, payload, options = {}) {
+        return this.callTool("thing.queue.push", {
+            queue,
+            payload,
+            idempotencyKey: options.idempotencyKey,
+            maxAttempts: options.maxAttempts,
+            delayMs: options.delayMs,
+        });
+    }
+    claimJob(queue, options = {}) {
+        return this.callTool("thing.queue.claim", {
+            queue,
+            leaseMs: options.leaseMs,
+        });
+    }
+    ackJob(queue, jobId) {
+        return this.callTool("thing.queue.ack", {
+            queue,
+            id: jobId,
+        });
+    }
+    nackJob(queue, jobId, options = {}) {
+        return this.callTool("thing.queue.nack", {
+            queue,
+            id: jobId,
+            delayMs: options.delayMs,
+            error: options.error,
+        });
+    }
+    listJobs(queue) {
+        return this.callTool("thing.queue.list", {
+            queue,
+        });
+    }
+    listDeadJobs(queue) {
+        return this.callTool("thing.queue.dead", {
+            queue,
+        });
+    }
+    search(query, options = {}) {
+        return this.callTool("thing.search", {
+            query,
+            collections: options.collections,
+            limit: options.limit,
+        });
+    }
+    async close() {
+        await this.client.close();
+    }
+    async callTool(name, args) {
+        return parseJsonToolResult((await this.client.callTool({
+            name,
+            arguments: args,
+        })));
+    }
+}
+function resolveMcpUrl(value) {
+    const normalized = value.startsWith("thingd://")
+        ? `http://${value.slice("thingd://".length)}`
+        : value;
+    const url = new URL(normalized);
+    if (url.pathname === "" || url.pathname === "/") {
+        url.pathname = "/mcp";
+    }
+    return url.toString();
+}
+function parseJsonToolResult(result) {
+    const text = result.content.find((part) => part.type === "text" && typeof part.text === "string")?.text;
+    if (!text) {
+        throw new Error("thingd remote tool did not return JSON text content");
+    }
+    return JSON.parse(text);
+}

package/dist/thingd.d.ts

@@ -0,0 +1,48 @@
+import type { ListEventsOptions, ListObjectsOptions, MemoryEvent, MemoryObject, MemoryQueue, MemorySearchOptions, MemorySearchResult, StoredMemoryEvent, StoredMemoryObject, ThingDConnection, ThingDeleteResult, ThingStore } from "./types.js";
+export type ThingDDriver = "memory" | "native" | "cloud";
+export type ThingDOpenOptions = {
+    driver?: ThingDDriver;
+    store?: ThingStore;
+    authToken?: string;
+    /** Alias for authToken. If both are set, authToken takes precedence. */
+    apiKey?: string;
+};
+export type ThingDOpenConfig = ThingDOpenOptions & {
+    path?: string;
+    url?: string;
+};
+export declare class ThingD implements ThingDConnection {
+    readonly path: string;
+    private readonly store;
+    static open(pathOrConfig?: string | ThingDOpenConfig, options?: ThingDOpenOptions): Promise<ThingD>;
+    private constructor();
+    put(collection: string, object: MemoryObject): Promise<StoredMemoryObject>;
+    get<T = StoredMemoryObject>(collection: string, id: string): Promise<T | null>;
+    delete(collection: string, id: string): Promise<ThingDeleteResult>;
+    listObjects<T = StoredMemoryObject>(collection: string, options?: ListObjectsOptions): Promise<T[]>;
+    search(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
+    searchObjects<T = StoredMemoryObject>(query: string, options?: MemorySearchOptions): Promise<T[]>;
+    putBatch(collection: string, objects: MemoryObject[]): Promise<StoredMemoryObject[]>;
+    deleteBatch(collection: string, ids: string[]): Promise<number>;
+    readonly events: {
+        append: (stream: string, event: MemoryEvent) => Promise<StoredMemoryEvent>;
+        list: <T = StoredMemoryEvent>(stream?: string, options?: ListEventsOptions) => Promise<T[]>;
+    };
+    queue(name: string): MemoryQueue;
+    readonly links: {
+        create: (fromRef: string, linkType: string, toRef: string, weight?: number, metadataJson?: string) => Promise<import("./types.js").Link>;
+        delete: (id: string) => Promise<boolean>;
+        get: (id: string) => Promise<import("./types.js").Link | null>;
+        neighbors: (reference: string, direction?: import("./types.js").LinkDirection, options?: import("./types.js").LinkQueryOptions) => Promise<import("./types.js").Link[]>;
+    };
+    close(): Promise<void>;
+    countObjects(): Promise<number>;
+    countEvents(): Promise<number>;
+    countActiveJobs(): Promise<number>;
+    countDeadJobs(): Promise<number>;
+    countLinks(): Promise<number>;
+    listCollections(): Promise<string[]>;
+    listStreams(): Promise<string[]>;
+    listQueues(): Promise<string[]>;
+}
+//# sourceMappingURL=thingd.d.ts.map

package/dist/thingd.d.ts.map

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