@cepseudo/ngsi-ld 1.0.0

package/dist/components/type_guards.d.ts

@@ -0,0 +1,15 @@
+import type { NgsiLdCollector } from './ngsi_ld_collector.js';
+import type { NgsiLdHarvester } from './ngsi_ld_harvester.js';
+/**
+ * Duck-type guard: checks if a component implements the NgsiLdCollector contract.
+ *
+ * Uses structural typing to avoid a hard import of NgsiLdCollector in the engine.
+ */
+export declare function isNgsiLdCollector(component: unknown): component is NgsiLdCollector;
+/**
+ * Duck-type guard: checks if a component implements the NgsiLdHarvester contract.
+ *
+ * Uses structural typing to avoid a hard import of NgsiLdHarvester in the engine.
+ */
+export declare function isNgsiLdHarvester(component: unknown): component is NgsiLdHarvester;
+//# sourceMappingURL=type_guards.d.ts.map

package/dist/components/type_guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type_guards.d.ts","sourceRoot":"","sources":["../../src/components/type_guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,eAAe,CAQlF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,eAAe,CAQlF"}

package/dist/components/type_guards.js

@@ -0,0 +1,25 @@
+/**
+ * Duck-type guard: checks if a component implements the NgsiLdCollector contract.
+ *
+ * Uses structural typing to avoid a hard import of NgsiLdCollector in the engine.
+ */
+export function isNgsiLdCollector(component) {
+    return (component !== null &&
+        typeof component === 'object' &&
+        typeof component.toNgsiLdEntity === 'function' &&
+        typeof component.collect === 'function' &&
+        typeof component.getSchedule === 'function');
+}
+/**
+ * Duck-type guard: checks if a component implements the NgsiLdHarvester contract.
+ *
+ * Uses structural typing to avoid a hard import of NgsiLdHarvester in the engine.
+ */
+export function isNgsiLdHarvester(component) {
+    return (component !== null &&
+        typeof component === 'object' &&
+        typeof component.toNgsiLdEntity === 'function' &&
+        typeof component.harvest === 'function' &&
+        typeof component.getUserConfiguration === 'function');
+}
+//# sourceMappingURL=type_guards.js.map

package/dist/components/type_guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type_guards.js","sourceRoot":"","sources":["../../src/components/type_guards.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAkB;IAChD,OAAO,CACH,SAAS,KAAK,IAAI;QAClB,OAAO,SAAS,KAAK,QAAQ;QAC7B,OAAQ,SAA6B,CAAC,cAAc,KAAK,UAAU;QACnE,OAAQ,SAA6B,CAAC,OAAO,KAAK,UAAU;QAC5D,OAAQ,SAA6B,CAAC,WAAW,KAAK,UAAU,CACnE,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAkB;IAChD,OAAO,CACH,SAAS,KAAK,IAAI;QAClB,OAAO,SAAS,KAAK,QAAQ;QAC7B,OAAQ,SAA6B,CAAC,cAAc,KAAK,UAAU;QACnE,OAAQ,SAA6B,CAAC,OAAO,KAAK,UAAU;QAC5D,OAAQ,SAA6B,CAAC,oBAAoB,KAAK,UAAU,CAC5E,CAAA;AACL,CAAC"}

package/dist/endpoints/attrs.d.ts

@@ -0,0 +1,7 @@
+import type { Router } from 'ultimate-express';
+import type { EntityCache } from '../cache/entity_cache.js';
+/**
+ * Registers the NGSI-LD attrs endpoint on the provided router.
+ */
+export declare function registerAttrsEndpoints(router: Router, entityCache: EntityCache): void;
+//# sourceMappingURL=attrs.d.ts.map

package/dist/endpoints/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../src/endpoints/attrs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAkCrF"}

package/dist/endpoints/attrs.js

