@cepseudo/ngsi-ld 1.0.0

package/dist/subscriptions/subscription_store.js

@@ -0,0 +1,189 @@
+import { randomUUID } from 'crypto';
+const TABLE = 'ngsi_ld_subscriptions';
+/**
+ * Column schema for the subscriptions table.
+ * Uses TEXT for everything (arrays stored as JSON) for SQLite/PostgreSQL compatibility.
+ * The integer `id` PK is added automatically by `createTableWithColumns`.
+ * The UUID is stored in `sub_id`.
+ */
+const SUBSCRIPTION_COLUMNS = {
+    sub_id: 'text not null',
+    name: 'text',
+    description: 'text',
+    entity_types: 'text not null',
+    watched_attributes: 'text',
+    q: 'text',
+    notification_endpoint: 'text not null',
+    notification_format: 'text',
+    notification_attrs: 'text',
+    throttling: 'integer',
+    expires_at: 'text',
+    is_active: 'integer',
+    last_notification_at: 'text',
+    last_success_at: 'text',
+    times_sent: 'integer',
+    times_failed: 'integer',
+};
+/**
+ * PostgreSQL/SQLite persistence layer for NGSI-LD subscriptions.
+ *
+ * Arrays are serialized as JSON strings for SQLite compatibility.
+ * The UUID subscription id is stored in the `sub_id` column; the database
+ * integer primary key is used internally for updates.
+ */
+export class SubscriptionStore {
+    #db;
+    constructor(db) {
+        this.#db = db;
+    }
+    /**
+     * Creates the ngsi_ld_subscriptions table if it does not already exist.
+     */
+    async runMigration() {
+        const exists = await this.#db.doesTableExists(TABLE);
+        if (!exists) {
+            await this.#db.createTableWithColumns(TABLE, SUBSCRIPTION_COLUMNS);
+        }
+        else {
+            await this.#db.ensureColumns(TABLE, SUBSCRIPTION_COLUMNS);
+        }
+    }
+    /**
+     * Inserts a new subscription and returns it with generated id and timestamps.
+     */
+    async create(input) {
+        const subId = randomUUID();
+        const entityTypes = input.entities?.map(e => e.type) ?? [];
+        const data = {
+            sub_id: subId,
+            name: input.name ?? null,
+            description: input.description ?? null,
+            entity_types: JSON.stringify(entityTypes),
+            watched_attributes: input.watchedAttributes ? JSON.stringify(input.watchedAttributes) : null,
+            q: input.q ?? null,
+            notification_endpoint: input.notification.endpoint.uri,
+            notification_format: input.notification.format ?? 'normalized',
+            notification_attrs: input.notification.attributes ? JSON.stringify(input.notification.attributes) : null,
+            throttling: input.throttling ?? 0,
+            expires_at: input.expiresAt ?? null,
+            is_active: 1,
+            last_notification_at: null,
+            last_success_at: null,
+            times_sent: 0,
+            times_failed: 0,
+        };
+        await this.#db.insertCustomTableRecord(TABLE, data);
+        const created = await this.findById(subId);
+        if (!created) {
+            throw new Error(`Failed to retrieve subscription after insert: ${subId}`);
+        }
+        return created;
+    }
+    /**
+     * Returns all active subscriptions.
+     */
+    async findAll() {
+        const rows = await this.#db.findCustomTableRecords(TABLE, { is_active: 1 });
+        return rows.map(row => this.#rowToSubscription(row));
+    }
+    /**
+     * Returns a subscription by its UUID, or null if not found.
+     */
+    async findById(subId) {
+        const rows = await this.#db.findCustomTableRecords(TABLE, { sub_id: subId, is_active: 1 });
+        if (rows.length === 0)
+            return null;
+        return this.#rowToSubscription(rows[0]);
+    }
+    /**
+     * Partially updates a subscription.
+     */
+    async update(subId, patch) {
+        const rows = await this.#db.findCustomTableRecords(TABLE, { sub_id: subId });
+        if (rows.length === 0)
+            return null;
+        const internalId = rows[0].id;
+        const updates = {};
+        if (patch.name !== undefined)
+            updates['name'] = patch.name;
+        if (patch.description !== undefined)
+            updates['description'] = patch.description;
+        if (patch.entities !== undefined)
+            updates['entity_types'] = JSON.stringify(patch.entities.map(e => e.type));
+        if (patch.watchedAttributes !== undefined)
+            updates['watched_attributes'] = JSON.stringify(patch.watchedAttributes);
+        if (patch.q !== undefined)
+            updates['q'] = patch.q;
+        if (patch.notification?.endpoint?.uri !== undefined)
+            updates['notification_endpoint'] = patch.notification.endpoint.uri;
+        if (patch.notification?.format !== undefined)
+            updates['notification_format'] = patch.notification.format;
+        if (patch.notification?.attributes !== undefined)
+            updates['notification_attrs'] = JSON.stringify(patch.notification.attributes);
+        if (patch.throttling !== undefined)
+            updates['throttling'] = patch.throttling;
+        if (patch.expiresAt !== undefined)
+            updates['expires_at'] = patch.expiresAt;
+        await this.#db.updateById(TABLE, internalId, updates);
+        return this.findById(subId);
+    }
+    /**
+     * Soft-deletes a subscription by setting is_active = 0.
+     */
+    async delete(subId) {
+        const rows = await this.#db.findCustomTableRecords(TABLE, { sub_id: subId });
+        if (rows.length === 0)
+            return false;
+        const internalId = rows[0].id;
+        await this.#db.updateById(TABLE, internalId, { is_active: 0 });
+        return true;
+    }
+    /**
+     * Updates notification statistics after a delivery attempt.
+     */
+    async recordNotification(subId, success, at) {
+        const rows = await this.#db.findCustomTableRecords(TABLE, { sub_id: subId });
+        if (rows.length === 0)
+            return;
+        const row = rows[0];
+        const internalId = row.id;
+        const updates = {
+            last_notification_at: at,
+            times_sent: (Number(row['times_sent']) || 0) + 1,
+        };
+        if (success) {
+            updates['last_success_at'] = at;
+        }
+        else {
+            updates['times_failed'] = (Number(row['times_failed']) || 0) + 1;
+        }
+        await this.#db.updateById(TABLE, internalId, updates);
+    }
+    #rowToSubscription(row) {
+        return {
+            id: String(row['sub_id']),
+            name: row['name'] ? String(row['name']) : undefined,
+            description: row['description'] ? String(row['description']) : undefined,
+            entityTypes: row['entity_types'] ? JSON.parse(String(row['entity_types'])) : [],
+            watchedAttributes: row['watched_attributes']
+                ? JSON.parse(String(row['watched_attributes']))
+                : undefined,
+            q: row['q'] ? String(row['q']) : undefined,
+            notificationEndpoint: String(row['notification_endpoint']),
+            notificationFormat: row['notification_format'] ?? 'normalized',
+            notificationAttrs: row['notification_attrs']
+                ? JSON.parse(String(row['notification_attrs']))
+                : undefined,
+            throttling: Number(row['throttling'] ?? 0),
+            expiresAt: row['expires_at'] ? String(row['expires_at']) : undefined,
+            isActive: Number(row['is_active']) === 1,
+            lastNotificationAt: row['last_notification_at'] ? String(row['last_notification_at']) : undefined,
+            lastSuccessAt: row['last_success_at'] ? String(row['last_success_at']) : undefined,
+            timesSent: Number(row['times_sent'] ?? 0),
+            timesFailed: Number(row['times_failed'] ?? 0),
+            createdAt: String(row['created_at']),
+            updatedAt: String(row['updated_at']),
+        };
+    }
+}
+//# sourceMappingURL=subscription_store.js.map

