@neutron-build/nucleus 0.1.0

package/dist/geo/index.js

@@ -0,0 +1,121 @@
+// ---------------------------------------------------------------------------
+// @neutron/nucleus/geo — Geospatial model plugin
+// ---------------------------------------------------------------------------
+import { requireNucleus, assertIdentifier } from '../helpers.js';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+class GeoModelImpl {
+    transport;
+    features;
+    constructor(transport, features) {
+        this.transport = transport;
+        this.features = features;
+    }
+    require() {
+        requireNucleus(this.features, 'Geo');
+    }
+    async distance(a, b) {
+        this.require();
+        return ((await this.transport.fetchval('SELECT GEO_DISTANCE($1, $2, $3, $4)', [
+            a.lat, a.lon, b.lat, b.lon,
+        ])) ?? 0);
+    }
+    async distanceEuclidean(a, b) {
+        this.require();
+        return ((await this.transport.fetchval('SELECT GEO_DISTANCE_EUCLIDEAN($1, $2, $3, $4)', [
+            a.lat, a.lon, b.lat, b.lon,
+        ])) ?? 0);
+    }
+    async within(a, b, radiusMeters) {
+        this.require();
+        return ((await this.transport.fetchval('SELECT GEO_WITHIN($1, $2, $3, $4, $5)', [
+            a.lat, a.lon, b.lat, b.lon, radiusMeters,
+        ])) ?? false);
+    }
+    async area(points) {
+        this.require();
+        if (points.length < 3)
+            throw new Error('GEO_AREA requires at least 3 points');
+        const args = [];
+        const placeholders = [];
+        for (let i = 0; i < points.length; i++) {
+            args.push(points[i].lon, points[i].lat);
+            placeholders.push(`$${i * 2 + 1}`, `$${i * 2 + 2}`);
+        }
+        const sql = `SELECT GEO_AREA(${placeholders.join(', ')})`;
+        return (await this.transport.fetchval(sql, args)) ?? 0;
+    }
+    async nearestTo(layer, point, radiusMeters, limit) {
+        this.require();
+        assertIdentifier(layer, 'layer name');
+        const sql = `SELECT id, lat, lon, properties, GEO_DISTANCE($1, $2, lat, lon) AS dist ` +
+            `FROM ${layer} ` +
+            `WHERE GEO_WITHIN($1, $2, lat, lon, $3) ` +
+            `ORDER BY dist LIMIT $4`;
+        const result = await this.transport.query(sql, [point.lat, point.lon, radiusMeters, limit]);
+        return result.rows.map((r) => ({
+            id: r.id,
+            lat: Number(r.lat),
+            lon: Number(r.lon),
+            properties: {
+                ...(typeof r.properties === 'string' ? JSON.parse(r.properties) : (r.properties ?? {})),
+                distance: Number(r.dist),
+            },
+        }));
+    }
+    async withinBBox(layer, minLat, minLon, maxLat, maxLon) {
+        this.require();
+        assertIdentifier(layer, 'layer name');
+        const sql = `SELECT id, lat, lon, properties FROM ${layer} ` +
+            `WHERE lat >= $1 AND lat <= $3 AND lon >= $2 AND lon <= $4`;
+        const result = await this.transport.query(sql, [minLat, minLon, maxLat, maxLon]);
+        return result.rows.map((r) => ({
+            id: r.id,
+            lat: Number(r.lat),
+            lon: Number(r.lon),
+            properties: typeof r.properties === 'string' ? JSON.parse(r.properties) : (r.properties ?? {}),
+        }));
+    }
+    async withinPolygon(layer, polygon) {
+        this.require();
+        assertIdentifier(layer, 'layer name');
+        // Build GeoJSON polygon ([lon, lat] coordinate order)
+        const coords = polygon.map(([lat, lon]) => [lon, lat]);
+        // Close the ring if not already closed
+        if (coords.length > 0 &&
+            (coords[0][0] !== coords[coords.length - 1][0] || coords[0][1] !== coords[coords.length - 1][1])) {
+            coords.push([...coords[0]]);
+        }
+        const geoJson = JSON.stringify({
+            type: 'Polygon',
+            coordinates: [coords],
+        });
+        const sql = `SELECT id, lat, lon, properties FROM ${layer} ` +
+            `WHERE ST_CONTAINS(ST_GEOMFROMGEOJSON($1), ST_MAKEPOINT(lon, lat))`;
+        const result = await this.transport.query(sql, [geoJson]);
+        return result.rows.map((r) => ({
+            id: r.id,
+            lat: Number(r.lat),
+            lon: Number(r.lon),
+            properties: typeof r.properties === 'string' ? JSON.parse(r.properties) : (r.properties ?? {}),
+        }));
+    }
+    async insert(layer, lat, lon, props) {
+        this.require();
+        assertIdentifier(layer, 'layer name');
+        const propsJson = JSON.stringify(props);
+        await this.transport.execute(`INSERT INTO ${layer} (lat, lon, properties) VALUES ($1, $2, $3)`, [lat, lon, propsJson]);
+    }
+}
+// ---------------------------------------------------------------------------
+// Plugin
+// ---------------------------------------------------------------------------
+/** Plugin: adds `.geo` to the client. */
+export const withGeo = {
+    name: 'geo',
+    init(transport, features) {
+        return { geo: new GeoModelImpl(transport, features) };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/geo/index.js.map

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

package/dist/graph/index.d.ts

@@ -0,0 +1,43 @@
+import type { NucleusPlugin } from '../types.js';
+export type Direction = 'out' | 'in' | 'both';
+export interface GraphNode {
+    id: number;
+    labels?: string[];
+    properties?: Record<string, unknown>;
+}
+export interface GraphEdge {
+    id: number;
+    type: string;
+    fromId: number;
+    toId: number;
+    properties?: Record<string, unknown>;
+}
+export interface GraphResult {
+    columns: string[];
+    rows: Record<string, unknown>[];
+}
+export interface GraphModel {
+    /** Create a new node with labels and optional properties. Returns the node ID. */
+    addNode(labels: string[], props?: Record<string, unknown>): Promise<number>;
+    /** Create an edge between two nodes. Returns the edge ID. */
+    addEdge(fromId: number, toId: number, edgeType: string, props?: Record<string, unknown>): Promise<number>;
+    /** Delete a node by ID. Returns `true` if it existed. */
+    deleteNode(nodeId: number): Promise<boolean>;
+    /** Delete an edge by ID. Returns `true` if it existed. */
+    deleteEdge(edgeId: number): Promise<boolean>;
+    /** Execute a Cypher query with optional parameters. */
+    query(cypher: string, params?: Record<string, unknown>): Promise<GraphResult>;
+    /** Find neighboring nodes, optionally filtered by edge type and direction. */
+    neighbors(nodeId: number, edgeType?: string, direction?: Direction): Promise<GraphNode[]>;
+    /** Find the shortest path between two nodes. Returns node IDs along the path. */
+    shortestPath(fromId: number, toId: number, maxDepth?: number): Promise<number[]>;
+    /** Return the total number of nodes. */
+    nodeCount(): Promise<number>;
+    /** Return the total number of edges. */
+    edgeCount(): Promise<number>;
+}
+/** Plugin: adds `.graph` to the client. */
+export declare const withGraph: NucleusPlugin<{
+    graph: GraphModel;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,aAAa,EAAmB,MAAM,aAAa,CAAC;AAO7E,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACjC;AAMD,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5E,6DAA6D;IAC7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1G,yDAAyD;IACzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7C,0DAA0D;IAC1D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7C,uDAAuD;IACvD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9E,8EAA8E;IAC9E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE1F,iFAAiF;IACjF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjF,wCAAwC;IACxC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7B,wCAAwC;IACxC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B;AAmHD,2CAA2C;AAC3C,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAK1D,CAAC"}

package/dist/graph/index.js

@@ -0,0 +1,109 @@
+// ---------------------------------------------------------------------------
+// @neutron/nucleus/graph — Graph model plugin
+// ---------------------------------------------------------------------------
+import { requireNucleus } from '../helpers.js';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+class GraphModelImpl {
+    transport;
+    features;
+    constructor(transport, features) {
+        this.transport = transport;
+        this.features = features;
+    }
+    require() {
+        requireNucleus(this.features, 'Graph');
+    }
+    async addNode(labels, props) {
+        this.require();
+        const label = labels.join(':');
+        if (props) {
+            const propsJson = JSON.stringify(props);
+            return (await this.transport.fetchval('SELECT GRAPH_ADD_NODE($1, $2)', [label, propsJson])) ?? 0;
+        }
+        return (await this.transport.fetchval('SELECT GRAPH_ADD_NODE($1)', [label])) ?? 0;
+    }
+    async addEdge(fromId, toId, edgeType, props) {
+        this.require();
+        if (props) {
+            const propsJson = JSON.stringify(props);
+            return ((await this.transport.fetchval('SELECT GRAPH_ADD_EDGE($1, $2, $3, $4)', [
+                fromId,
+                toId,
+                edgeType,
+                propsJson,
+            ])) ?? 0);
+        }
+        return ((await this.transport.fetchval('SELECT GRAPH_ADD_EDGE($1, $2, $3)', [fromId, toId, edgeType])) ?? 0);
+    }
+    async deleteNode(nodeId) {
+        this.require();
+        return (await this.transport.fetchval('SELECT GRAPH_DELETE_NODE($1)', [nodeId])) ?? false;
+    }
+    async deleteEdge(edgeId) {
+        this.require();
+        return (await this.transport.fetchval('SELECT GRAPH_DELETE_EDGE($1)', [edgeId])) ?? false;
+    }
+    async query(cypher, params) {
+        this.require();
+        let raw;
+        if (params && Object.keys(params).length > 0) {
+            const paramsJson = JSON.stringify(params);
+            raw = await this.transport.fetchval('SELECT GRAPH_QUERY($1, $2)', [cypher, paramsJson]);
+        }
+        else {
+            raw = await this.transport.fetchval('SELECT GRAPH_QUERY($1)', [cypher]);
+        }
+        if (!raw)
+            return { columns: [], rows: [] };
+        return JSON.parse(raw);
+    }
+    async neighbors(nodeId, edgeType, direction = 'out') {
+        this.require();
+        const raw = await this.transport.fetchval('SELECT GRAPH_NEIGHBORS($1, $2)', [nodeId, direction]);
+        if (!raw)
+            return [];
+        const nodes = JSON.parse(raw);
+        if (edgeType) {
+            return nodes.filter((n) => n.properties?._edge_type === edgeType);
+        }
+        return nodes;
+    }
+    async shortestPath(fromId, toId, maxDepth) {
+        this.require();
+        let raw;
+        if (maxDepth && maxDepth > 0) {
+            raw = await this.transport.fetchval('SELECT GRAPH_SHORTEST_PATH($1, $2, $3)', [
+                fromId,
+                toId,
+                maxDepth,
+            ]);
+        }
+        else {
+            raw = await this.transport.fetchval('SELECT GRAPH_SHORTEST_PATH($1, $2)', [fromId, toId]);
+        }
+        if (!raw)
+            return [];
+        return JSON.parse(raw);
+    }
+    async nodeCount() {
+        this.require();
+        return (await this.transport.fetchval('SELECT GRAPH_NODE_COUNT()')) ?? 0;
+    }
+    async edgeCount() {
+        this.require();
+        return (await this.transport.fetchval('SELECT GRAPH_EDGE_COUNT()')) ?? 0;
+    }
+}
+// ---------------------------------------------------------------------------
+// Plugin
+// ---------------------------------------------------------------------------
+/** Plugin: adds `.graph` to the client. */
+export const withGraph = {
+    name: 'graph',
+    init(transport, features) {
+        return { graph: new GraphModelImpl(transport, features) };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,11 @@
+import type { NucleusFeatures } from './types.js';
+/**
+ * Throw if the server is not Nucleus or the specific feature is unavailable.
+ *
+ * When connected to plain PostgreSQL, always throws.
+ * When connected to Nucleus, checks the granular feature flag so that
+ * partially configured instances report the correct error.
+ */
+export declare function requireNucleus(features: NucleusFeatures, featureName: string): void;
+export declare function assertIdentifier(name: string, label: string): void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAoBlD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAQnF;AAQD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIlE"}

package/dist/helpers.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// Nucleus client — shared internal helpers
+// ---------------------------------------------------------------------------
+import { NucleusFeatureError } from './errors.js';
+/** Map from feature name to the corresponding NucleusFeatures key. */
+const FEATURE_KEY_MAP = {
+    KV: 'hasKV',
+    Vector: 'hasVector',
+    TimeSeries: 'hasTimeSeries',
+    Document: 'hasDocument',
+    Graph: 'hasGraph',
+    FTS: 'hasFTS',
+    Geo: 'hasGeo',
+    Blob: 'hasBlob',
+    Streams: 'hasStreams',
+    Columnar: 'hasColumnar',
+    Datalog: 'hasDatalog',
+    CDC: 'hasCDC',
+    PubSub: 'hasPubSub',
+};
+/**
+ * Throw if the server is not Nucleus or the specific feature is unavailable.
+ *
+ * When connected to plain PostgreSQL, always throws.
+ * When connected to Nucleus, checks the granular feature flag so that
+ * partially configured instances report the correct error.
+ */
+export function requireNucleus(features, featureName) {
+    if (!features.isNucleus) {
+        throw new NucleusFeatureError(featureName);
+    }
+    const key = FEATURE_KEY_MAP[featureName];
+    if (key && !features[key]) {
+        throw new NucleusFeatureError(featureName);
+    }
+}
+/**
+ * Validate that `name` is a safe SQL identifier (table/column name).
+ * Only allows `[a-zA-Z_][a-zA-Z0-9_]*`.
+ */
+const IDENTIFIER_RE = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+export function assertIdentifier(name, label) {
+    if (!IDENTIFIER_RE.test(name)) {
+        throw new Error(`Invalid ${label}: ${JSON.stringify(name)}`);
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAG9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,sEAAsE;AACtE,MAAM,eAAe,GAA0C;IAC7D,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,eAAe;IAC3B,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;IACrB,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAyB,EAAE,WAAmB;IAC3E,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,GAAG,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAa;IAC1D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+export { createClient } from './client.js';
+export type { NucleusClientConfig, NucleusClientBase, NucleusClientBuilder } from './client.js';
+export type { Transport, TransactionTransport, QueryResult, IsolationLevel, NucleusFeatures, NucleusPlugin, } from './types.js';
+export { NucleusError, NucleusConnectionError, NucleusQueryError, NucleusNotFoundError, NucleusConflictError, NucleusTransactionError, NucleusFeatureError, NucleusAuthError, } from './errors.js';
+export { HttpTransport, MobileTransport, EmbeddedTransport, createTransport } from './transport.js';
+export type { TransportConfig, MobileTransportConfig } from './transport.js';
+export { detectFeatures } from './features.js';
+export { requireNucleus, assertIdentifier } from './helpers.js';
+export { migrate, migrateDown, migrationStatus } from './migrate.js';
+export type { Migration, MigrationRecord } from './migrate.js';
+export { withSQL } from './sql/index.js';
+export type { SQLModel } from './sql/index.js';
+export { withKV } from './kv/index.js';
+export type { KVModel, KVSetOptions } from './kv/index.js';
+export { withVector } from './vector/index.js';
+export type { VectorModel, VectorSearchResult, VectorSearchOptions, DistanceMetric } from './vector/index.js';
+export { withTimeSeries } from './timeseries/index.js';
+export type { TimeSeriesModel, TimeSeriesPoint, AggFunc, BucketInterval, TimeSeriesQueryOptions } from './timeseries/index.js';
+export { withDocument } from './document/index.js';
+export type { DocumentModel, DocFindOptions } from './document/index.js';
+export { withGraph } from './graph/index.js';
+export type { GraphModel, GraphNode, GraphEdge, GraphResult, Direction } from './graph/index.js';
+export { withFTS } from './fts/index.js';
+export type { FTSModel, FTSResult, FTSSearchOptions } from './fts/index.js';
+export { withGeo } from './geo/index.js';
+export type { GeoModel, GeoPoint, GeoFeature } from './geo/index.js';
+export { withBlob } from './blob/index.js';
+export type { BlobModel, BlobMeta, BlobPutOptions } from './blob/index.js';
+export { withPubSub } from './pubsub/index.js';
+export type { PubSubModel } from './pubsub/index.js';
+export { withStreams } from './streams/index.js';
+export type { StreamsModel, StreamEntry } from './streams/index.js';
+export { withColumnar } from './columnar/index.js';
+export type { ColumnarModel } from './columnar/index.js';
+export { withDatalog } from './datalog/index.js';
+export type { DatalogModel } from './datalog/index.js';
+export { withCDC } from './cdc/index.js';
+export type { CDCModel } from './cdc/index.js';
+//# 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,29 @@
+// ---------------------------------------------------------------------------
+// @neutron/nucleus — main entry point
+// ---------------------------------------------------------------------------
+export { createClient } from './client.js';
+export { NucleusError, NucleusConnectionError, NucleusQueryError, NucleusNotFoundError, NucleusConflictError, NucleusTransactionError, NucleusFeatureError, NucleusAuthError, } from './errors.js';
+export { HttpTransport, MobileTransport, EmbeddedTransport, createTransport } from './transport.js';
+export { detectFeatures } from './features.js';
+export { requireNucleus, assertIdentifier } from './helpers.js';
+export { migrate, migrateDown, migrationStatus } from './migrate.js';
+// ---------------------------------------------------------------------------
+// Model plugins — re-exported for convenience.
+// Tree-shakeable: each plugin can also be imported from its own subpath
+// (e.g. `@neutron/nucleus/kv`).
+// ---------------------------------------------------------------------------
+export { withSQL } from './sql/index.js';
+export { withKV } from './kv/index.js';
+export { withVector } from './vector/index.js';
+export { withTimeSeries } from './timeseries/index.js';
+export { withDocument } from './document/index.js';
+export { withGraph } from './graph/index.js';
+export { withFTS } from './fts/index.js';
+export { withGeo } from './geo/index.js';
+export { withBlob } from './blob/index.js';
+export { withPubSub } from './pubsub/index.js';
+export { withStreams } from './streams/index.js';
+export { withColumnar } from './columnar/index.js';
+export { withDatalog } from './datalog/index.js';
+export { withCDC } from './cdc/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY3C,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGrE,8EAA8E;AAC9E,+CAA+C;AAC/C,wEAAwE;AACxE,gCAAgC;AAChC,8EAA8E;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/kv/index.d.ts

@@ -0,0 +1,93 @@
+import type { NucleusPlugin } from '../types.js';
+export interface KVSetOptions {
+    /** Time-to-live in seconds. */
+    ttl?: number;
+    /** Key namespace prefix (prepended as `namespace:key`). */
+    namespace?: string;
+}
+export interface KVModel {
+    /** Get a raw string value. Returns `null` if the key does not exist. */
+    get(key: string): Promise<string | null>;
+    /** Get a value and JSON-parse it into `T`. Returns `null` if missing. */
+    getTyped<T>(key: string): Promise<T | null>;
+    /** Set a raw string value. */
+    set(key: string, value: string, opts?: KVSetOptions): Promise<void>;
+    /** JSON-stringify `value` and store it. */
+    setTyped<T>(key: string, value: T, opts?: KVSetOptions): Promise<void>;
+    /** Set the key only if it does not already exist. Returns `true` if set. */
+    setNX(key: string, value: string): Promise<boolean>;
+    /** Delete a key. Returns `true` if it existed. */
+    delete(key: string): Promise<boolean>;
+    /** Check whether a key exists. */
+    exists(key: string): Promise<boolean>;
+    /** Atomically increment a key's integer value. Returns the new value. */
+    incr(key: string, amount?: number): Promise<number>;
+    /** Get the remaining TTL in seconds. -1 = no TTL, -2 = missing key. */
+    ttl(key: string): Promise<number>;
+    /** Set a TTL on an existing key. Returns `true` if the key existed. */
+    expire(key: string, seconds: number): Promise<boolean>;
+    /** Return the total number of keys. */
+    dbSize(): Promise<number>;
+    /** Delete all keys. */
+    flushDB(): Promise<void>;
+    /** Scan keys matching a pattern. Returns matching key-value pairs. */
+    scan(pattern: string, count?: number): Promise<Array<{
+        key: string;
+        value: string;
+    }>>;
+    /** Prepend a value to a list. Returns the new list length. */
+    lpush(key: string, value: string): Promise<number>;
+    /** Append a value to a list. Returns the new list length. */
+    rpush(key: string, value: string): Promise<number>;
+    /** Remove and return the first element of a list. */
+    lpop(key: string): Promise<string | null>;
+    /** Remove and return the last element of a list. */
+    rpop(key: string): Promise<string | null>;
+    /** Return elements between `start` and `stop` (inclusive). */
+    lrange(key: string, start: number, stop: number): Promise<string[]>;
+    /** Return the length of a list. */
+    llen(key: string): Promise<number>;
+    /** Return the element at `index`. */
+    lindex(key: string, index: number): Promise<string | null>;
+    /** Set a field in a hash. Returns `true` if the field is new. */
+    hset(key: string, field: string, value: string): Promise<boolean>;
+    /** Get a hash field value. */
+    hget(key: string, field: string): Promise<string | null>;
+    /** Remove a field from a hash. Returns `true` if removed. */
+    hdel(key: string, field: string): Promise<boolean>;
+    /** Check if a field exists in a hash. */
+    hexists(key: string, field: string): Promise<boolean>;
+    /** Return all fields and values of a hash. */
+    hgetall(key: string): Promise<Record<string, string>>;
+    /** Return the number of fields in a hash. */
+    hlen(key: string): Promise<number>;
+    /** Add a member to a set. Returns `true` if it was new. */
+    sadd(key: string, member: string): Promise<boolean>;
+    /** Remove a member from a set. Returns `true` if removed. */
+    srem(key: string, member: string): Promise<boolean>;
+    /** Return all members of a set. */
+    smembers(key: string): Promise<string[]>;
+    /** Check if a member exists in a set. */
+    sismember(key: string, member: string): Promise<boolean>;
+    /** Return the number of members in a set. */
+    scard(key: string): Promise<number>;
+    /** Add a member with a score to a sorted set. Returns `true` if new. */
+    zadd(key: string, score: number, member: string): Promise<boolean>;
+    /** Return members by rank range. */
+    zrange(key: string, start: number, stop: number): Promise<string[]>;
+    /** Return members with scores between `min` and `max`. */
+    zrangeByScore(key: string, min: number, max: number): Promise<string[]>;
+    /** Remove a member from a sorted set. Returns `true` if removed. */
+    zrem(key: string, member: string): Promise<boolean>;
+    /** Return the number of members in a sorted set. */
+    zcard(key: string): Promise<number>;
+    /** Add an element to a HyperLogLog. Returns `true` if the internal state changed. */
+    pfadd(key: string, element: string): Promise<boolean>;
+    /** Return the approximate cardinality. */
+    pfcount(key: string): Promise<number>;
+}
+/** Plugin: adds `.kv` to the client. */
+export declare const withKV: NucleusPlugin<{
+    kv: KVModel;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/kv/index.d.ts.map

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