digital-objects 1.0.0

package/dist/ns-client.d.ts

@@ -0,0 +1,88 @@
+/**
+ * NS Client - HTTP client wrapper for NS Durable Object
+ *
+ * Allows using NS like a regular DigitalObjectsProvider via HTTP.
+ */
+import type { DigitalObjectsProvider, Noun, NounDefinition, Verb, VerbDefinition, Thing, Action, ListOptions, ActionOptions } from './types.js';
+export interface NSClientOptions {
+    /** Base URL of the NS worker */
+    baseUrl: string;
+    /** Namespace ID */
+    namespace?: string;
+    /** Custom fetch function (useful for Workers Service Bindings) */
+    fetch?: typeof fetch;
+}
+/**
+ * NSClient - Class-based HTTP client for NS Durable Object
+ *
+ * Provides a DigitalObjectsProvider interface over HTTP, allowing
+ * Workers to communicate with NS Durable Objects via fetch.
+ *
+ * @example
+ * ```ts
+ * // From a Cloudflare Worker
+ * const client = new NSClient({
+ *   baseUrl: 'https://ns.example.com',
+ *   namespace: 'my-tenant',
+ * })
+ *
+ * const post = await client.create('Post', { title: 'Hello' })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With Service Binding
+ * const client = new NSClient({
+ *   baseUrl: 'http://ns', // Service binding name
+ *   namespace: 'my-tenant',
+ *   fetch: env.NS.fetch.bind(env.NS), // Service binding fetch
+ * })
+ * ```
+ */
+export declare class NSClient implements DigitalObjectsProvider {
+    private readonly baseUrl;
+    private readonly namespace;
+    private readonly fetchFn;
+    constructor(options: NSClientOptions);
+    private url;
+    private request;
+    defineNoun(def: NounDefinition): Promise<Noun>;
+    getNoun(name: string): Promise<Noun | null>;
+    listNouns(): Promise<Noun[]>;
+    defineVerb(def: VerbDefinition): Promise<Verb>;
+    getVerb(name: string): Promise<Verb | null>;
+    listVerbs(): Promise<Verb[]>;
+    create<T>(noun: string, data: T, id?: string): Promise<Thing<T>>;
+    get<T>(id: string): Promise<Thing<T> | null>;
+    list<T>(noun: string, options?: ListOptions): Promise<Thing<T>[]>;
+    find<T>(noun: string, where: Partial<T>): Promise<Thing<T>[]>;
+    update<T>(id: string, data: Partial<T>): Promise<Thing<T>>;
+    delete(id: string): Promise<boolean>;
+    search<T>(query: string, options?: ListOptions): Promise<Thing<T>[]>;
+    perform<T>(verb: string, subject?: string, object?: string, data?: T): Promise<Action<T>>;
+    getAction<T>(id: string): Promise<Action<T> | null>;
+    listActions<T>(options?: ActionOptions): Promise<Action<T>[]>;
+    deleteAction(id: string): Promise<boolean>;
+    related<T>(id: string, verb?: string, direction?: 'out' | 'in' | 'both'): Promise<Thing<T>[]>;
+    edges<T>(id: string, verb?: string, direction?: 'out' | 'in' | 'both'): Promise<Action<T>[]>;
+    createMany<T>(noun: string, items: T[]): Promise<Thing<T>[]>;
+    updateMany<T>(updates: Array<{
+        id: string;
+        data: Partial<T>;
+    }>): Promise<Thing<T>[]>;
+    deleteMany(ids: string[]): Promise<boolean[]>;
+    performMany<T>(actions: Array<{
+        verb: string;
+        subject?: string;
+        object?: string;
+        data?: T;
+    }>): Promise<Action<T>[]>;
+    close(): Promise<void>;
+}
+/**
+ * Create an NS client that talks to the Durable Object via HTTP
+ *
+ * @deprecated Use `new NSClient(options)` instead for better TypeScript support
+ */
+export declare function createNSClient(options: NSClientOptions): DigitalObjectsProvider;
+//# sourceMappingURL=ns-client.d.ts.map

