@bsv/wallet-toolbox-client 2.4.4 → 2.4.20

package/out/src/storage/remoting/StorageClientBase.js

@@ -1,416 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StorageClientBase = void 0;
-const sdk_1 = require("@bsv/sdk");
-const WERR_errors_1 = require("../../sdk/WERR_errors");
-const entityValidationHelpers_1 = require("./entityValidationHelpers");
-/**
- * Abstract base class shared by `StorageClient` and `StorageMobile`.
- *
- * Contains all `WalletStorageProvider` method implementations and entity-validation
- * helpers. Subclasses only need to provide `rpcCall`, which differs between
- * the full (logger-aware) and mobile (lightweight) variants.
- */
-class StorageClientBase {
-    endpointUrl;
-    authClient;
-    nextId = 1;
-    serverSupportsBinary = false;
-    binaryRequests;
-    // Track ephemeral (in-memory) "settings" if you wish to align with isAvailable() checks
-    settings;
-    constructor(wallet, endpointUrl, options = {}) {
-        this.authClient = new sdk_1.AuthFetch(wallet);
-        this.endpointUrl = endpointUrl;
-        this.binaryRequests = options.binaryRequests === true;
-    }
-    /**
-     * The `StorageClient` implements the `WalletStorageProvider` interface.
-     * It does not implement the lower level `StorageProvider` interface.
-     *
-     * @returns false
-     */
-    isStorageProvider() {
-        return false;
-    }
-    /**
-     * @returns true once storage `TableSettings` have been retreived from remote storage.
-     */
-    isAvailable() {
-        // We'll just say "yes" if we have settings
-        return this.settings != null;
-    }
-    /**
-     * @returns remote storage `TableSettings` if they have been retreived by `makeAvailable`.
-     * @throws WERR_INVALID_OPERATION if `makeAvailable` has not yet been called.
-     */
-    getSettings() {
-        if (this.settings == null) {
-            throw new WERR_errors_1.WERR_INVALID_OPERATION('call makeAvailable at least once before getSettings');
-        }
-        return this.settings;
-    }
-    /**
-     * Must be called prior to making use of storage.
-     * Retreives `TableSettings` from remote storage provider.
-     * @returns remote storage `TableSettings`
-     */
-    async makeAvailable() {
-        this.settings ??= await this.rpcCall('makeAvailable', []);
-        return this.settings;
-    }
-    /// ///////////////////////////////////////////////////////////////////////////
-    //
-    // Implementation of all WalletStorage interface methods
-    // They are simple pass-thrus to rpcCall
-    //
-    // IMPORTANT: The parameter ordering must match exactly as in your interface.
-    /// ///////////////////////////////////////////////////////////////////////////
-    /**
-     * Called to cleanup resources when no further use of this object will occur.
-     */
-    async destroy() {
-        return await this.rpcCall('destroy', []);
-    }
-    /**
-     * Requests schema migration to latest.
-     * Typically remote storage will ignore this request.
-     * @param storageName Unique human readable name for remote storage if it does not yet exist.
-     * @param storageIdentityKey Unique identity key for remote storage if it does not yet exist.
-     * @returns current schema migration identifier
-     */
-    async migrate(storageName, storageIdentityKey) {
-        return await this.rpcCall('migrate', [storageName]);
-    }
-    /**
-     * Remote storage does not offer `Services` to remote clients.
-     * @throws WERR_INVALID_OPERATION
-     */
-    getServices() {
-        // Typically, the client would not store or retrieve "Services" from a remote server.
-        // The "services" in local in-memory usage is a no-op or your own approach:
-        throw new WERR_errors_1.WERR_INVALID_OPERATION('getServices() not implemented in remote client. This method typically is not used remotely.');
-    }
-    /**
-     * Ignored. Remote storage cannot share `Services` with remote clients.
-     */
-    setServices(v) {
-        // Typically no-op for remote client
-        // Because "services" are usually local definitions to the Storage.
-    }
-    /**
-     * Storage level processing for wallet `internalizeAction`.
-     * Updates internalized outputs in remote storage.
-     * Triggers proof validation of containing transaction.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args Original wallet `internalizeAction` arguments.
-     * @returns `internalizeAction` results
-     */
-    async internalizeAction(auth, args) {
-        return await this.rpcCall('internalizeAction', [auth, args]);
-    }
-    /**
-     * Storage level processing for wallet `createAction`.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args Validated extension of original wallet `createAction` arguments.
-     * @returns `StorageCreateActionResults` supporting additional wallet processing to yield `createAction` results.
-     */
-    async createAction(auth, args) {
-        return await this.rpcCall('createAction', [auth, args]);
-    }
-    /**
-     * Storage level processing for wallet `createAction` and `signAction`.
-     *
-     * Handles remaining storage tasks once a fully signed transaction has been completed. This is common to both `createAction` and `signAction`.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args `StorageProcessActionArgs` convey completed signed transaction to storage.
-     * @returns `StorageProcessActionResults` supporting final wallet processing to yield `createAction` or `signAction` results.
-     */
-    async processAction(auth, args) {
-        return await this.rpcCall('processAction', [auth, args]);
-    }
-    async getCapabilities() {
-        return await this.rpcCall('getCapabilities', []);
-    }
-    async beginActionBatch(auth, args) {
-        return await this.rpcCall('beginActionBatch', [auth, args]);
-    }
-    async extendActionBatch(auth, args) {
-        return await this.rpcCall('extendActionBatch', [auth, args]);
-    }
-    async renewActionBatch(auth, batchId) {
-        return await this.rpcCall('renewActionBatch', [auth, batchId]);
-    }
-    async prepareActionBatchCommit(auth, manifest) {
-        return await this.rpcCall('prepareActionBatchCommit', [auth, manifest]);
-    }
-    async putActionBatchBlob(auth, args) {
-        const baseUrl = this.endpointUrl.endsWith('/') ? this.endpointUrl.slice(0, -1) : this.endpointUrl;
-        const url = `${baseUrl}/action-batch/${encodeURIComponent(args.batchId)}/blob/${encodeURIComponent(args.digest)}`;
-        const bytes = args.bytes instanceof Uint8Array ? args.bytes : Uint8Array.from(args.bytes);
-        const response = await this.authClient.fetch(url, {
-            method: 'PUT',
-            headers: { 'Content-Type': 'application/octet-stream' },
-            body: bytes
-        });
-        if (!response.ok) {
-            const details = (await response.text()).slice(0, 512);
-            throw new Error(`WalletStorageClient putActionBatchBlob: network error ${response.status} ${response.statusText}: ${details}`);
-        }
-    }
-    async commitActionBatch(auth, manifest) {
-        return await this.rpcCall('commitActionBatch', [auth, manifest]);
-    }
-    async abortActionBatch(auth, batchId) {
-        return await this.rpcCall('abortActionBatch', [auth, batchId]);
-    }
-    /**
-     * Aborts an action by `reference` string.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args original wallet `abortAction` args.
-     * @returns `abortAction` result.
-     */
-    async abortAction(auth, args) {
-        return await this.rpcCall('abortAction', [auth, args]);
-    }
-    /**
-     * Used to both find and initialize a new user by identity key.
-     * It is up to the remote storage whether to allow creation of new users by this method.
-     * @param identityKey of the user.
-     * @returns `TableUser` for the user and whether a new user was created.
-     */
-    async findOrInsertUser(identityKey) {
-        return await this.rpcCall('findOrInsertUser', [identityKey]);
-    }
-    /**
-     * Used to both find and insert a `TableSyncState` record for the user to track wallet data replication across storage providers.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param storageName the name of the remote storage being sync'd
-     * @param storageIdentityKey the identity key of the remote storage being sync'd
-     * @returns `TableSyncState` and whether a new record was created.
-     */
-    async findOrInsertSyncStateAuth(auth, storageIdentityKey, storageName) {
-        const r = await this.rpcCall('findOrInsertSyncStateAuth', [
-            auth,
-            storageIdentityKey,
-            storageName
-        ]);
-        r.syncState = (0, entityValidationHelpers_1.validateEntity)(r.syncState, ['when']);
-        return r;
-    }
-    /**
-     * Inserts a new certificate with fields and keyring into remote storage.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param certificate the certificate to insert.
-     * @returns record Id of the inserted `TableCertificate` record.
-     */
-    async insertCertificateAuth(auth, certificate) {
-        const r = await this.rpcCall('insertCertificateAuth', [auth, certificate]);
-        return r;
-    }
-    /**
-     * Storage level processing for wallet `listActions`.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args Validated extension of original wallet `listActions` arguments.
-     * @returns `listActions` results.
-     */
-    async listActions(auth, vargs) {
-        const r = await this.rpcCall('listActions', [auth, vargs]);
-        return r;
-    }
-    /**
-     * Storage level processing for wallet `listOutputs`.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args Validated extension of original wallet `listOutputs` arguments.
-     * @returns `listOutputs` results.
-     */
-    async listOutputs(auth, vargs) {
-        const r = await this.rpcCall('listOutputs', [auth, vargs]);
-        return r;
-    }
-    /**
-     * Storage level processing for wallet `listCertificates`.
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args Validated extension of original wallet `listCertificates` arguments.
-     * @returns `listCertificates` results.
-     */
-    async listCertificates(auth, vargs) {
-        const r = await this.rpcCall('listCertificates', [auth, vargs]);
-        return r;
-    }
-    /**
-     * Find user certificates, optionally with fields.
-     *
-     * This certificate retrieval method supports internal wallet operations.
-     * Field values are stored and retrieved encrypted.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args `FindCertificatesArgs` determines which certificates to retrieve and whether to include fields.
-     * @returns array of certificates matching args.
-     */
-    async findCertificatesAuth(auth, args) {
-        const r = await this.rpcCall('findCertificatesAuth', [auth, args]);
-        (0, entityValidationHelpers_1.validateEntities)(r);
-        if (args.includeFields) {
-            for (const c of r) {
-                if (c.fields != null)
-                    (0, entityValidationHelpers_1.validateEntities)(c.fields);
-            }
-        }
-        return r;
-    }
-    /**
-     * Find output baskets.
-     *
-     * This retrieval method supports internal wallet operations.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args `FindOutputBasketsArgs` determines which baskets to retrieve.
-     * @returns array of output baskets matching args.
-     */
-    async findOutputBasketsAuth(auth, args) {
-        const r = await this.rpcCall('findOutputBasketsAuth', [auth, args]);
-        (0, entityValidationHelpers_1.validateEntities)(r);
-        return r;
-    }
-    /**
-     * Find outputs.
-     *
-     * This retrieval method supports internal wallet operations.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args `FindOutputsArgs` determines which outputs to retrieve.
-     * @returns array of outputs matching args.
-     */
-    async findOutputsAuth(auth, args) {
-        const r = await this.rpcCall('findOutputsAuth', [auth, args]);
-        (0, entityValidationHelpers_1.validateEntities)(r);
-        return r;
-    }
-    /**
-     * Find requests for transaction proofs.
-     *
-     * This retrieval method supports internal wallet operations.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args `FindProvenTxReqsArgs` determines which proof requests to retrieve.
-     * @returns array of proof requests matching args.
-     */
-    async findProvenTxReqs(args) {
-        const r = await this.rpcCall('findProvenTxReqs', [args]);
-        (0, entityValidationHelpers_1.validateEntities)(r);
-        return r;
-    }
-    /**
-     * Relinquish a certificate.
-     *
-     * For storage supporting replication records must be kept of deletions. Therefore certificates are marked as deleted
-     * when relinquished, and no longer returned by `listCertificates`, but are still retained by storage.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args original wallet `relinquishCertificate` args.
-     */
-    async relinquishCertificate(auth, args) {
-        return await this.rpcCall('relinquishCertificate', [auth, args]);
-    }
-    /**
-     * Relinquish an output.
-     *
-     * Relinquishing an output removes the output from whatever basket was tracking it.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param args original wallet `relinquishOutput` args.
-     */
-    async relinquishOutput(auth, args) {
-        return await this.rpcCall('relinquishOutput', [auth, args]);
-    }
-    /**
-     * Process a "chunk" of replication data for the user.
-     *
-     * The normal data flow is for the active storage to push backups as a sequence of data chunks to backup storage providers.
-     *
-     * @param args a copy of the replication request args that initiated the sequence of data chunks.
-     * @param chunk the current data chunk to process.
-     * @returns whether processing is done, counts of inserts and udpates, and related progress tracking properties.
-     */
-    async processSyncChunk(args, chunk) {
-        const r = await this.rpcCall('processSyncChunk', [args, chunk]);
-        return r;
-    }
-    /**
-     * Request a "chunk" of replication data for a specific user and storage provider.
-     *
-     * The normal data flow is for the active storage to push backups as a sequence of data chunks to backup storage providers.
-     * Also supports recovery where non-active storage can attempt to merge available data prior to becoming active.
-     *
-     * @param args that identify the non-active storage which will receive replication data and constrains the replication process.
-     * @returns the next "chunk" of replication data
-     */
-    async getSyncChunk(args) {
-        const r = await this.rpcCall('getSyncChunk', [args]);
-        return (0, entityValidationHelpers_1.validateSyncChunkEntities)(r);
-    }
-    /**
-     * Handles the data received when a new transaction proof is found in response to an outstanding request for proof data:
-     *
-     *   - Creates a new `TableProvenTx` record.
-     *   - Notifies all user transaction records of the new status.
-     *   - Updates the proof request record to 'completed' status which enables delayed deletion.
-     *
-     * @param args proof request and new transaction proof data
-     * @returns results of updates
-     */
-    async updateProvenTxReqWithNewProvenTx(args) {
-        const r = await this.rpcCall('updateProvenTxReqWithNewProvenTx', [args]);
-        return r;
-    }
-    /**
-     * Ensures up-to-date wallet data replication to all configured backup storage providers,
-     * then promotes one of the configured backups to active,
-     * demoting the current active to new backup.
-     *
-     * @param auth Identifies client by identity key and the storage identity key of their currently active storage.
-     * This must match the `AuthFetch` identity securing the remote conneciton.
-     * @param newActiveStorageIdentityKey which must be a currently configured backup storage provider.
-     */
-    async setActive(auth, newActiveStorageIdentityKey) {
-        return await this.rpcCall('setActive', [auth, newActiveStorageIdentityKey]);
-    }
-    /** @see {@link validateDate} */
-    validateDate(date) { return (0, entityValidationHelpers_1.validateDate)(date); }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process all individual records with time stamps retreived from database.
-     * @see {@link validateEntity}
-     */
-    validateEntity(entity, dateFields) {
-        return (0, entityValidationHelpers_1.validateEntity)(entity, dateFields);
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process all arrays of records with time stamps retreived from database.
-     * @returns input `entities` array with contained values validated.
-     * @see {@link validateEntities}
-     */
-    validateEntities(entities, dateFields) {
-        return (0, entityValidationHelpers_1.validateEntities)(entities, dateFields);
-    }
-}
-exports.StorageClientBase = StorageClientBase;
-//# sourceMappingURL=StorageClientBase.js.map

package/out/src/storage/remoting/StorageClientBase.js.map

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

package/out/src/storage/remoting/entityValidationHelpers.d.ts

@@ -1,29 +0,0 @@
-import { SyncChunk } from '../../sdk/WalletStorage.interfaces';
-import { EntityTimeStamp } from '../../sdk/types';
-/**
- * Shared entity-validation helpers used by both client-side storage remoting
- * (StorageClientBase / StorageMobile) and the server-side StorageServer.
- *
- * These helpers normalise records returned from remote calls or database queries:
- *   - Coerce date strings / timestamps to `Date` objects.
- *   - Replace `null` values with `undefined`.
- *   - Replace `Uint8Array` / `Buffer` values with plain `number[]` arrays.
- */
-export declare function validateDate(date: Date | string | number): Date;
-/**
- * Force uniform behaviour across database engines.
- * Use to process all individual records with timestamps retrieved from database.
- */
-export declare function validateEntity<T extends EntityTimeStamp>(entity: T, dateFields?: string[]): T;
-/**
- * Force uniform behaviour across database engines.
- * Use to process all arrays of records with timestamps retrieved from database.
- * @returns input `entities` array with contained values validated.
- */
-export declare function validateEntities<T extends EntityTimeStamp>(entities: T[], dateFields?: string[]): T[];
-/**
- * Validate all entity arrays within a `SyncChunk` received from a remote storage call.
- * Normalises timestamps, nulls, and binary fields in-place.
- */
-export declare function validateSyncChunkEntities(r: SyncChunk): SyncChunk;
-//# sourceMappingURL=entityValidationHelpers.d.ts.map

package/out/src/storage/remoting/entityValidationHelpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"entityValidationHelpers.d.ts","sourceRoot":"","sources":["../../../../../src/storage/remoting/entityValidationHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;;;;;;GAQG;AAEH,wBAAgB,YAAY,CAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,eAAe,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAiB7F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAMrG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAE,CAAC,EAAE,SAAS,GAAG,SAAS,CAelE"}

package/out/src/storage/remoting/entityValidationHelpers.js

@@ -1,91 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateDate = validateDate;
-exports.validateEntity = validateEntity;
-exports.validateEntities = validateEntities;
-exports.validateSyncChunkEntities = validateSyncChunkEntities;
-/**
- * Shared entity-validation helpers used by both client-side storage remoting
- * (StorageClientBase / StorageMobile) and the server-side StorageServer.
- *
- * These helpers normalise records returned from remote calls or database queries:
- *   - Coerce date strings / timestamps to `Date` objects.
- *   - Replace `null` values with `undefined`.
- *   - Replace `Uint8Array` / `Buffer` values with plain `number[]` arrays.
- */
-function validateDate(date) {
-    if (date instanceof Date)
-        return date;
-    return new Date(date);
-}
-/**
- * Force uniform behaviour across database engines.
- * Use to process all individual records with timestamps retrieved from database.
- */
-function validateEntity(entity, dateFields) {
-    entity.created_at = validateDate(entity.created_at);
-    entity.updated_at = validateDate(entity.updated_at);
-    if (dateFields != null) {
-        for (const df of dateFields) {
-            if (entity[df])
-                entity[df] = validateDate(entity[df]);
-        }
-    }
-    for (const key of Object.keys(entity)) {
-        const val = entity[key];
-        if (val === null) {
-            entity[key] = undefined;
-        }
-        else if (val instanceof Uint8Array) {
-            entity[key] = Array.from(val);
-        }
-    }
-    return entity;
-}
-/**
- * Force uniform behaviour across database engines.
- * Use to process all arrays of records with timestamps retrieved from database.
- * @returns input `entities` array with contained values validated.
- */
-function validateEntities(entities, dateFields) {
-    if (!Array.isArray(entities))
-        return entities;
-    for (let i = 0; i < entities.length; i++) {
-        entities[i] = validateEntity(entities[i], dateFields);
-    }
-    return entities;
-}
-/**
- * Validate all entity arrays within a `SyncChunk` received from a remote storage call.
- * Normalises timestamps, nulls, and binary fields in-place.
- */
-function validateSyncChunkEntities(r) {
-    if (r.certificateFields != null)
-        r.certificateFields = validateEntities(r.certificateFields);
-    if (r.certificates != null)
-        r.certificates = validateEntities(r.certificates);
-    if (r.commissions != null)
-        r.commissions = validateEntities(r.commissions);
-    if (r.outputBaskets != null)
-        r.outputBaskets = validateEntities(r.outputBaskets);
-    if (r.outputTagMaps != null)
-        r.outputTagMaps = validateEntities(r.outputTagMaps);
-    if (r.outputTags != null)
-        r.outputTags = validateEntities(r.outputTags);
-    if (r.outputs != null)
-        r.outputs = validateEntities(r.outputs);
-    if (r.provenTxReqs != null)
-        r.provenTxReqs = validateEntities(r.provenTxReqs);
-    if (r.provenTxs != null)
-        r.provenTxs = validateEntities(r.provenTxs);
-    if (r.transactions != null)
-        r.transactions = validateEntities(r.transactions);
-    if (r.txLabelMaps != null)
-        r.txLabelMaps = validateEntities(r.txLabelMaps);
-    if (r.txLabels != null)
-        r.txLabels = validateEntities(r.txLabels);
-    if (r.user != null)
-        r.user = validateEntity(r.user);
-    return r;
-}
-//# sourceMappingURL=entityValidationHelpers.js.map

package/out/src/storage/remoting/entityValidationHelpers.js.map

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