kuzzle-device-manager 3.0.0-3-dev.19 → 3.0.0-3-dev.21

package/dist/bin/migration/migrate-tenant-classes.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/migration/migrate-tenant-classes.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+"use strict";
+/* eslint-disable no-console */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Renames the `engineGroups` field of the model documents to `tenantClasses`,
+ * then updates every device-manager engine so the tenant collections get the
+ * mappings of the migrated models.
+ *
+ * Run it against a Kuzzle that already runs the new Device Manager version.
+ * See doc/3/guides/rename-engine-groups-to-tenant-classes.
+ */
+const kuzzle_sdk_1 = require("kuzzle-sdk");
+const args = {};
+for (const val of process.argv.slice(2)) {
+    if (val.startsWith("--")) {
+        const [key, ...value] = val.slice(2).split("=");
+        args[key] = value.length > 0 ? value.join("=") : true;
+    }
+}
+function option(name, env, defaultValue) {
+    const value = args[name] ?? process.env[env] ?? defaultValue;
+    return typeof value === "string" ? value : undefined;
+}
+const host = option("host", "KUZZLE_HOST", "localhost");
+const port = Number(option("port", "KUZZLE_PORT", "7512"));
+const protocol = option("protocol", "KUZZLE_PROTOCOL", "websocket");
+const ssl = args.ssl === true || process.env.KUZZLE_SSL === "true";
+const username = option("username", "KUZZLE_USERNAME");
+const password = option("password", "KUZZLE_PASSWORD");
+const platformIndex = option("platform-index", "PLATFORM_INDEX", "device-manager");
+const dryRun = args["dry-run"] === true;
+const skipEngines = args["skip-engines"] === true;
+const MODELS = "models";
+const CHUNK_SIZE = 200;
+async function connect() {
+    const Protocol = protocol === "http" ? kuzzle_sdk_1.Http : kuzzle_sdk_1.WebSocket;
+    const sdk = new kuzzle_sdk_1.Kuzzle(new Protocol(host, { port, ssl }));
+    await sdk.connect();
+    if (username) {
+        await sdk.auth.login("local", { password, username });
+    }
+    return sdk;
+}
+async function assertNewMappings(sdk) {
+    const mappings = await sdk.collection.getMapping(platformIndex, MODELS);
+    if (!mappings.properties?.tenantClasses) {
+        throw new Error(`The "${platformIndex}:${MODELS}" collection has no "tenantClasses" field. ` +
+            "Start Kuzzle with the new Device Manager version before running this script.");
+    }
+}
+async function fetchLegacyModels(sdk) {
+    const documents = [];
+    let result = await sdk.document.search(platformIndex, MODELS, { query: { exists: { field: "engineGroups" } } }, { lang: "elasticsearch", scroll: "1m", size: CHUNK_SIZE });
+    while (result) {
+        documents.push(...result.hits);
+        result = await result.next();
+    }
+    return documents;
+}
+async function migrateModels(sdk) {
+    const legacyModels = await fetchLegacyModels(sdk);
+    console.info(`${legacyModels.length} model(s) still use "engineGroups"`);
+    const documents = legacyModels.map(({ _id, _source }) => {
+        const { engineGroups, ...body } = _source;
+        delete body._kuzzle_info;
+        // A model registered by the application at startup may already have
+        // been rewritten with `tenantClasses`: the new value wins.
+        body.tenantClasses ?? (body.tenantClasses = engineGroups);
+        console.info(`  ${_id}: ${JSON.stringify(body.tenantClasses)}`);
+        return { _id, body };
+    });
+    if (dryRun) {
+        return;
+    }
+    for (let i = 0; i < documents.length; i += CHUNK_SIZE) {
+        const { errors } = await sdk.document.mReplace(platformIndex, MODELS, documents.slice(i, i + CHUNK_SIZE), { refresh: "wait_for" });
+        if (errors.length > 0) {
+            for (const error of errors) {
+                console.error(`  Cannot migrate ${error.document._id}: ${error.reason}`);
+            }
+            throw new Error(`${errors.length} model(s) could not be migrated`);
+        }
+    }
+    const remaining = await sdk.document.count(platformIndex, MODELS, {
+        query: { exists: { field: "engineGroups" } },
+    });
+    if (remaining > 0) {
+        throw new Error(`${remaining} model(s) still use "engineGroups"`);
+    }
+}
+async function updateEngines(sdk) {
+    const { result } = await sdk.query({
+        action: "list",
+        controller: "device-manager/engine",
+    });
+    const engines = result.engines;
+    console.info(`Updating ${engines.length} engine(s)`);
+    for (const engine of engines) {
+        console.info(`  ${engine.index} (${engine.group})`);
+        if (dryRun) {
+            continue;
+        }
+        await sdk.query({
+            action: "update",
+            controller: "device-manager/engine",
+            group: engine.group,
+            index: engine.index,
+        });
+    }
+}
+async function run() {
+    const sdk = await connect();
+    try {
+        if (dryRun) {
+            console.info("Dry run: nothing will be written");
+        }
+        await assertNewMappings(sdk);
+        await migrateModels(sdk);
+        if (!skipEngines) {
+            await updateEngines(sdk);
+        }
+        console.info("Done");
+    }
+    finally {
+        sdk.disconnect();
+    }
+}
+run().catch((error) => {
+    console.error(error.message ?? error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=migrate-tenant-classes.js.map

package/dist/bin/migration/migrate-tenant-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-tenant-classes.js","sourceRoot":"","sources":["../../../bin/migration/migrate-tenant-classes.ts"],"names":[],"mappings":";;AACA,+BAA+B;;AAE/B;;;;;;;GAOG;AAEH,2CAAiE;AAEjE,MAAM,IAAI,GAAkC,EAAE,CAAC;AAC/C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,GAAW,EAAE,YAAqB;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;IAC7D,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AACxD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAC;AACpE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC;AACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACvD,MAAM,aAAa,GAAG,MAAM,CAC1B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,CACjB,CAAC;AACF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AACxC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;AAElD,MAAM,MAAM,GAAG,QAAQ,CAAC;AACxB,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,KAAK,UAAU,OAAO;IACpB,MAAM,QAAQ,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAI,CAAC,CAAC,CAAC,sBAAS,CAAC;IACxD,MAAM,GAAG,GAAG,IAAI,mBAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAE1D,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAEpB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAExE,IAAI,CAAE,QAAQ,CAAC,UAAyB,EAAE,aAAa,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,QAAQ,aAAa,IAAI,MAAM,6CAA6C;YAC1E,8EAA8E,CACjF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,MAAM,SAAS,GAAgD,EAAE,CAAC;IAClE,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CACpC,aAAa,EACb,MAAM,EACN,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,EAChD,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAC1D,CAAC;IAEF,OAAO,MAAM,EAAE,CAAC;QACd,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAElD,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,oCAAoC,CAAC,CAAC;IAEzE,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QACtD,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAC1C,OAAO,IAAI,CAAC,YAAY,CAAC;QAEzB,oEAAoE;QACpE,2DAA2D;QAC3D,IAAI,CAAC,aAAa,KAAlB,IAAI,CAAC,aAAa,GAAK,YAAY,EAAC;QAEpC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAEhE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;QACtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAC5C,aAAa,EACb,MAAM,EACN,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,EAClC,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CACX,oBAAoB,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,KAAK,CAAC,MAAM,EAAE,CAC1D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,iCAAiC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE;QAChE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;KAC7C,CAAC,CAAC;IAEH,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,oCAAoC,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC;QACjC,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,uBAAuB;KACpC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAkD,CAAC;IAE1E,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;IAErD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QAEpD,IAAI,MAAM,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QAED,MAAM,GAAG,CAAC,KAAK,CAAC;YACd,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,uBAAuB;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAEzB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,UAAU,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/lib/modules/asset/AssetHistoryService.d.ts

@@ -5,5 +5,5 @@ import { KuzzleLogger } from "kuzzle-logger";
 export declare class AssetHistoryService extends BaseService {
     readonly logger: KuzzleLogger;
     constructor(plugin: DeviceManagerPlugin, assetLogger: KuzzleLogger);
-    add<TAssetHistoryEvent extends AssetHistoryEvent>(engineId: string, histories: AssetHistoryContent[]): Promise<void>;
+    add<TAssetHistoryEvent extends AssetHistoryEvent>(index: string, histories: AssetHistoryContent[]): Promise<void>;
 }

package/dist/lib/modules/asset/AssetHistoryService.js

@@ -8,9 +8,9 @@ class AssetHistoryService extends shared_1.BaseService {
     constructor(plugin, assetLogger) {
         super(plugin);
         this.logger = assetLogger;
-        (0, kuzzle_plugin_commons_1.onAsk)("ask:device-manager:asset:history:add", async ({ engineId, histories }) => this.add(engineId, histories));
+        (0, kuzzle_plugin_commons_1.onAsk)("ask:device-manager:asset:history:add", async ({ index, histories }) => this.add(index, histories));
     }
-    async add(engineId, histories) {
+    async add(index, histories) {
         const contents = [];
         for (const { asset, event, id, timestamp } of histories) {
             contents.push({
@@ -22,7 +22,7 @@ class AssetHistoryService extends shared_1.BaseService {
                 },
             });
         }
-        await this.sdk.document.mCreate(engineId, plugin_1.InternalCollection.ASSETS_HISTORY, contents, { strict: true });
+        await this.sdk.document.mCreate(index, plugin_1.InternalCollection.ASSETS_HISTORY, contents, { strict: true });
     }
 }
 exports.AssetHistoryService = AssetHistoryService;

package/dist/lib/modules/asset/AssetHistoryService.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetHistoryService.js","sourceRoot":"","sources":["../../../../lib/modules/asset/AssetHistoryService.ts"],"names":[],"mappings":";;;AAAA,iEAA8C;AAG9C,sCAAoE;AACpE,sCAAwC;AASxC,MAAa,mBAAoB,SAAQ,oBAAW;IAElD,YAAY,MAA2B,EAAE,WAAyB;QAChE,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAA,6BAAK,EACH,sCAAsC,EACtC,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CACjE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,QAAgB,EAChB,SAAgC;QAEhC,MAAM,QAAQ,GAEV,EAAE,CAAC;QAEP,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,SAAS,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE;oBACJ,KAAK;oBACL,KAAK;oBACL,EAAE;oBACF,SAAS;iBACV;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAC7B,QAAQ,EACR,2BAAkB,CAAC,cAAc,EACjC,QAAQ,EACR,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;IACJ,CAAC;CACF;AArCD,kDAqCC"}
+{"version":3,"file":"AssetHistoryService.js","sourceRoot":"","sources":["../../../../lib/modules/asset/AssetHistoryService.ts"],"names":[],"mappings":";;;AAAA,iEAA8C;AAG9C,sCAAoE;AACpE,sCAAwC;AASxC,MAAa,mBAAoB,SAAQ,oBAAW;IAElD,YAAY,MAA2B,EAAE,WAAyB;QAChE,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAA,6BAAK,EACH,sCAAsC,EACtC,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAC3D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,KAAa,EACb,SAAgC;QAEhC,MAAM,QAAQ,GAEV,EAAE,CAAC;QAEP,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,SAAS,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE;oBACJ,KAAK;oBACL,KAAK;oBACL,EAAE;oBACF,SAAS;iBACV;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAC7B,KAAK,EACL,2BAAkB,CAAC,cAAc,EACjC,QAAQ,EACR,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;IACJ,CAAC;CACF;AArCD,kDAqCC"}

package/dist/lib/modules/asset/AssetService.d.ts

@@ -11,35 +11,35 @@ export declare class AssetService extends DigitalTwinService {
     readonly logger: KuzzleLogger;
     constructor(plugin: DeviceManagerPlugin, assetHistoryService: AssetHistoryService, assetLogger: KuzzleLogger);
     registerAskEvents(): void;
-    get(engineId: string, assetId: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    get(index: string, assetId: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
     /**
      * Update an asset metadata
      */
-    update(engineId: string, assetId: string, metadata: Metadata, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    update(index: string, assetId: string, metadata: Metadata, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
     /**
      * Replace an asset metadata
      */
-    replaceMetadata(engineId: string, assetId: string, metadata: Metadata, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    replaceMetadata(index: string, assetId: string, metadata: Metadata, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
     /**
      * Update or Create an asset metadata
      */
-    upsert(engineId: string, model: string, reference: string, metadata: Metadata, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    upsert(index: string, model: string, reference: string, metadata: Metadata, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
     private _create;
     /**
      * Create an asset metadata
      */
-    create(engineId: string, model: string, reference: string, metadata: JSONObject, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    create(index: string, model: string, reference: string, metadata: JSONObject, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
     /**
      * Delete an asset metadata
      */
-    delete(engineId: string, assetId: string, request: KuzzleRequest): Promise<void>;
-    search(engineId: string, searchParams: SearchParams, request: KuzzleRequest): Promise<SearchResult<KHit<AssetContent>>>;
+    delete(index: string, assetId: string, request: KuzzleRequest): Promise<void>;
+    search(index: string, searchParams: SearchParams, request: KuzzleRequest): Promise<SearchResult<KHit<AssetContent>>>;
     unlinkDevices(assetId: string, allMeasures: boolean, deviceIds: string[], measureSlots: string[], request: KuzzleRequest): Promise<ApiAssetUnlinkDevicesResult>;
-    migrateTenant(user: User, assetsList: string[], engineId: string, newEngineId: string, includeDevices: boolean, request: KuzzleRequest): Promise<ApiAssetMigrateTenantResult>;
+    migrateTenant(user: User, assetsList: string[], index: string, newIndex: string, includeDevices: boolean, request: KuzzleRequest): Promise<ApiAssetMigrateTenantResult>;
     /**
      * Replace an asset metadata
      */
-    mReplaceAndHistorize(engineId: string, assets: KDocument<AssetContent>[], removedMetadata: string[], { refresh }: {
+    mReplaceAndHistorize(index: string, assets: KDocument<AssetContent>[], removedMetadata: string[], { refresh }: {
         refresh: any;
     }): Promise<mReplaceResponse>;
     /**
@@ -49,13 +49,19 @@ export declare class AssetService extends DigitalTwinService {
      * @param model
      */
     updateModelLocales(request: KuzzleRequest, model: string): Promise<ApiAssetUpdateModelLocales[]>;
-    addMeasureSlot(assetId: string, measureSlot: AssetContent["measureSlots"][0], engineId: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
-    removeMeasureSlot(assetId: string, measureSlotName: string, engineId: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    addMeasureSlot(assetId: string, measureSlot: AssetContent["measureSlots"][0], index: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    removeMeasureSlot(assetId: string, measureSlotName: string, index: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
     /**
      * Update the display name of a measure slot on an asset
      */
     updateMeasureSlotDisplayName(assetId: string, measureSlotName: string, displayName: {
         [locale: string]: string;
-    }, engineId: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
+    }, index: string, request: KuzzleRequest): Promise<KDocument<AssetContent>>;
     private refreshModel;
+    /**
+     * Lists the engines whose assets use the given model:
+     * the model indexes for a tenant-scoped model, every engine for a commons model,
+     * and the engines of the model tenantClasses otherwise.
+     */
+    private getModelEngines;
 }