package/dist/ns-client.d.ts.map

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

package/dist/ns-client.js

@@ -0,0 +1,253 @@
+/**
+ * NS Client - HTTP client wrapper for NS Durable Object
+ *
+ * Allows using NS like a regular DigitalObjectsProvider via HTTP.
+ */
+/**
+ * NSClient - Class-based HTTP client for NS Durable Object
+ *
+ * Provides a DigitalObjectsProvider interface over HTTP, allowing
+ * Workers to communicate with NS Durable Objects via fetch.
+ *
+ * @example
+ * ```ts
+ * // From a Cloudflare Worker
+ * const client = new NSClient({
+ *   baseUrl: 'https://ns.example.com',
+ *   namespace: 'my-tenant',
+ * })
+ *
+ * const post = await client.create('Post', { title: 'Hello' })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With Service Binding
+ * const client = new NSClient({
+ *   baseUrl: 'http://ns', // Service binding name
+ *   namespace: 'my-tenant',
+ *   fetch: env.NS.fetch.bind(env.NS), // Service binding fetch
+ * })
+ * ```
+ */
+export class NSClient {
+    baseUrl;
+    namespace;
+    fetchFn;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.namespace = options.namespace ?? 'default';
+        this.fetchFn = options.fetch ?? fetch;
+    }
+    url(path, extraParams) {
+        const params = new URLSearchParams();
+        params.set('ns', this.namespace);
+        if (extraParams) {
+            extraParams.forEach((value, key) => params.set(key, value));
+        }
+        return `${this.baseUrl}${path}?${params}`;
+    }
+    async request(path, init, extraParams) {
+        const res = await this.fetchFn(this.url(path, extraParams), {
+            ...init,
+            headers: {
+                'Content-Type': 'application/json',
+                ...init?.headers,
+            },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`NS request failed: ${res.status} ${text}`);
+        }
+        return res.json();
+    }
+    // ==================== Nouns ====================
+    async defineNoun(def) {
+        return this.request('/nouns', {
+            method: 'POST',
+            body: JSON.stringify(def),
+        });
+    }
+    async getNoun(name) {
+        try {
+            return await this.request(`/nouns/${encodeURIComponent(name)}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    async listNouns() {
+        return this.request('/nouns');
+    }
+    // ==================== Verbs ====================
+    async defineVerb(def) {
+        return this.request('/verbs', {
+            method: 'POST',
+            body: JSON.stringify(def),
+        });
+    }
+    async getVerb(name) {
+        try {
+            return await this.request(`/verbs/${encodeURIComponent(name)}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    async listVerbs() {
+        return this.request('/verbs');
+    }
+    // ==================== Things ====================
+    async create(noun, data, id) {
+        return this.request('/things', {
+            method: 'POST',
+            body: JSON.stringify({ noun, data, id }),
+        });
+    }
+    async get(id) {
+        try {
+            return await this.request(`/things/${encodeURIComponent(id)}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    async list(noun, options) {
+        const params = new URLSearchParams({ noun });
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        if (options?.offset)
+            params.set('offset', String(options.offset));
+        if (options?.orderBy)
+            params.set('orderBy', options.orderBy);
+        if (options?.order)
+            params.set('order', options.order);
+        const results = await this.request('/things', undefined, params);
+        // Apply where filter client-side (NS server doesn't support where in URL)
+        if (options?.where) {
+            return results.filter((thing) => {
+                for (const [key, value] of Object.entries(options.where)) {
+                    if (thing.data[key] !== value) {
+                        return false;
+                    }
+                }
+                return true;
+            });
+        }
+        return results;
+    }
+    async find(noun, where) {
+        return this.list(noun, { where: where });
+    }
+    async update(id, data) {
+        return this.request(`/things/${encodeURIComponent(id)}`, {
+            method: 'PATCH',
+            body: JSON.stringify(data),
+        });
+    }
+    async delete(id) {
+        const result = await this.request(`/things/${encodeURIComponent(id)}`, {
+            method: 'DELETE',
+        });
+        return result.deleted;
+    }
+    async search(query, options) {
+        const params = new URLSearchParams({ q: query });
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        return this.request('/search', undefined, params);
+    }
+    // ==================== Actions ====================
+    async perform(verb, subject, object, data) {
+        return this.request('/actions', {
+            method: 'POST',
+            body: JSON.stringify({ verb, subject, object, data }),
+        });
+    }
+    async getAction(id) {
+        try {
+            return await this.request(`/actions/${encodeURIComponent(id)}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    async listActions(options) {
+        const params = new URLSearchParams();
+        if (options?.verb)
+            params.set('verb', options.verb);
+        if (options?.subject)
+            params.set('subject', options.subject);
+        if (options?.object)
+            params.set('object', options.object);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        if (options?.status) {
+            const status = Array.isArray(options.status) ? options.status[0] : options.status;
+            if (status)
+                params.set('status', status);
+        }
+        return this.request('/actions', undefined, params);
+    }
+    async deleteAction(id) {
+        const result = await this.request(`/actions/${encodeURIComponent(id)}`, {
+            method: 'DELETE',
+        });
+        return result.deleted;
+    }
+    // ==================== Graph Traversal ====================
+    async related(id, verb, direction) {
+        const params = new URLSearchParams();
+        if (verb)
+            params.set('verb', verb);
+        if (direction)
+            params.set('direction', direction);
+        return this.request(`/related/${encodeURIComponent(id)}`, undefined, params);
+    }
+    async edges(id, verb, direction) {
+        const params = new URLSearchParams();
+        if (verb)
+            params.set('verb', verb);
+        if (direction)
+            params.set('direction', direction);
+        return this.request(`/edges/${encodeURIComponent(id)}`, undefined, params);
+    }
+    // ==================== Batch Operations ====================
+    async createMany(noun, items) {
+        return this.request('/batch/things', {
+            method: 'POST',
+            body: JSON.stringify({ noun, items }),
+        });
+    }
+    async updateMany(updates) {
+        return this.request('/batch/things', {
+            method: 'PATCH',
+            body: JSON.stringify({ updates }),
+        });
+    }
+    async deleteMany(ids) {
+        return this.request('/batch/things', {
+            method: 'DELETE',
+            body: JSON.stringify({ ids }),
+        });
+    }
+    async performMany(actions) {
+        return this.request('/batch/actions', {
+            method: 'POST',
+            body: JSON.stringify({ actions }),
+        });
+    }
+    // ==================== Lifecycle ====================
+    async close() {
+        // No-op for HTTP client
+    }
+}
+/**
+ * Create an NS client that talks to the Durable Object via HTTP
+ *
+ * @deprecated Use `new NSClient(options)` instead for better TypeScript support
+ */
+export function createNSClient(options) {
+    return new NSClient(options);
+}
+//# sourceMappingURL=ns-client.js.map

package/dist/ns-client.js.map

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

package/dist/ns-exports.d.ts

@@ -0,0 +1,23 @@
+/**
+ * NS - Namespace Durable Object
+ *
+ * Import from 'digital-objects/ns' when deploying to Cloudflare Workers.
+ *
+ * @example
+ * ```typescript
+ * // wrangler.jsonc
+ * {
+ *   "durable_objects": {
+ *     "bindings": [{ "name": "NS", "class_name": "NS" }]
+ *   }
+ * }
+ *
+ * // worker.ts
+ * export { NS } from 'digital-objects/ns'
+ * ```
+ */
+export { NS } from './ns.js';
+export type { Env } from './ns.js';
+export { createNSClient } from './ns-client.js';
+export type { NSClientOptions } from './ns-client.js';
+//# sourceMappingURL=ns-exports.d.ts.map

package/dist/ns-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ns-exports.d.ts","sourceRoot":"","sources":["../src/ns-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,YAAY,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/ns-exports.js

@@ -0,0 +1,21 @@
+/**
+ * NS - Namespace Durable Object
+ *
+ * Import from 'digital-objects/ns' when deploying to Cloudflare Workers.
+ *
+ * @example
+ * ```typescript
+ * // wrangler.jsonc
+ * {
+ *   "durable_objects": {
+ *     "bindings": [{ "name": "NS", "class_name": "NS" }]
+ *   }
+ * }
+ *
+ * // worker.ts
+ * export { NS } from 'digital-objects/ns'
+ * ```
+ */
+export { NS } from './ns.js';
+export { createNSClient } from './ns-client.js';
+//# sourceMappingURL=ns-exports.js.map

package/dist/ns-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ns-exports.js","sourceRoot":"","sources":["../src/ns-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/ns.d.ts

@@ -0,0 +1,60 @@
+/**
+ * NS - Namespace Durable Object
+ *
+ * SQLite-based implementation of DigitalObjectsProvider for Cloudflare Workers.
+ * Each NS instance represents a namespace (tenant) with isolated data.
+ */
+import type { DigitalObjectsProvider, Noun, NounDefinition, Verb, VerbDefinition, Thing, Action, ListOptions, ActionOptions, ValidationOptions, Direction } from './types.js';
+export interface Env {
+    NS: DurableObjectNamespace;
+    STORAGE?: R2Bucket;
+}
+/**
+ * NS - Namespace Durable Object
+ */
+export declare class NS implements DigitalObjectsProvider {
+    private sql;
+    private initialized;
+    private nounCache;
+    private verbCache;
+    constructor(ctx: DurableObjectState, _env: Env);
+    private ensureInitialized;
+    fetch(request: Request): Promise<Response>;
+    defineNoun(def: NounDefinition): Promise<Noun>;
+    getNoun(name: string): Promise<Noun | null>;
+    listNouns(): Promise<Noun[]>;
+    defineVerb(def: VerbDefinition): Promise<Verb>;
+    getVerb(name: string): Promise<Verb | null>;
+    listVerbs(): Promise<Verb[]>;
+    create<T>(noun: string, data: T, id?: string, options?: ValidationOptions): Promise<Thing<T>>;
+    get<T>(id: string): Promise<Thing<T> | null>;
+    list<T>(noun: string, options?: ListOptions): Promise<Thing<T>[]>;
+    find<T>(noun: string, where: Partial<T>): Promise<Thing<T>[]>;
+    update<T>(id: string, data: Partial<T>, options?: ValidationOptions): Promise<Thing<T>>;
+    delete(id: string): Promise<boolean>;
+    search<T>(query: string, options?: ListOptions): Promise<Thing<T>[]>;
+    perform<T>(verb: string, subject?: string, object?: string, data?: T): Promise<Action<T>>;
+    getAction<T>(id: string): Promise<Action<T> | null>;
+    listActions<T>(options?: ActionOptions): Promise<Action<T>[]>;
+    deleteAction(id: string): Promise<boolean>;
+    related<T>(id: string, verb?: string, direction?: Direction, options?: ListOptions): Promise<Thing<T>[]>;
+    edges<T>(id: string, verb?: string, direction?: Direction, options?: ListOptions): Promise<Action<T>[]>;
+    createMany<T>(noun: string, items: T[]): Promise<Thing<T>[]>;
+    updateMany<T>(updates: Array<{
+        id: string;
+        data: Partial<T>;
+    }>): Promise<Thing<T>[]>;
+    deleteMany(ids: string[]): Promise<boolean[]>;
+    performMany<T>(actions: Array<{
+        verb: string;
+        subject?: string;
+        object?: string;
+        data?: T;
+    }>): Promise<Action<T>[]>;
+    close(): Promise<void>;
+}
+declare const _default: {
+    fetch(request: Request, env: Env): Promise<Response>;
+};
+export default _default;
+//# sourceMappingURL=ns.d.ts.map

package/dist/ns.d.ts.map

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