@thingd/sdk 0.72.0 → 0.74.2

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

@@ -0,0 +1,62 @@
+import type { AggregateOptions, AggregateResult, CollectionSchema, ListEventsOptions, ListObjectsOptions, MemoryEvent, MemoryObject, MemorySearchOptions, MemorySearchResult, PutOptions, QueueClaimOptions, QueueJob, QueueJobOptions, QueueJobPayload, QueueJobResult, QueueNackOptions, SchemaOptions, StoredMemoryEvent, StoredMemoryObject, ThingDeleteResult, ThingStore, TimeSeriesOptions, TimeSeriesResult, VectorSearchHit, VectorSearchOptions } 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();
+    close(): Promise<void>;
+    put(collection: string, object: MemoryObject, options?: PutOptions): Promise<StoredMemoryObject>;
+    get<T = StoredMemoryObject>(collection: string, id: string): Promise<T | null>;
+    getBatch<T = StoredMemoryObject>(collection: string, ids: 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[]>;
+    vectorSearch(collection: string, queryVector: number[], options?: VectorSearchOptions): Promise<VectorSearchHit[]>;
+    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>;
+    countObjectsInCollection(collection: string): 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[]>;
+    createIndex(collection: string, field: string): Promise<void>;
+    listIndexes(): Promise<Array<[string, string]>>;
+    aggregate(collection: string, options: AggregateOptions): Promise<AggregateResult>;
+    timeseries(collection: string, options: TimeSeriesOptions): Promise<TimeSeriesResult>;
+    schema(collection?: string, options?: SchemaOptions): Promise<CollectionSchema[]>;
+}
+//# 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":"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"}

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