package/dist/subscriptions/subscription_store.js.map

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

package/dist/types/context.d.ts

@@ -0,0 +1,9 @@
+/**
+ * JSON-LD @context value — can be a URL string, array of strings/objects, or an inline context object.
+ */
+export type JsonLdContext = string | string[] | Record<string, unknown>;
+/**
+ * The default ETSI NGSI-LD core context URL.
+ */
+export declare const NGSI_LD_CORE_CONTEXT = "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld";
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,oBAAoB,gEAAgE,CAAA"}

package/dist/types/context.js

@@ -0,0 +1,5 @@
+/**
+ * The default ETSI NGSI-LD core context URL.
+ */
+export const NGSI_LD_CORE_CONTEXT = 'https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld';
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,6DAA6D,CAAA"}

package/dist/types/entity.d.ts

@@ -0,0 +1,46 @@
+import type { JsonLdContext } from './context.js';
+/**
+ * A GeoJSON geometry value as per RFC 7946.
+ */
+export interface GeoJsonGeometry {
+    type: 'Point' | 'LineString' | 'Polygon' | 'MultiPoint' | 'MultiLineString' | 'MultiPolygon';
+    coordinates: number | number[] | number[][] | number[][][] | number[][][][];
+}
+/**
+ * An NGSI-LD Property holding a typed value.
+ */
+export interface NgsiLdProperty<T = unknown> {
+    type: 'Property';
+    value: T;
+    observedAt?: string;
+    unitCode?: string;
+    [key: string]: unknown;
+}
+/**
+ * An NGSI-LD GeoProperty holding a GeoJSON geometry.
+ */
+export interface NgsiLdGeoProperty {
+    type: 'GeoProperty';
+    value: GeoJsonGeometry;
+    observedAt?: string;
+    [key: string]: unknown;
+}
+/**
+ * An NGSI-LD Relationship pointing to another entity by URN.
+ */
+export interface NgsiLdRelationship {
+    type: 'Relationship';
+    object: string;
+    observedAt?: string;
+    [key: string]: unknown;
+}
+/**
+ * An NGSI-LD entity with typed attributes.
+ */
+export interface NgsiLdEntity {
+    id: string;
+    type: string;
+    '@context'?: JsonLdContext;
+    [key: string]: NgsiLdProperty | NgsiLdGeoProperty | NgsiLdRelationship | string | JsonLdContext | undefined;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/types/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/types/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,CAAA;IAC5F,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,CAAA;CAC9E;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,CAAC,CAAA;IACR,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,EAAE,eAAe,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;CAC9G"}

package/dist/types/entity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity.js.map

package/dist/types/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/types/entity.ts"],"names":[],"mappings":""}

package/dist/types/notification.d.ts

@@ -0,0 +1,22 @@
+import type { NgsiLdEntity } from './entity.js';
+import type { Subscription } from './subscription.js';
+/**
+ * Payload delivered to a subscriber's endpoint.
+ */
+export interface NotificationPayload {
+    id: string;
+    type: 'Notification';
+    subscriptionId: string;
+    notifiedAt: string;
+    data: NgsiLdEntity[];
+}
+/**
+ * Data stored in the BullMQ job for notification delivery.
+ */
+export interface NotificationJobData {
+    subscription: Subscription;
+    entity: NgsiLdEntity;
+    notificationId: string;
+    notifiedAt: string;
+}
+//# sourceMappingURL=notification.d.ts.map

package/dist/types/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/types/notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,cAAc,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,YAAY,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,EAAE,YAAY,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CACrB"}

package/dist/types/notification.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=notification.js.map

package/dist/types/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/types/notification.ts"],"names":[],"mappings":""}

package/dist/types/subscription.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Notification format for NGSI-LD subscriptions.
+ */
+export type NotificationFormat = 'normalized' | 'keyValues';
+/**
+ * Notification endpoint configuration.
+ */
+export interface NotificationEndpoint {
+    uri: string;
+    accept?: string;
+}
+/**
+ * Input payload for creating a new subscription.
+ */
+export interface SubscriptionCreate {
+    name?: string;
+    description?: string;
+    entities?: Array<{
+        type: string;
+    }>;
+    watchedAttributes?: string[];
+    q?: string;
+    notification: {
+        endpoint: NotificationEndpoint;
+        attributes?: string[];
+        format?: NotificationFormat;
+    };
+    throttling?: number;
+    expiresAt?: string;
+}
+/**
+ * A fully hydrated subscription record (as stored in the DB).
+ */
+export interface Subscription {
+    id: string;
+    name?: string;
+    description?: string;
+    entityTypes: string[];
+    watchedAttributes?: string[];
+    q?: string;
+    notificationEndpoint: string;
+    notificationFormat: NotificationFormat;
+    notificationAttrs?: string[];
+    throttling: number;
+    expiresAt?: string;
+    isActive: boolean;
+    lastNotificationAt?: string;
+    lastSuccessAt?: string;
+    timesSent: number;
+    timesFailed: number;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/types/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,WAAW,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,YAAY,EAAE;QACV,QAAQ,EAAE,oBAAoB,CAAA;QAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;QACrB,MAAM,CAAC,EAAE,kBAAkB,CAAA;KAC9B,CAAA;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,oBAAoB,EAAE,MAAM,CAAA;IAC5B,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACpB"}

package/dist/types/subscription.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subscription.js.map

package/dist/types/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@cepseudo/ngsi-ld",
+  "version": "1.0.0",
+  "description": "NGSI-LD plugin for Digital Twin framework (entities, subscriptions, notifications)",
+  "license": "MIT",
+  "author": "Axel Hoffmann",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "test": "node -r ./bin/set-test-env.cjs --import ts-node-maintained/register/esm --enable-source-maps bin/test.ts",
+    "lint": "eslint src tests --no-error-on-unmatched-pattern",
+    "lint:fix": "eslint src tests --fix --no-error-on-unmatched-pattern"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@cepseudo/components": "workspace:*",
+    "@cepseudo/database": "workspace:*",
+    "@cepseudo/shared": "workspace:*"
+  },
+  "peerDependencies": {
+    "bullmq": ">=5.0.0",
+    "ioredis": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@japa/assert": "^4.1.0",
+    "@japa/runner": "^4.3.0",
+    "@testcontainers/postgresql": "^11.12.0",
+    "@testcontainers/redis": "^11.3.1",
+    "better-sqlite3": "^12.6.0",
+    "bullmq": "^5.0.0",
+    "ioredis": "^5.0.0",
+    "pg": "^8.20.0",
+    "rimraf": "^6.0.1",
+    "testcontainers": "^11.3.1",
+    "ts-node-maintained": "^10.9.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CePseudoBE/digitaltwin.git",
+    "directory": "packages/ngsi-ld"
+  },
+  "keywords": [
+    "digitaltwin",
+    "ngsi-ld",
+    "etsi",
+    "iot",
+    "smart-data-models",
+    "subscriptions"
+  ],
+  "bugs": {
+    "url": "https://github.com/CePseudoBE/digitaltwin/issues"
+  },
+  "homepage": "https://github.com/CePseudoBE/digitaltwin#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}