@intuitionrobotics/db-api-generator 0.47.58 → 1.0.0

package/LICENSE

@@ -0,0 +1,3 @@
+Apache License
+Version 2.0, January 2004
+Full license here: http://www.apache.org/licenses/LICENSE-2.0

package/{app-backend → dist/app-backend}/BaseDB_ApiGenerator.d.ts

@@ -1,7 +1,7 @@
-import { Clause_Where, DB_Object, FilterKeys, FirestoreQuery } from "@intuitionrobotics/firebase";
-import { Module, PartialProperties, ValidatorTypeResolver } from "@intuitionrobotics/ts-common";
-import { ServerApi_Create } from "./apis";
-import { ExpressRequest, FirestoreBackupDetails, OnFirestoreBackupSchedulerAct, ServerApi } from "@intuitionrobotics/thunderstorm/backend";
+import { type Clause_Where, type DB_Object, type FilterKeys, type FirestoreQuery } from "@intuitionrobotics/firebase";
+import { Module, type PartialProperties, type ValidatorTypeResolver } from "@intuitionrobotics/ts-common";
+import { ServerApi_Create } from "./apis.js";
+import { type ExpressRequest, type FirestoreBackupDetails, type OnFirestoreBackupSchedulerAct, ServerApi } from "@intuitionrobotics/thunderstorm/backend";
 import { FirestoreCollection, FirestoreTransaction } from "@intuitionrobotics/firebase/backend";
 export declare const validateId: (length: number, mandatory?: boolean) => import("@intuitionrobotics/ts-common").Validator<string>;
 export declare const validateEmail: import("@intuitionrobotics/ts-common").Validator<string>;
@@ -94,14 +94,14 @@ export declare abstract class BaseDB_ApiGenerator<DBType extends DB_Object, Conf
      *
      * @param item - The DB entry that will be used.
      */
-    protected internalFilter(item: DBType): Clause_Where<DBType>[];
+    protected internalFilter(_item: DBType): Clause_Where<DBType>[];
     /**
      * Override this method to customize the assertions that should be done before the insertion of the document to the DB.
      *
      * @param transaction - The transaction object.
      * @param dbInstance - The DB entry for which the uniqueness is being asserted.
      */
-    protected preUpsertProcessing(transaction: FirestoreTransaction, dbInstance: DBType, request?: ExpressRequest): Promise<void>;
+    protected preUpsertProcessing(_transaction: FirestoreTransaction, _dbInstance: DBType, _request?: ExpressRequest): Promise<void>;
     /**
      * Override this method to provide actions or assertions to be executed before the deletion happens.
      *
@@ -111,7 +111,7 @@ export declare abstract class BaseDB_ApiGenerator<DBType extends DB_Object, Conf
      * @param dbInstance - The DB entry that is going to be deleted.
      */
     protected assertDeletion(transaction: FirestoreTransaction, dbInstance: DBType, request?: ExpressRequest): Promise<void>;
-    protected assertDeletion_Read(transaction: FirestoreTransaction, dbInstance: DBType, request?: ExpressRequest): Promise<() => void>;
+    protected assertDeletion_Read(_transaction: FirestoreTransaction, _dbInstance: DBType, _request?: ExpressRequest): Promise<() => void>;
     /**
      * A wrapper of the collections's `runInTransaction`.
      *
@@ -212,7 +212,7 @@ export declare abstract class BaseDB_ApiGenerator<DBType extends DB_Object, Conf
      * @param query - The query to be executed for the deletion.
      * @param request - The request in order to possibly obtain more info.
      */
-    delete(query: FirestoreQuery<DBType>, request?: ExpressRequest): Promise<DBType[]>;
+    delete(query: FirestoreQuery<DBType>, _request?: ExpressRequest): Promise<DBType[]>;
     /**
      * Queries the database for a specific document in the module's collection.
      *
@@ -224,7 +224,7 @@ export declare abstract class BaseDB_ApiGenerator<DBType extends DB_Object, Conf
      * @returns
      * The DB document that was found.
      */