@@ -0,0 +1,374 @@
+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 close() {
+        this.binding.close();
+    }
+    async put(collection, object, options) {
+        const record = parseJson(this.binding.putObjectJson(collection, object.id, JSON.stringify(object), options?.expectedVersion));
+        return objectFromNative(record);
+    }
+    async get(collection, id) {
+        const record = this.binding.getObjectJson(collection, id);
+        return record ? objectFromNative(parseJson(record)) : null;
+    }
+    async getBatch(collection, ids) {
+        return parseJson(this.binding.getObjectsBatchJson(collection, ids)).map((record) => (record ? objectFromNative(record) : null));
+    }
+    async delete(collection, id) {
+        return {
+            deleted: this.binding.deleteObject(collection, id),
+        };
+    }
+    async listObjects(collection, options) {
+        const collectionsJson = JSON.stringify([collection]);
+        const filterJson = serializeFilter(options?.filter);
+        const sortField = options?.sortBy?.field;
+        const sortDirection = options?.sortBy?.direction;
+        return parseJson(await 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, options?.since)).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, options.priority));
+        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 vectorSearch(collection, queryVector, options = {}) {
+        const filterJson = serializeFilter(options.filter);
+        const hits = parseJson(this.binding.vectorSearchJson(collection, JSON.stringify(queryVector), options.topK, filterJson));
+        return hits.map((hit) => {
+            const value = parseJson(hit.value.body);
+            const storedObject = {
+                ...value,
+                id: hit.value.key.id,
+                collection: hit.value.key.collection,
+                createdAt: hit.value.createdAt,
+                updatedAt: hit.value.updatedAt,
+                version: hit.value.version,
+            };
+            if (hit.value.vector) {
+                storedObject.vector = hit.value.vector;
+            }
+            return { id: hit.id, score: hit.score, value: storedObject };
+        });
+    }
+    async search(query, options = {}) {
+        const collectionsJson = options.collections ? JSON.stringify(options.collections) : undefined;
+        const filterJson = serializeFilter(options.filter);
+        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 countObjectsInCollection(collection) {
+        return this.binding.countObjectsInCollectionJson(collection);
+    }
+    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 createIndex(collection, field) {
+        this.binding.createIndexJson(collection, field);
+    }
+    async listIndexes() {
+        return parseJson(this.binding.listIndexesJson());
+    }
+    async aggregate(collection, options) {
+        const filterJson = serializeFilter(options.filter);
+        return parseJson(this.binding.aggregateJson(collection, options.function, options.field, options.groupBy, filterJson));
+    }
+    async timeseries(collection, options) {
+        const filterJson = serializeFilter(options.filter);
+        return parseJson(this.binding.timeseriesJson(collection, options.function, options.field, options.bucket, options.from, options.to, filterJson));
+    }
+    async schema(collection, options) {
+        const sampleSize = options?.sampleSize ?? 50;
+        return parseJson(this.binding.schemaJson(collection, sampleSize));
+    }
+}
+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. Install @thingd/native with "npm install @thingd/native" or set THINGD_NATIVE_PATH. For monorepo development: "pnpm --filter thingd-native build". ${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,
+        priority: record.priority ?? 0,
+    };
+}
+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)}`;
+}
+function serializeFilter(filter) {
+    if (!filter) {
+        return undefined;
+    }
+    const cleaned = {};
+    for (const [key, value] of Object.entries(filter)) {
+        if (value !== undefined) {
+            cleaned[key] = value;
+        }
+    }
+    if (Object.keys(cleaned).length === 0) {
+        return undefined;
+    }
+    return JSON.stringify(cleaned);
+}

package/dist/thingd.d.ts

@@ -0,0 +1,84 @@
+import type { AggregateOptions, AggregateResult, CollectionSchema, ConnectorAuth, ConnectorSchema, ConnectorSyncOptions, ConnectorSyncResult, ListEventsOptions, ListObjectsOptions, LocalThingDConnection, MemoryEvent, MemoryObject, MemoryQueue, MemorySearchOptions, MemorySearchResult, NlqOptions, NlqResult, PutOptions, SchedulerFacade, SchemaOptions, StoredMemoryEvent, StoredMemoryObject, ThingDeleteResult, ThingStore, TimeSeriesOptions, TimeSeriesResult, VectorSearchHit, VectorSearchOptions } 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;
+    /** Cloud instance slug for multi-instance routing. Passed as X-Instance-Slug header. */
+    instanceSlug?: string;
+};
+export type ThingDOpenConfig = ThingDOpenOptions & {
+    path?: string;
+    url?: string;
+};
+export declare class ThingD implements LocalThingDConnection {
+    readonly path: string;
+    private readonly store;
+    static open(pathOrConfig?: string | ThingDOpenConfig, options?: ThingDOpenOptions): Promise<ThingD>;
+    readonly scheduler: SchedulerFacade;
+    private constructor();
+    put(collection: string, object: MemoryObject, options?: PutOptions): 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[]>;
+    vectorSearch(collection: string, queryVector: number[], options?: VectorSearchOptions): Promise<VectorSearchHit[]>;
+    putBatch(collection: string, objects: MemoryObject[]): Promise<StoredMemoryObject[]>;
+    deleteBatch(collection: string, ids: string[]): Promise<number>;
+    getBatch<T = StoredMemoryObject>(collection: string, ids: string[]): Promise<(T | null)[]>;
+    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[]>;
+    };
+    readonly aggregate: {
+        count: (collection: string, options?: Omit<AggregateOptions, "function">) => Promise<AggregateResult>;
+        sum: (collection: string, field: string, options?: Omit<AggregateOptions, "function" | "field">) => Promise<AggregateResult>;
+        avg: (collection: string, field: string, options?: Omit<AggregateOptions, "function" | "field">) => Promise<AggregateResult>;
+        min: (collection: string, field: string, options?: Omit<AggregateOptions, "function" | "field">) => Promise<AggregateResult>;
+        max: (collection: string, field: string, options?: Omit<AggregateOptions, "function" | "field">) => Promise<AggregateResult>;
+    };
+    timeseries(collection: string, options: TimeSeriesOptions): Promise<TimeSeriesResult>;
+    schema(collection?: string, options?: SchemaOptions): Promise<CollectionSchema[]>;
+    readonly nlq: {
+        query: (question: string, options?: NlqOptions) => Promise<NlqResult>;
+    };
+    close(): Promise<void>;
+    backupTo(path: string): void;
+    walCheckpoint(): import("./types.js").WalCheckpointResult;
+    countObjects(): Promise<number>;
+    countObjectsInCollection(collection: string): Promise<number>;
+    countEvents(): Promise<number>;
+    countActiveJobs(): Promise<number>;
+    countDeadJobs(): Promise<number>;
+    countLinks(): Promise<number>;
+    listCollections(): Promise<string[]>;
+    listStreams(): Promise<string[]>;
+    listQueues(): Promise<string[]>;
+    /** Create a functional index on a JSON body field for a collection. */
+    createIndex(collection: string, field: string): Promise<void>;
+    /** List all custom functional indexes. */
+    listIndexes(): Promise<Array<[string, string]>>;
+    /** List available connector types. Requires sidecar/HTTP store (returns [] for in-memory/native). */
+    listConnectors(): Promise<string[]>;
+    /**
+     * Discover the schema of an external table or file source.
+     * Requires sidecar/HTTP store — throws on in-memory/native stores.
+     */
+    discoverConnectorSchema(type: string, query: string, auth?: ConnectorAuth): Promise<ConnectorSchema>;
+    /**
+     * Import data from an external source into a thingd collection.
+     * Requires sidecar/HTTP store — throws on in-memory/native stores.
+     */
+    connectorSync(type: string, options: ConnectorSyncOptions): Promise<ConnectorSyncResult>;
+}
+//# 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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"}