@@ -0,0 +1,37 @@
+/**
+ * Registers the NGSI-LD attrs endpoint on the provided router.
+ */
+export function registerAttrsEndpoints(router, entityCache) {
+    /**
+     * PATCH /ngsi-ld/v1/entities/:entityId/attrs
+     * Append or update attributes on an existing entity (partial update).
+     */
+    router.patch('/ngsi-ld/v1/entities/:entityId/attrs', async (req, res) => {
+        const entityId = decodeURIComponent(req.params['entityId']);
+        try {
+            const existing = await entityCache.get(entityId);
+            if (!existing) {
+                res.status(404).json({
+                    type: 'https://uri.etsi.org/ngsi-ld/errors/ResourceNotFound',
+                    title: 'Entity not found',
+                });
+                return;
+            }
+            const attrsFragment = req.body;
+            // Merge attributes into the existing entity (NGSI-LD PATCH semantics)
+            const merged = {
+                ...existing,
+                ...attrsFragment,
+                // Preserve immutable fields
+                id: existing.id,
+                type: existing.type,
+            };
+            await entityCache.set(merged);
+            res.status(204).end();
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+}
+//# sourceMappingURL=attrs.js.map

package/dist/endpoints/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../src/endpoints/attrs.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,WAAwB;IAC3E;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACvF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAW,CAAC,CAAA;QAErE,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACjB,IAAI,EAAE,sDAAsD;oBAC5D,KAAK,EAAE,kBAAkB;iBAC5B,CAAC,CAAA;gBACF,OAAM;YACV,CAAC;YAED,MAAM,aAAa,GAAG,GAAG,CAAC,IAA6B,CAAA;YACvD,sEAAsE;YACtE,MAAM,MAAM,GAAiB;gBACzB,GAAG,QAAQ;gBACX,GAAG,aAAa;gBAChB,4BAA4B;gBAC5B,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;aACtB,CAAA;YAED,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAC7B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAA;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mDAAmD,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3G,CAAC;IACL,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/endpoints/entities.d.ts

@@ -0,0 +1,9 @@
+import type { Router } from 'ultimate-express';
+import type { EntityCache } from '../cache/entity_cache.js';
+import type { SubscriptionStore } from '../subscriptions/subscription_store.js';
+import type { SubscriptionCache } from '../subscriptions/subscription_cache.js';
+/**
+ * Registers NGSI-LD entity endpoints on the provided router.
+ */
+export declare function registerEntityEndpoints(router: Router, entityCache: EntityCache, _subscriptionStore: SubscriptionStore, _subscriptionCache: SubscriptionCache): void;
+//# sourceMappingURL=entities.d.ts.map

package/dist/endpoints/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/endpoints/entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAa/E;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,kBAAkB,EAAE,iBAAiB,EACrC,kBAAkB,EAAE,iBAAiB,GACtC,IAAI,CA8IN"}

package/dist/endpoints/entities.js

@@ -0,0 +1,149 @@
+import { NGSI_LD_CORE_CONTEXT } from '../types/context.js';
+import { parseQ, evaluateQ } from '../subscriptions/q_parser.js';
+const LD_JSON = 'application/ld+json';
+function withContext(entity) {
+    return {
+        ...entity,
+        '@context': entity['@context'] ?? NGSI_LD_CORE_CONTEXT,
+    };
+}
+/**
+ * Registers NGSI-LD entity endpoints on the provided router.
+ */
+export function registerEntityEndpoints(router, entityCache, _subscriptionStore, _subscriptionCache) {
+    /**
+     * GET /ngsi-ld/v1/entities
+     * Query entities by type, q-filter, attributes, pagination.
+     */
+    router.get('/ngsi-ld/v1/entities', async (req, res) => {
+        const type = req.query['type'];
+        const q = req.query['q'];
+        const attrs = req.query['attrs'];
+        const limit = parseInt(String(req.query['limit'] ?? '20'), 10);
+        const offset = parseInt(String(req.query['offset'] ?? '0'), 10);
+        try {
+            let entities = await entityCache.list({ type, limit, offset });
+            // Apply q-filter
+            if (q) {
+                try {
+                    const expr = parseQ(q);
+                    entities = entities.filter(e => evaluateQ(expr, e));
+                }
+                catch {
+                    res.status(400).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/BadRequestData', title: 'Invalid q filter' });
+                    return;
+                }
+            }
+            // Project attributes
+            if (attrs) {
+                const attrsArray = attrs.split(',').map(a => a.trim());
+                entities = entities.map(e => {
+                    const projected = { id: e.id, type: e.type };
+                    for (const attr of attrsArray) {
+                        if (e[attr] !== undefined)
+                            projected[attr] = e[attr];
+                    }
+                    return withContext(projected);
+                });
+            }
+            else {
+                entities = entities.map(withContext);
+            }
+            res.setHeader('Content-Type', LD_JSON);
+            res.status(200).json(entities);
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * POST /ngsi-ld/v1/entities
+     * Create or replace an entity in the cache.
+     */
+    router.post('/ngsi-ld/v1/entities', async (req, res) => {
+        const body = req.body;
+        if (!body || !body.id || !body.type) {
+            res.status(400).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/BadRequestData', title: 'Missing id or type' });
+            return;
+        }
+        try {
+            await entityCache.set(body);
+            res.setHeader('Location', `/ngsi-ld/v1/entities/${encodeURIComponent(body.id)}`);
+            res.status(201).end();
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * GET /ngsi-ld/v1/entities/:entityId
+     */
+    router.get('/ngsi-ld/v1/entities/:entityId', async (req, res) => {
+        const entityId = decodeURIComponent(req.params['entityId']);
+        const attrs = req.query['attrs'];
+        try {
+            let entity = await entityCache.get(entityId);
+            if (!entity) {
+                res.status(404).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/ResourceNotFound', title: 'Entity not found' });
+                return;
+            }
+            if (attrs) {
+                const attrsArray = attrs.split(',').map(a => a.trim());
+                const projected = { id: entity.id, type: entity.type };
+                for (const attr of attrsArray) {
+                    if (entity[attr] !== undefined)
+                        projected[attr] = entity[attr];
+                }
+                entity = withContext(projected);
+            }
+            else {
+                entity = withContext(entity);
+            }
+            res.setHeader('Content-Type', LD_JSON);
+            res.status(200).json(entity);
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * PATCH /ngsi-ld/v1/entities/:entityId
+     * Merge-patch an entity.
+     */
+    router.patch('/ngsi-ld/v1/entities/:entityId', async (req, res) => {
+        const entityId = decodeURIComponent(req.params['entityId']);
+        try {
+            const existing = await entityCache.get(entityId);
+            if (!existing) {
+                res.status(404).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/ResourceNotFound', title: 'Entity not found' });
+                return;
+            }
+            const patch = req.body;
+            const merged = { ...existing, ...patch, id: existing.id, type: existing.type };
+            await entityCache.set(merged);
+            res.status(204).end();
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * DELETE /ngsi-ld/v1/entities/:entityId
+     */
+    router.delete('/ngsi-ld/v1/entities/:entityId', async (req, res) => {
+        const entityId = decodeURIComponent(req.params['entityId']);
+        try {
+            const existing = await entityCache.get(entityId);
+            if (!existing) {
+                res.status(404).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/ResourceNotFound', title: 'Entity not found' });
+                return;
+            }
+            await entityCache.delete(entityId);
+            res.status(204).end();
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+}
+//# sourceMappingURL=entities.js.map

package/dist/endpoints/entities.js.map

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

package/dist/endpoints/subscriptions.d.ts

@@ -0,0 +1,8 @@
+import type { Router } from 'ultimate-express';
+import type { SubscriptionStore } from '../subscriptions/subscription_store.js';
+import type { SubscriptionCache } from '../subscriptions/subscription_cache.js';
+/**
+ * Registers NGSI-LD subscription CRUD endpoints on the provided router.
+ */
+export declare function registerSubscriptionEndpoints(router: Router, store: SubscriptionStore, cache: SubscriptionCache): void;
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/endpoints/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/endpoints/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAG/E;;GAEG;AACH,wBAAgB,6BAA6B,CACzC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,iBAAiB,GACzB,IAAI,CA4GN"}

package/dist/endpoints/subscriptions.js

@@ -0,0 +1,109 @@
+/**
+ * Registers NGSI-LD subscription CRUD endpoints on the provided router.
+ */
+export function registerSubscriptionEndpoints(router, store, cache) {
+    /**
+     * POST /ngsi-ld/v1/subscriptions
+     * Create a new subscription.
+     */
+    router.post('/ngsi-ld/v1/subscriptions', async (req, res) => {
+        const body = req.body;
+        if (!body?.notification?.endpoint?.uri) {
+            res.status(400).json({
+                type: 'https://uri.etsi.org/ngsi-ld/errors/BadRequestData',
+                title: 'Missing notification.endpoint.uri',
+            });
+            return;
+        }
+        try {
+            const sub = await store.create(body);
+            await cache.add(sub);
+            res.setHeader('Location', `/ngsi-ld/v1/subscriptions/${sub.id}`);
+            res.setHeader('Content-Type', 'application/ld+json');
+            res.status(201).json(sub);
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * GET /ngsi-ld/v1/subscriptions
+     * List all active subscriptions.
+     */
+    router.get('/ngsi-ld/v1/subscriptions', async (_req, res) => {
+        try {
+            const subs = await store.findAll();
+            res.setHeader('Content-Type', 'application/ld+json');
+            res.status(200).json(subs);
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * GET /ngsi-ld/v1/subscriptions/:subscriptionId
+     */
+    router.get('/ngsi-ld/v1/subscriptions/:subscriptionId', async (req, res) => {
+        const id = req.params['subscriptionId'];
+        try {
+            const sub = await store.findById(id);
+            if (!sub) {
+                res.status(404).json({
+                    type: 'https://uri.etsi.org/ngsi-ld/errors/ResourceNotFound',
+                    title: 'Subscription not found',
+                });
+                return;
+            }
+            res.setHeader('Content-Type', 'application/ld+json');
+            res.status(200).json(sub);
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * PATCH /ngsi-ld/v1/subscriptions/:subscriptionId
+     * Partially update a subscription.
+     */
+    router.patch('/ngsi-ld/v1/subscriptions/:subscriptionId', async (req, res) => {
+        const id = req.params['subscriptionId'];
+        const patch = req.body;
+        try {
+            const updated = await store.update(id, patch);
+            if (!updated) {
+                res.status(404).json({
+                    type: 'https://uri.etsi.org/ngsi-ld/errors/ResourceNotFound',
+                    title: 'Subscription not found',
+                });
+                return;
+            }
+            await cache.update(updated);
+            res.status(204).end();
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+    /**
+     * DELETE /ngsi-ld/v1/subscriptions/:subscriptionId
+     */
+    router.delete('/ngsi-ld/v1/subscriptions/:subscriptionId', async (req, res) => {
+        const id = req.params['subscriptionId'];
+        try {
+            const deleted = await store.delete(id);
+            if (!deleted) {
+                res.status(404).json({
+                    type: 'https://uri.etsi.org/ngsi-ld/errors/ResourceNotFound',
+                    title: 'Subscription not found',
+                });
+                return;
+            }
+            await cache.remove(id);
+            res.status(204).end();
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/endpoints/subscriptions.js.map

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

package/dist/endpoints/types.d.ts

@@ -0,0 +1,7 @@
+import type { Router } from 'ultimate-express';
+import type { EntityCache } from '../cache/entity_cache.js';
+/**
+ * Registers the NGSI-LD types endpoint on the provided router.
+ */
+export declare function registerTypesEndpoints(router: Router, entityCache: EntityCache): void;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/endpoints/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CA0CrF"}

package/dist/endpoints/types.js

@@ -0,0 +1,45 @@
+import { NGSI_LD_CORE_CONTEXT } from '../types/context.js';
+/**
+ * Registers the NGSI-LD types endpoint on the provided router.
+ */
+export function registerTypesEndpoints(router, entityCache) {
+    /**
+     * GET /ngsi-ld/v1/types
+     * Returns a summary of all known entity types.
+     */
+    router.get('/ngsi-ld/v1/types', async (_req, res) => {
+        try {
+            const types = await entityCache.listTypes();
+            const typeDetails = await Promise.all(types.map(async (type) => {
+                const entities = await entityCache.listByType(type);
+                const attributeNames = new Set();
+                for (const entity of entities) {
+                    for (const key of Object.keys(entity)) {
+                        if (key !== 'id' && key !== 'type' && key !== '@context') {
+                            attributeNames.add(key);
+                        }
+                    }
+                }
+                return {
+                    id: `urn:ngsi-ld:EntityTypeInfo:${type}`,
+                    type: 'EntityTypeInfo',
+                    typeName: type,
+                    entityCount: entities.length,
+                    attributeNames: Array.from(attributeNames),
+                };
+            }));
+            res.setHeader('Content-Type', 'application/ld+json');
+            res.status(200).json({
+                id: 'urn:ngsi-ld:EntityTypeList:default',
+                type: 'EntityTypeList',
+                typeList: types,
+                typeDetails,
+                '@context': NGSI_LD_CORE_CONTEXT,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ type: 'https://uri.etsi.org/ngsi-ld/errors/InternalError', title: String(err) });
+        }
+    });
+}
+//# sourceMappingURL=types.js.map

package/dist/endpoints/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/endpoints/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,WAAwB;IAC3E;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QACnE,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,CAAA;YAE3C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAC,IAAI,EAAC,EAAE;gBACnB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;gBACnD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAA;gBACxC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;oBAC5B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;wBACpC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;4BACvD,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;wBAC3B,CAAC;oBACL,CAAC;gBACL,CAAC;gBACD,OAAO;oBACH,EAAE,EAAE,8BAA8B,IAAI,EAAE;oBACxC,IAAI,EAAE,gBAAgB;oBACtB,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,QAAQ,CAAC,MAAM;oBAC5B,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC;iBAC7C,CAAA;YACL,CAAC,CAAC,CACL,CAAA;YAED,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAA;YACpD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACjB,EAAE,EAAE,oCAAoC;gBACxC,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,KAAK;gBACf,WAAW;gBACX,UAAU,EAAE,oBAAoB;aACnC,CAAC,CAAA;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mDAAmD,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3G,CAAC;IACL,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/helpers/property.d.ts

@@ -0,0 +1,33 @@
+import type { NgsiLdProperty, NgsiLdGeoProperty, NgsiLdRelationship, GeoJsonGeometry } from '../types/entity.js';
+/**
+ * Creates an NGSI-LD Property attribute.
+ *
+ * @param value - The property value
+ * @param meta - Optional metadata (observedAt, unitCode, etc.)
+ */
+export declare function property<T>(value: T, meta?: {
+    observedAt?: string;
+    unitCode?: string;
+    [key: string]: unknown;
+}): NgsiLdProperty<T>;
+/**
+ * Creates an NGSI-LD GeoProperty attribute.
+ *
+ * @param geojson - A GeoJSON geometry object
+ * @param meta - Optional metadata (observedAt, etc.)
+ */
+export declare function geoProperty(geojson: GeoJsonGeometry, meta?: {
+    observedAt?: string;
+    [key: string]: unknown;
+}): NgsiLdGeoProperty;
+/**
+ * Creates an NGSI-LD Relationship attribute.
+ *
+ * @param urn - The URN of the related entity
+ * @param meta - Optional metadata (observedAt, etc.)
+ */
+export declare function relationship(urn: string, meta?: {
+    observedAt?: string;
+    [key: string]: unknown;
+}): NgsiLdRelationship;
+//# sourceMappingURL=property.d.ts.map

package/dist/helpers/property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../src/helpers/property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEhH;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACtB,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC1E,cAAc,CAAC,CAAC,CAAC,CAMnB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACvD,iBAAiB,CAMnB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACvD,kBAAkB,CAMpB"}

package/dist/helpers/property.js

@@ -0,0 +1,40 @@
+/**
+ * Creates an NGSI-LD Property attribute.
+ *
+ * @param value - The property value
+ * @param meta - Optional metadata (observedAt, unitCode, etc.)
+ */
+export function property(value, meta) {
+    return {
+        type: 'Property',
+        value,
+        ...meta
+    };
+}
+/**
+ * Creates an NGSI-LD GeoProperty attribute.
+ *
+ * @param geojson - A GeoJSON geometry object
+ * @param meta - Optional metadata (observedAt, etc.)
+ */
+export function geoProperty(geojson, meta) {
+    return {
+        type: 'GeoProperty',
+        value: geojson,
+        ...meta
+    };
+}
+/**
+ * Creates an NGSI-LD Relationship attribute.
+ *
+ * @param urn - The URN of the related entity
+ * @param meta - Optional metadata (observedAt, etc.)
+ */
+export function relationship(urn, meta) {
+    return {
+        type: 'Relationship',
+        object: urn,
+        ...meta
+    };
+}
+//# sourceMappingURL=property.js.map

package/dist/helpers/property.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.js","sourceRoot":"","sources":["../../src/helpers/property.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACpB,KAAQ,EACR,IAAyE;IAEzE,OAAO;QACH,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,GAAG,IAAI;KACV,CAAA;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACvB,OAAwB,EACxB,IAAsD;IAEtD,OAAO;QACH,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,OAAO;QACd,GAAG,IAAI;KACV,CAAA;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CACxB,GAAW,EACX,IAAsD;IAEtD,OAAO;QACH,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,GAAG;QACX,GAAG,IAAI;KACV,CAAA;AACL,CAAC"}

package/dist/helpers/urn.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Builds an NGSI-LD URN from a type and local identifier.
+ *
+ * @example
+ * buildUrn('AirQualityObserved', 'sensor-42')
+ * // => 'urn:ngsi-ld:AirQualityObserved:sensor-42'
+ */
+export declare function buildUrn(type: string, localId: string): string;
+/**
+ * Result of parsing an NGSI-LD URN.
+ */
+export interface ParsedUrn {
+    type: string;
+    localId: string;
+}
+/**
+ * Parses an NGSI-LD URN into its type and local identifier components.
+ *
+ * @throws {Error} When the URN does not conform to the `urn:ngsi-ld:<type>:<localId>` format.
+ *
+ * @example
+ * parseUrn('urn:ngsi-ld:AirQualityObserved:sensor-42')
+ * // => { type: 'AirQualityObserved', localId: 'sensor-42' }
+ */
+export declare function parseUrn(urn: string): ParsedUrn;
+//# sourceMappingURL=urn.d.ts.map

package/dist/helpers/urn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urn.d.ts","sourceRoot":"","sources":["../../src/helpers/urn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAS/C"}

package/dist/helpers/urn.js

@@ -0,0 +1,30 @@
+/**
+ * Builds an NGSI-LD URN from a type and local identifier.
+ *
+ * @example
+ * buildUrn('AirQualityObserved', 'sensor-42')
+ * // => 'urn:ngsi-ld:AirQualityObserved:sensor-42'
+ */
+export function buildUrn(type, localId) {
+    return `urn:ngsi-ld:${type}:${localId}`;
+}
+/**
+ * Parses an NGSI-LD URN into its type and local identifier components.
+ *
+ * @throws {Error} When the URN does not conform to the `urn:ngsi-ld:<type>:<localId>` format.
+ *
+ * @example
+ * parseUrn('urn:ngsi-ld:AirQualityObserved:sensor-42')
+ * // => { type: 'AirQualityObserved', localId: 'sensor-42' }
+ */
+export function parseUrn(urn) {
+    const parts = urn.split(':');
+    if (parts.length < 4 || parts[0] !== 'urn' || parts[1] !== 'ngsi-ld') {
+        throw new Error(`Invalid NGSI-LD URN format: "${urn}". Expected "urn:ngsi-ld:<type>:<localId>"`);
+    }
+    // type is index 2, localId is everything from index 3 onward (supports colons in localId)
+    const type = parts[2];
+    const localId = parts.slice(3).join(':');
+    return { type, localId };
+}
+//# sourceMappingURL=urn.js.map

package/dist/helpers/urn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urn.js","sourceRoot":"","sources":["../../src/helpers/urn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe;IAClD,OAAO,eAAe,IAAI,IAAI,OAAO,EAAE,CAAA;AAC3C,CAAC;AAUD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,4CAA4C,CAAC,CAAA;IACpG,CAAC;IACD,0FAA0F;IAC1F,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAC5B,CAAC"}