-    queryUnique(where: Clause_Where<DBType>, request?: ExpressRequest): Promise<DBType>;
+    queryUnique(where: Clause_Where<DBType>, _request?: ExpressRequest): Promise<DBType>;
     /**
      * Executes the specified query on the module's collection.
      *
@@ -234,7 +234,7 @@ export declare abstract class BaseDB_ApiGenerator<DBType extends DB_Object, Conf
      * @returns
      * A promise of an array of documents.
      */
-    query(query: FirestoreQuery<DBType>, request?: ExpressRequest): Promise<DBType[]>;
+    query(query: FirestoreQuery<DBType>, _request?: ExpressRequest): Promise<DBType[]>;
     /**
      * If propsToPatch is not set, we remove the lock keys from the caller's instance
      * before merging with the original dbInstance.
@@ -264,3 +264,4 @@ export declare abstract class BaseDB_ApiGenerator<DBType extends DB_Object, Conf
      */
     apis(pathPart?: string): ServerApi<any>[];
 }
+//# sourceMappingURL=BaseDB_ApiGenerator.d.ts.map

package/dist/app-backend/BaseDB_ApiGenerator.d.ts.map

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

package/dist/app-backend/BaseDB_ApiGenerator.js

@@ -0,0 +1,477 @@
+import {} from "@intuitionrobotics/firebase";
+import { __stringify, _keys, addItemToArray, BadImplementationException, batchAction, Day, filterDuplicates, filterInstances, generateHex, isErrorOfType, merge, Module, ThisShouldNotHappenException, validate, validateRegexp, ValidationException, validateEmail as _validateEmail } from "@intuitionrobotics/ts-common";
+import { ServerApi_Create, ServerApi_Delete, ServerApi_Query, ServerApi_Unique, ServerApi_Update } from "./apis.js";
+import { ApiException, ServerApi } from "@intuitionrobotics/thunderstorm/backend";
+import { FirebaseModule, FirestoreCollection, FirestoreInterface, FirestoreTransaction, } from "@intuitionrobotics/firebase/backend";
+import { ErrorKey_BadInput } from "../shared/types.js";
+const idLength = 32;
+export const validateId = (length, mandatory = true) => validateRegexp(new RegExp(`^[0-9a-f]{${length}}$`), mandatory);
+export const validateEmail = _validateEmail;
+export const validateBucketUrl = (mandatory) => validateRegexp(/gs?:\/\/[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,4}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)/, mandatory);
+export const validateGeneralUrl = (mandatory) => validateRegexp(/[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,4}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)/, mandatory);
+export const validateUniqueId = validateId(idLength);
+export const validateOptionalId = validateId(idLength, false);
+export const validateStringWithDashes = validateRegexp(/^[A-Za-z-]+$/);
+export const validateStringAndNumbersWithDashes = validateRegexp(/^[0-9A-Za-z-]+$/);
+export const validator_JavaObjectMemberName = validateRegexp(/^[a-z][a-zA-Z0-9]+$/);
+export const validateNameWithDashesAndDots = validateRegexp(/^[a-z-.]+$/);
+export const validator_LowercaseStringWithDashes = validateRegexp(/^[a-z-.]+$/);
+export const validator_LowerUpperStringWithSpaces = validateRegexp(/^[A-Za-z ]+$/);
+export const validator_LowerUpperStringWithDashesAndUnderscore = validateRegexp(/^[A-Za-z-_]+$/);
+export const validator_InternationalPhoneNumber = validateRegexp(/^\+(?:[0-9] ?){6,14}[0-9]$/);
+/**
+ * An abstract base class used for implementing CRUD operations on a specific collection.
+ *
+ * By default, it exposes API endpoints for creating, deleting, updating, querying and querying for unique document.
+ */
+export class BaseDB_ApiGenerator extends Module {
+    collection;
+    validator;
+    constructor(collectionName, validator, itemName, moduleName) {
+        super(moduleName);
+        // @ts-expect-error TS struggles with this dynamic typing
+        this.setDefaultConfig({ itemName, collectionName, externalFilterKeys: ["_id"], lockKeys: ["_id"] });
+        this.validator = validator;
+    }
+    setValidator(validator) {
+        this.validator = validator;
+    }
+    __onFirestoreBackupSchedulerAct() {
+        return [{
+                backupQuery: this.resolveBackupQuery(),
+                collection: this.collection,
+                keepInterval: 7 * Day,
+                interval: Day,
+                moduleKey: this.config.collectionName
+            }];
+    }
+    resolveBackupQuery() {
+        return { where: {} };
+    }
+    // this.setExternalUniqueKeys(["accessLevelIds"]);
+    /**
+     * Sets the external unique keys. External keys are the attributes of a document that must be unique inside the
+     * collection. Default is `_id`.
+     *
+     * @remarks
+     * You can only update the external unique keys before the module is initialized, preferably from its constructor.
+     *
+     * @param keys - The external unique keys.
+     *
+     * @returns
+     * The external filter keys.
+     */
+    setExternalUniqueKeys(keys) {
+        if (this.initiated)
+            throw new BadImplementationException("You can only update the 'externalUniqueKeys' before the module was initialized.. preferably from its constructor");
+        return this.config.externalFilterKeys = keys;
+    }
+    /**
+     * Sets the lock keys. Lock keys are the attributes of a document that must not be changed during a patch.
+     * Thr property `_id` is always part of the lock keys.
+     *
+     * @remarks
+     * You can only update the lock keys before the module is initialized, preferably from its constructor.
+     *
+     * @param keys - The lock keys.
+     *
+     * @returns
+     * The lock keys.
+     */
+    setLockKeys(keys) {
+        if (this.initiated)
+            throw new BadImplementationException("You can only update the 'lockKeys' before the module was initialized.. preferably from its constructor");
+        return this.config.lockKeys = filterDuplicates([...keys,
+            "_id"]);
+    }
+    getCollectionName() {
+        return this.config.collectionName;
+    }
+    getItemName() {
+        return this.config.itemName;
+    }
+    /**
+     * Executed during the initialization of the module.
+     * The collection reference is set in this method.
+     */
+    init() {
+        const firestore = FirebaseModule.createAdminSession(this.config?.projectId).getFirestore();
+        // @ts-expect-error TS struggles with this dynamic typing
+        this.collection = firestore.getCollection(this.config.collectionName, this.config.externalFilterKeys);
+    }
+    async assertExternalQueryUnique(instance, transaction) {
+        const dbInstance = await transaction.queryItem(this.collection, instance);
+        if (!dbInstance) {
+            const uniqueQuery = FirestoreInterface.buildUniqueQuery(this.collection, instance);
+            throw new ApiException(404, `Could not find ${this.config.itemName} with unique query '${__stringify(uniqueQuery)}'`);
+        }
+        return dbInstance;
+    }
+    /**
+     * Asserts the uniqueness of an instance in two steps:
+     * - Executes `this.preUpsertProcessing`.
+     * - Asserts uniqueness based on the internal filters.
+     *
+     * @param transaction - The transaction object.
+     * @param instance - The document for which the uniqueness assertion will occur.
+     */
+    async assertUniqueness(transaction, instance, request) {
+        await this.preUpsertProcessing(transaction, instance, request);
+        const uniqueQueries = this.internalFilter(instance);
+        if (uniqueQueries.length === 0)
+            return;
+        const dbInstances = await Promise.all(uniqueQueries.map(uniqueQuery => {
+            return transaction.queryUnique(this.collection, { where: uniqueQuery });
+        }));
+        for (const idx in dbInstances) {
+            const dbInstance = dbInstances[idx];
+            if (!dbInstance || dbInstance._id === instance._id)
+                continue;
+            const query = uniqueQueries[idx];
+            const message = _keys(query).reduce((carry, key) => {
+                return carry + "\n" + `${String(key)}: ${query[key]}`;
+            }, `${this.config.itemName} uniqueness violation. There is already a document with`);
+            this.logWarning(message);
+            throw new ApiException(422, message);
+        }
+    }
+    /**
+     * Runs the module's validator for the instance.
+     *
+     * @param instance - The object to be validated.
+     *
+     * @throws `ApiException` for bad implementation or invalid input.
+     */
+    validateImpl(instance) {
+        try {
+            validate(instance, this.validator);
+        }
+        catch (e) {
+            const badImplementation = isErrorOfType(e, BadImplementationException);
+            if (badImplementation)
+                throw new ApiException(500, badImplementation.message);
+            const error = isErrorOfType(e, ValidationException);
+            if (error) {
+                const errorBody = { type: ErrorKey_BadInput, body: { path: error.path, input: error.input } };
+                throw new ApiException(400, error.message).setErrorBody(errorBody);
+            }
+            throw e;
+        }
+    }
+    /**
+     * Override this method to return a list of "where" queries that dictate uniqueness inside the collection.
+     * Example return value: [{attribute1: item.attribute1, attribute2: item.attribute2}].
+     *
+     * @param item - The DB entry that will be used.
+     */
+    internalFilter(_item) {
+        return [];
+    }
+    /**
+     * Override this method to customize the assertions that should be done before the insertion of the document to the DB.
+     *
+     * @param transaction - The transaction object.
+     * @param dbInstance - The DB entry for which the uniqueness is being asserted.
+     */
+    async preUpsertProcessing(_transaction, _dbInstance, _request) {
+    }
+    /**
+     * Override this method to provide actions or assertions to be executed before the deletion happens.
+     *
+     * Currently executed only before `deleteUnique()`.
+     *
+     * @param transaction - The transaction object
+     * @param dbInstance - The DB entry that is going to be deleted.
+     */
+    async assertDeletion(transaction, dbInstance, request) {
+        return (await this.assertDeletion_Read(transaction, dbInstance, request))();
+    }
+    async assertDeletion_Read(_transaction, _dbInstance, _request) {
+        return async () => {
+        };
+    }
+    /**
+     * A wrapper of the collections's `runInTransaction`.
+     *
+     * @param processor - The transaction's processor.
+     *
+     * @returns
+     * A promise of the result of the `processor`.
+     */
+    async runInTransaction(processor) {
+        return this.collection.runInTransaction(processor);
+    }
+    // @ts-expect-error TS struggles with this dynamic typing
+    async deleteCollection() {
+        await this.collection.deleteAll();
+    }
+    /**
+     * Inserts the `instance` using the `transaction` object.
+     *
+     * @param transaction - The transaction object.
+     * @param instance - The object to be inserted.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @returns
+     * A promise of the document that was inserted.
+     */
+    // private async createImpl(transaction: FirestoreTransaction, instance: DBType, request?: ExpressRequest): Promise<DBType> {
+    // 	return (await this.createImpl_Read(transaction, instance, request))()
+    // };
+    async createImpl_Read(transaction, instance, request) {
+        await this.validateImpl(instance);
+        await this.assertUniqueness(transaction, instance, request);
+        return () => transaction.insert(this.collection, instance);
+    }
+    ;
+    /**
+     * Upserts the `instance` using a transaction, after validating it and asserting uniqueness.
+     *
+     * @param instance - The object to be upserted.
+     * @param transaction - OPTIONAL transaction to perform the upsert operation on
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @returns
+     * A promise of the document that was upserted.
+     */
+    async upsert(instance, transaction, request) {
+        const processor = async (_transaction) => {
+            return (await this.upsert_Read(instance, _transaction, request))();
+        };
+        if (transaction)
+            return processor(transaction);
+        return this.collection.runInTransaction(processor);
+    }
+    async upsert_Read(instance, transaction, request) {
+        if (instance._id === undefined)
+            return this.createImpl_Read(transaction, { ...instance, _id: generateHex(idLength) }, request);
+        return this.upsertImpl_Read(transaction, instance, request);
+    }
+    /**
+     * Upserts a set of objects. Batching is used to circumvent firestore limitations on the number of objects.
+     *
+     * @param instances - The objects to be upserted.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @returns
+     * A promise of an array of documents that were upserted.
+     */
+    async upsertAll_Batched(instances, request) {
+        return batchAction(instances, 500, async (chunked) => this.upsertAll(chunked, undefined, request));
+    }
+    /**
+     * Upserts the `dbInstances` using the `transaction` object.
+     *
+     * @param transaction - The transaction object.
+     * @param instances - The instances to update.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @throws `BadImplementationException` when the instances are more than 500.
+     *
+     * @returns
+     * A promise of the array of documents that were upserted.
+     */
+    async upsertAll(instances, transaction, request) {
+        if (instances.length > 500) {
+            if (transaction)
+                throw new BadImplementationException('Firestore transaction supports maximum 500 at a time');
+            return this.upsertAll_Batched(instances, request);
+        }
+        const processor = async (_transaction) => {
+            const writes = await Promise.all(await this.upsertAllImpl_Read(instances, _transaction, request));
+            return writes.map(write => write());
+        };
+        if (transaction)
+            return processor(transaction);
+        return this.collection.runInTransaction(processor);
+    }
+    async upsertAllImpl_Read(instances, transaction, request) {
+        const actions = [];
+        instances.reduce((carry, instance) => {
+            addItemToArray(carry, this.upsert_Read(instance, transaction, request));
+            return carry;
+        }, actions);
+        return Promise.all(actions);
+    }
+    /**
+     * Upserts the `dbInstance` using the `transaction` transaction object.
+     *
+     * @param transaction - The transaction object.
+     * @param dbInstance - The object to be upserted.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @returns
+     * A promise of the document that was upserted.
+     */
+    async upsertImpl(transaction, dbInstance, request) {
+        return (await this.upsertImpl_Read(transaction, dbInstance, request))();
+    }
+    ;
+    async upsertImpl_Read(transaction, dbInstance, request) {
+        await this.validateImpl(dbInstance);
+        await this.assertUniqueness(transaction, dbInstance, request);
+        return transaction.upsert_Read(this.collection, dbInstance);
+    }
+    ;
+    /**
+     * Deletes a unique document based on its `_id`. Uses a transaction, after deletion assertions occur.
+     *
+     * @param _id - The _id of the object to be deleted.
+     * @param transaction
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @throws `ApiException` when the document doesn't exist in the collection.
+     *
+     * @returns
+     * A promise of the document that was deleted.
+     */
+    async deleteUnique(_id, transaction, request) {
+        if (!_id)
+            throw new BadImplementationException(`No _id for deletion provided.`);
+        const processor = async (_transaction) => {
+            const write = await this.deleteUnique_Read(_id, _transaction, request);
+            if (!write)
+                throw new ApiException(404, `Could not find ${this.config.itemName} with unique id: ${_id}`);
+            return write();
+        };
+        if (transaction)
+            return processor(transaction);
+        return this.collection.runInTransaction(processor);
+    }
+    async deleteUnique_Read(_id, transaction, request) {
+        if (!_id)
+            throw new BadImplementationException(`No _id for deletion provided.`);
+        const ourQuery = { where: { _id } };
+        const dbInstance = await transaction.queryUnique(this.collection, ourQuery);
+        if (!dbInstance)
+            throw new ApiException(404, `Could not find ${this.config.itemName} with unique id: ${_id}`);
+        const write = await this.deleteImpl_Read(transaction, ourQuery, request);
+        return async () => {
+            if (!write)
+                return dbInstance;
+            // Here can do both read an write!
+            await this.assertDeletion(transaction, dbInstance, request);
+            return write();
+        };
+    }
+    /**
+     * Uses the `transaction` to delete a unique document, querying with the `ourQuery`.
+     *
+     * @param transaction - The transaction object.
+     * @param ourQuery - The query to be used for the deletion.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @returns
+     * A promise of the document that was deleted.
+     */
+    async deleteImpl_Read(transaction, ourQuery, _request) {
+        const write = await transaction.deleteUnique_Read(this.collection, ourQuery);
+        if (!write)
+            throw new ThisShouldNotHappenException(`I just checked that I had an instance for query: ${__stringify(ourQuery)}`);
+        return write;
+    }
+    /**
+     * Calls the `delete` method of the module's collection.
+     *
+     * @param query - The query to be executed for the deletion.
+     * @param request - The request in order to possibly obtain more info.
+     */
+    async delete(query, _request) {
+        return this.collection.delete(query);
+    }
+    /**
+     * Queries the database for a specific document in the module's collection.
+     *
+     * @param where - The where clause to be used for querying.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @throws `ApiException` if the document is not found.
+     *
+     * @returns
+     * The DB document that was found.
+     */
+    async queryUnique(where, _request) {
+        const dbItem = await this.collection.queryUnique({ where });
+        if (!dbItem)
+            throw new ApiException(404, `Could not find ${this.config.itemName} with unique query: ${JSON.stringify(where)}`);
+        return dbItem;
+    }
+    /**
+     * Executes the specified query on the module's collection.
+     *
+     * @param query - The query to be executed.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @returns
+     * A promise of an array of documents.
+     */
+    async query(query, _request) {
+        return await this.collection.query(query);
+    }
+    /**
+     * If propsToPatch is not set, we remove the lock keys from the caller's instance
+     * before merging with the original dbInstance.
+     * If propsToPatch is set, we also remove all of the instance's keys that
+     * are not specified in propsToPatch.
+     *
+     * @param instance - The instance to be upserted.
+     * @param propsToPatch - Properties to patch.
+     * @param request - The request in order to possibly obtain more info.
+     *
+     * @returns
+     * A promise of the patched document.
+     */
+    async patch(instance, propsToPatch, request) {
+        return this.collection.runInTransaction(async (transaction) => {
+            const dbInstance = await this.assertExternalQueryUnique(instance, transaction);
+            // If the caller has specified props to be changed, make sure the don't conflict with the lockKeys.
+            const wrongKey = propsToPatch?.find(prop => this.config.lockKeys.includes(prop));
+            if (wrongKey)
+                throw new BadImplementationException(`Key ${String(wrongKey)} is part of the 'lockKeys' and cannot be updated.`);
+            // If the caller has not specified props, we remove the keys from the caller's instance
+            // before merging with the original dbInstance.
+            _keys(instance).forEach(key => {
+                if (this.config.lockKeys.includes(key) || (propsToPatch && !propsToPatch.includes(key))) {
+                    delete instance[key];
+                }
+            });
+            const mergedObject = merge(dbInstance, instance);
+            await validate(mergedObject, this.validator);
+            await this.assertUniqueness(transaction, mergedObject, request);
+            return this.upsertImpl(transaction, mergedObject, request);
+        });
+    }
+    apiCreate(pathPart) {
+        return new ServerApi_Create(this, pathPart);
+    }
+    apiQuery(pathPart) {
+        return new ServerApi_Query(this, pathPart);
+    }
+    apiQueryUnique(pathPart) {
+        return new ServerApi_Unique(this, pathPart);
+    }
+    apiUpdate(pathPart) {
+        return new ServerApi_Update(this, pathPart);
+    }
+    apiDelete(pathPart) {
+        return new ServerApi_Delete(this, pathPart);
+    }
+    /**
+     * Override this method, to control which server api endpoints are created automatically.
+     *
+     * @param pathPart - The path part.
+     *
+     * @returns
+     * An array of api endpoints.
+     */
+    apis(pathPart) {
+        return filterInstances([
+            this.apiCreate(pathPart),
+            this.apiQuery(pathPart),
+            this.apiQueryUnique(pathPart),
+            this.apiUpdate(pathPart),
+            this.apiDelete(pathPart),
+        ]);
+    }
+}
+//# sourceMappingURL=BaseDB_ApiGenerator.js.map

package/dist/app-backend/BaseDB_ApiGenerator.js.map

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

package/{app-backend → dist/app-backend}/apis.d.ts

@@ -1,8 +1,8 @@
-import { BaseDB_ApiGenerator } from "./BaseDB_ApiGenerator";
-import { ApiTypeBinder, QueryParams } from "@intuitionrobotics/thunderstorm";
-import { ApiBinder_DBCreate, ApiBinder_DBDelete, ApiBinder_DBQuery, ApiBinder_DBUniuqe, ApiBinder_DBUpdate, GenericApiDef } from "..";
-import { Clause_Where, DB_Object } from "@intuitionrobotics/firebase";
-import { ApiResponse, ExpressRequest, ServerApi } from "@intuitionrobotics/thunderstorm/backend";
+import { BaseDB_ApiGenerator } from "./BaseDB_ApiGenerator.js";
+import { type ApiTypeBinder, type QueryParams } from "@intuitionrobotics/thunderstorm";
+import { type ApiBinder_DBCreate, type ApiBinder_DBDelete, type ApiBinder_DBQuery, type ApiBinder_DBUniuqe, type ApiBinder_DBUpdate, type GenericApiDef } from "../index.js";
+import { type Clause_Where, type DB_Object } from "@intuitionrobotics/firebase";
+import { ApiResponse, type ExpressRequest, ServerApi } from "@intuitionrobotics/thunderstorm/backend";
 export declare function resolveUrlPart(dbModule: BaseDB_ApiGenerator<any>, pathPart?: string, pathSuffix?: string): string;
 export declare abstract class GenericServerApi<DBType extends DB_Object, Binder extends ApiTypeBinder<string, R, B, P>, PostProcessor = never, R = Binder["response"], B = Binder["body"], P extends QueryParams | {} = Binder["queryParams"]> extends ServerApi<Binder> {
     protected readonly dbModule: BaseDB_ApiGenerator<DBType>;
@@ -20,7 +20,7 @@ export declare class ServerApi_Update<DBType extends DB_Object> extends GenericS
 }
 export declare class ServerApi_Unique<DBType extends DB_Object> extends GenericServerApi<DBType, ApiBinder_DBUniuqe<DBType>> {
     constructor(dbModule: BaseDB_ApiGenerator<DBType>, pathPart?: string);
-    protected process(request: ExpressRequest, response: ApiResponse, queryParams: DB_Object, body: void): Promise<DBType>;
+    protected process(request: ExpressRequest, response: ApiResponse, queryParams: DB_Object, _body: void): Promise<DBType>;
 }
 export declare class ServerApi_Query<DBType extends DB_Object> extends GenericServerApi<DBType, ApiBinder_DBQuery<DB_Object>, () => Promise<Partial<DBType>[]>> {
     constructor(dbModule: BaseDB_ApiGenerator<DBType>, pathPart?: string);
@@ -28,5 +28,6 @@ export declare class ServerApi_Query<DBType extends DB_Object> extends GenericSe
 }
 export declare class ServerApi_Delete<DBType extends DB_Object> extends GenericServerApi<DBType, ApiBinder_DBDelete<DBType>> {
     constructor(dbModule: BaseDB_ApiGenerator<DBType>, pathPart?: string);
-    protected process(request: ExpressRequest, response: ApiResponse, queryParams: DB_Object, body: void): Promise<DBType>;
+    protected process(request: ExpressRequest, response: ApiResponse, queryParams: DB_Object, _body: void): Promise<DBType>;
 }
+//# sourceMappingURL=apis.d.ts.map

package/dist/app-backend/apis.d.ts.map

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