@casual-simulation/aux-records 3.8.1 → 3.10.2

package/contracts/ContractRecordsController.js

@@ -0,0 +1,144 @@
+/* CasualOS is a set of web-based tools designed to facilitate the creation of real-time, multi-user, context-aware interactive experiences.
+ *
+ * Copyright (c) 2019-2025 Casual Simulation, Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { failure, success, } from '@casual-simulation/aux-common';
+import { CrudRecordsController } from '../crud';
+import { getContractFeatures } from '../SubscriptionConfiguration';
+import { v7 as uuid } from 'uuid';
+/**
+ * Defines a controller that can be used to interact with NotificationRecords.
+ */
+export class ContractRecordsController extends CrudRecordsController {
+    constructor(config) {
+        super({
+            ...config,
+            name: 'ContractRecordsController',
+            resourceKind: 'contract',
+        });
+        this._authStore = config.authStore;
+        this._privo = config.privo;
+    }
+    // TODO: decide how to prevent users from deleting/updating contracts
+    // eraseItem(request: CrudEraseItemRequest): Promise<CrudEraseItemResult> {
+    //      return {
+    //         success: false,
+    //      }
+    // }
+    async _transformInputItem(item, existingItem, action, context, authorization) {
+        if (action === 'create') {
+            let user = (await this._authStore.findUser(item.holdingUser)) ??
+                (await this._authStore.findUserByAddress(item.holdingUser, 'email')) ??
+                (await this._authStore.findUserByAddress(item.holdingUser, 'phone'));
+            if (!user && this._privo) {
+                const serviceId = (await this._privo.lookupServiceId({
+                    email: item.holdingUser,
+                })) ??
+                    (await this._privo.lookupServiceId({
+                        displayName: item.holdingUser,
+                    })) ??
+                    (await this._privo.lookupServiceId({
+                        phoneNumber: item.holdingUser,
+                    }));
+                if (serviceId) {
+                    user = await this._authStore.findUserByPrivoServiceId(serviceId);
+                }
+            }
+            if (!user) {
+                return failure({
+                    success: false,
+                    errorCode: 'user_not_found',
+                    errorMessage: `The holding user (${item.holdingUser}) was not found.`,
+                });
+            }
+            return success({
+                id: uuid(),
+                address: item.address,
+                markers: item.markers,
+                initialValue: item.initialValue,
+                rate: item.rate,
+                description: item.description,
+                issuedAtMs: Date.now(),
+                status: 'pending',
+                issuingUserId: context.userId,
+                holdingUserId: user.id,
+            });
+        }
+        return failure({
+            errorCode: 'not_supported',
+            errorMessage: 'Updating contracts is not supported.',
+        });
+    }
+    async _checkSubscriptionMetrics(action, context, authorization, item) {
+        const config = await this.config.getSubscriptionConfiguration();
+        const metrics = await this.store.getSubscriptionMetrics({
+            ownerId: context.recordOwnerId,
+            studioId: context.recordStudioId,
+        });
+        const features = getContractFeatures(config, metrics.subscriptionStatus, metrics.subscriptionId, metrics.subscriptionType, metrics.currentPeriodStartMs, metrics.currentPeriodEndMs);
+        if (!features.allowed) {
+            return {
+                success: false,
+                errorCode: 'not_authorized',
+                errorMessage: 'Contracts are not allowed for this subscription.',
+            };
+        }
+        if (action === 'delete') {
+            return {
+                success: false,
+                errorCode: 'not_supported',
+                errorMessage: 'Deleting contracts is not supported.',
+            };
+        }
+        if (action === 'create') {
+            if (typeof features.maxItems === 'number' &&
+                metrics.totalItems >= features.maxItems) {
+                return {
+                    success: false,
+                    errorCode: 'subscription_limit_reached',
+                    errorMessage: 'The maximum number of contract items has been reached for your subscription.',
+                };
+            }
+            // TODO: Support checking the holding user's subscription
+            // const holdingUserMetrics = await this.store.getSubscriptionMetrics({
+            //     ownerId: item.holdingUserId,
+            // });
+            // const holdingUserFeatures = getContractFeatures(
+            //     config,
+            //     holdingUserMetrics.subscriptionStatus,
+            //     holdingUserMetrics.subscriptionId,
+            //     holdingUserMetrics.subscriptionType,
+            //     holdingUserMetrics.currentPeriodStartMs,
+            //     holdingUserMetrics.currentPeriodEndMs
+            // );
+            // if (!holdingUserFeatures.allowed) {
+            //     return {
+            //         success: false,
+            //         errorCode: 'invalid_user',
+            //         errorMessage:
+            //             'The holding user does not have access to contracting features.',
+            //     };
+            // }
+        }
+        return {
+            success: true,
+            config,
+            metrics,
+            features,
+        };
+    }
+}
+//# sourceMappingURL=ContractRecordsController.js.map

package/contracts/ContractRecordsController.js.map

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

package/contracts/ContractRecordsStore.d.ts

@@ -0,0 +1,285 @@
+import type { CrudRecord, CrudRecordsStore, CrudSubscriptionMetrics, PartialExcept } from '../crud';
+import type { SubscriptionFilter } from '../MetricsStore';
+/**
+ * Defines a store that contains notification records.
+ */
+export interface ContractRecordsStore extends CrudRecordsStore<ContractRecord> {
+    /**
+     * Gets the item metrics for the subscription of the given user or studio.
+     * @param filter The filter to use.
+     */
+    getSubscriptionMetrics(filter: SubscriptionFilter): Promise<ContractSubscriptionMetrics>;
+    /**
+     * Marks the given pending contract as open.
+     * @param recordName The name of the record.
+     * @param address The address of the contract.
+     */
+    markPendingContractAsOpen(recordName: string, address: string): Promise<void>;
+    /**
+     * Marks the given contract as closed and also voids any open invoices.
+     * @param recordName The name of the record.
+     * @param address The address of the contract.
+     */
+    markContractAsClosed(recordName: string, address: string): Promise<void>;
+    /**
+     * Getes the contract record with the given ID.
+     * @param id The ID of the contract to get.
+     */
+    getItemById(id: string): Promise<{
+        recordName: string;
+        contract: ContractRecord;
+    } | null>;
+    /**
+     * Creates a new invoice.
+     * @param invoice The invoice to create.
+     */
+    createInvoice(invoice: ContractInvoice): Promise<void>;
+    /**
+     * Gets the invoice with the given ID.
+     * @param id The ID of the invoice to get.
+     */
+    getInvoiceById(id: string): Promise<{
+        invoice: ContractInvoice;
+        contract: ContractRecord;
+    } | null>;
+    /**
+     * Updates the given invoice.
+     * @param invoice The invoice to update.
+     */
+    updateInvoice(invoice: PartialExcept<ContractInvoice, 'id'>): Promise<void>;
+    /**
+     * Deletes the invoice with the given ID.
+     * @param id The ID of the invoice to delete.
+     */
+    deleteInvoice(id: string): Promise<void>;
+    /**
+     * Gets the list of invoices for the given contract.
+     * @param contractId The ID of the contract to get invoices for.
+     */
+    listInvoicesForContract(contractId: string): Promise<ContractInvoice[]>;
+    /**
+     * Marks the open invoice with the given ID as paid or void.
+     * @param invoiceId The ID of the invoice to update.
+     * @param status The status to mark the invoice as. Must be either "paid" or "void".
+     */
+    markOpenInvoiceAs(invoiceId: string, status: 'paid' | 'void'): Promise<void>;
+}
+/**
+ * Defines a record that represents a notification.
+ * That is, a way for users to be notified of something.
+ *
+ * @dochash types/records/packages
+ * @docName ContractRecord
+ */
+export interface ContractRecord extends CrudRecord {
+    /**
+     * The ID of the contract.
+     */
+    id: string;
+    /**
+     * The ID of the user that issued the contract.
+     * That is, the user who created the contract in the record.
+     * (Similar to subjectId in other record types)
+     */
+    issuingUserId: string;
+    /**
+     * The ID of the user that is holding the contract.
+     * That is, the user who is currently responsible for fulfilling the contract.
+     */
+    holdingUserId: string;
+    /**
+     * The current status of the contract.
+     */
+    status: ContractStatus;
+    /**
+     * The unix time in miliseconds when the contract was initially issued.
+     */
+    issuedAtMs: number;
+    /**
+     * The unix time in miliseconds when the contract was closed.
+     */
+    closedAtMs?: number | null;
+    /**
+     * The rate at which the contract is paid.
+     * This is the amount of money that each gig is worth.
+     */
+    rate: number;
+    /**
+     * The initial value of the contract.
+     * This is the total value of what the contract was worth when it was created.
+     */
+    initialValue: number;
+    /**
+     * The description of the contract.
+     */
+    description?: string | null;
+    /**
+     * The ID of the checkout session that was created to pay for the contract, if applicable.
+     */
+    stripeCheckoutSessionId?: string | null;
+    /**
+     * The ID of the payment intent that was created to pay for the contract, if applicable.
+     */
+    stripePaymentIntentId?: string | null;
+}
+/**
+ * The status of a contract.
+ * - "pending" means the contract is awaiting purchase.
+ * - "open" means the contract is active and can be invoiced.
+ * - "closed" means the contract is no longer active and cannot be invoiced.
+ */
+export type ContractStatus = 'pending' | 'open' | 'closed';
+/**
+ * Represents an invoice against a contract.
+ */
+export interface ContractInvoice {
+    /**
+     * The ID of the invoice.
+     */
+    id: string;
+    /**
+     * The ID of the contract that this invoice is for.
+     */
+    contractId: string;
+    /**
+     * The amount charged in the invoice.
+     */
+    amount: number;
+    /**
+     * The current status of the invoice.
+     */
+    status: InvoiceStatus;
+    /**
+     * The unix time in milliseconds when the invoice was opened.
+     */
+    openedAtMs: number;
+    /**
+     * The unix time in miliseconds when the invoice was paid, if applicable.
+     */
+    paidAtMs?: number | null;
+    /**
+     * The unix time in milliseconds when the invoice was voided, if applicable.
+     */
+    voidedAtMs?: number | null;
+    /**
+     * The destination for the payout of the invoice.
+     */
+    payoutDestination: InvoicePayoutDestination;
+    /**
+     * The ID of the external transfer that was created to payout the invoice, if applicable.
+     * Null if the invoice is not paid or the payout destination is "account".
+     */
+    destinationTransferId?: string | null;
+    /**
+     * The reason why the invoice was voided, if applicable.
+     */
+    voidReason?: InvoiceVoidReason | null;
+    /**
+     * The ID of the transaction that paid the invoice, if applicable.
+     */
+    transactionId?: string | null;
+    /**
+     * The ID of the external payout that was created as part of the invoice payment process, if applicatble.
+     * Null if the invoice is not paid or the payout destination is "account".
+     */
+    externalPayoutId?: string | null;
+    /**
+     * An additional note about the invoice.
+     */
+    note?: string | null;
+    /**
+     * The unix time in milliseconds when the invoice was created.
+     */
+    createdAtMs: number;
+    /**
+     * The unix time in milliseconds when the invoice was last updated.
+     */
+    updatedAtMs: number;
+}
+/**
+ * Represents the process of transferring funds from a user's account to an external destination.
+ */
+export interface ExternalPayout {
+    /**
+     * The ID of the payout.
+     */
+    id: string;
+    /**
+     * The ID of the user that this payout is for.
+     */
+    userId: string;
+    /**
+     * The ID of the invoice that this payout is assocated with, if applicable.
+     */
+    invoiceId?: string | null;
+    /**
+     * The ID of the transfer in the financial system that represents the payout.
+     */
+    transferId: string;
+    /**
+     * The ID of the transaction that was created to transfer the funds.
+     */
+    transactionId: string;
+    /**
+     * The external destination for the transfer.
+     */
+    externalDestination: 'stripe';
+    /**
+     * The ID of the stripe transfer that was created to transfer the funds.
+     */
+    stripeTransferId: string | null;
+    /**
+     * The stripe account ID that the payout is being sent to.
+     */
+    destinationStripeAccountId: string | null;
+    /**
+     * The amount of the transfer.
+     */
+    amount: number;
+    /**
+     * The ID of the transfer that posted the original transfer.
+     */
+    postedTransferId?: string | null;
+    /**
+     * The ID of the transfer that voided the original transfer, if applicable.
+     */
+    voidedTransferId?: string | null;
+    /**
+     * The unix time in milliseconds when the payout was initiated.
+     */
+    initatedAtMs?: number | null;
+    /**
+     * The unix time in milliseconds when the payout was posted.
+     */
+    postedAtMs?: number | null;
+    /**
+     * The unix time in miliseconds when the payout was voided, if applicable.
+     */
+    voidedAtMs?: number | null;
+}
+/**
+ * The status of an invoice.
+ * - "open" means the invoice is pending payment.
+ * - "paid" means the invoice has been paid.
+ * - "void" means the invoice has been voided and is no longer valid.
+ */
+export type InvoiceStatus = 'open' | 'paid' | 'void';
+/**
+ * The destination for the payout of an invoice.
+ * - "stripe" means that the invoiced amount will be transfered to the users Stripe account once paid.
+ * - "account" means that the invoiced amount will remain in thier CasualOS account.
+ */
+export type InvoicePayoutDestination = 'stripe' | 'account';
+/**
+ * The reason why an invoice was voided.
+ * - "rejected" means the invoice was rejected by the contract issuer, the system, or an admin.
+ * - "cancelled" means the invoice was cancelled by the user, the system, or an admin.
+ */
+export type InvoiceVoidReason = 'rejected' | 'cancelled';
+export interface ContractSubscriptionMetrics extends CrudSubscriptionMetrics {
+    /**
+     * The total number of packages stored in the subscription.
+     */
+    totalItems: number;
+}
+//# sourceMappingURL=ContractRecordsStore.d.ts.map

package/contracts/ContractRecordsStore.js

@@ -0,0 +1,19 @@
+/* CasualOS is a set of web-based tools designed to facilitate the creation of real-time, multi-user, context-aware interactive experiences.
+ *
+ * Copyright (c) 2019-2025 Casual Simulation, Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+export {};
+//# sourceMappingURL=ContractRecordsStore.js.map

package/contracts/ContractRecordsStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractRecordsStore.js","sourceRoot":"","sources":["ContractRecordsStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/contracts/MemoryContractRecordsStore.d.ts

@@ -0,0 +1,27 @@
+import { MemoryCrudRecordsStore } from '../crud/MemoryCrudRecordsStore';
+import type { ContractRecordsStore, ContractRecord, ContractSubscriptionMetrics, ContractInvoice } from './ContractRecordsStore';
+import type { SubscriptionFilter } from '../MetricsStore';
+import type { PartialExcept } from '../crud';
+/**
+ * A Memory-based implementation of the ContractRecordsStore.
+ */
+export declare class MemoryContractRecordsStore extends MemoryCrudRecordsStore<ContractRecord> implements ContractRecordsStore {
+    private _invoices;
+    createInvoice(invoice: ContractInvoice): Promise<void>;
+    getInvoiceById(id: string): Promise<{
+        invoice: ContractInvoice;
+        contract: ContractRecord;
+    } | null>;
+    updateInvoice(invoice: PartialExcept<ContractInvoice, 'id'>): Promise<void>;
+    deleteInvoice(id: string): Promise<void>;
+    listInvoicesForContract(contractId: string): Promise<ContractInvoice[]>;
+    markOpenInvoiceAs(invoiceId: string, status: 'paid' | 'void'): Promise<void>;
+    getItemById(id: string): Promise<{
+        recordName: string;
+        contract: ContractRecord;
+    } | null>;
+    markPendingContractAsOpen(recordName: string, address: string): Promise<void>;
+    markContractAsClosed(recordName: string, address: string): Promise<void>;
+    getSubscriptionMetrics(filter: SubscriptionFilter): Promise<ContractSubscriptionMetrics>;
+}
+//# sourceMappingURL=MemoryContractRecordsStore.d.ts.map

package/contracts/MemoryContractRecordsStore.js

@@ -0,0 +1,124 @@
+/* CasualOS is a set of web-based tools designed to facilitate the creation of real-time, multi-user, context-aware interactive experiences.
+ *
+ * Copyright (c) 2019-2025 Casual Simulation, Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { MemoryCrudRecordsStore } from '../crud/MemoryCrudRecordsStore';
+/**
+ * A Memory-based implementation of the ContractRecordsStore.
+ */
+export class MemoryContractRecordsStore extends MemoryCrudRecordsStore {
+    constructor() {
+        super(...arguments);
+        this._invoices = new Map();
+    }
+    async createInvoice(invoice) {
+        this._invoices.set(invoice.id, { ...invoice });
+    }
+    async getInvoiceById(id) {
+        const invoice = this._invoices.get(id) || null;
+        if (!invoice) {
+            return null;
+        }
+        const contract = await this.getItemById(invoice.contractId);
+        if (!contract) {
+            return null;
+        }
+        return {
+            invoice,
+            contract: contract.contract,
+        };
+    }
+    async updateInvoice(invoice) {
+        let existing = this._invoices.get(invoice.id);
+        if (!existing) {
+            throw new Error('Invoice not found: ' + invoice.id);
+        }
+        this._invoices.set(invoice.id, {
+            ...existing,
+            ...invoice,
+        });
+    }
+    async deleteInvoice(id) {
+        this._invoices.delete(id);
+    }
+    async listInvoicesForContract(contractId) {
+        return Array.from(this._invoices.values()).filter((i) => i.contractId === contractId);
+    }
+    async markOpenInvoiceAs(invoiceId, status) {
+        const invoice = this._invoices.get(invoiceId);
+        if (invoice && invoice.status === 'open') {
+            this._invoices.set(invoiceId, {
+                ...invoice,
+                status,
+                voidedAtMs: status === 'void' ? Date.now() : invoice.voidedAtMs,
+                paidAtMs: status === 'paid' ? Date.now() : invoice.paidAtMs,
+            });
+        }
+    }
+    async getItemById(id) {
+        const records = this.getItemRecords();
+        for (let [recordName, items] of records) {
+            for (let item of items.values()) {
+                if (item.id === id) {
+                    return { recordName, contract: item };
+                }
+            }
+        }
+        return null;
+    }
+    async markPendingContractAsOpen(recordName, address) {
+        const record = this.getItemRecord(recordName);
+        const item = record.get(address);
+        if (item && item.status === 'pending') {
+            record.set(address, {
+                ...item,
+                status: 'open',
+            });
+        }
+    }
+    async markContractAsClosed(recordName, address) {
+        const record = this.getItemRecord(recordName);
+        const item = record.get(address);
+        if (item && item.status !== 'closed') {
+            record.set(address, {
+                ...item,
+                status: 'closed',
+                closedAtMs: Date.now(),
+            });
+            const invoices = await this.listInvoicesForContract(item.id);
+            for (let invoice of invoices) {
+                if (invoice.status === 'open') {
+                    await this.markOpenInvoiceAs(invoice.id, 'void');
+                }
+            }
+        }
+    }
+    async getSubscriptionMetrics(filter) {
+        const info = await super.getSubscriptionMetrics(filter);
+        let totalItems = 0;
+        const records = filter.ownerId
+            ? await this.store.listRecordsByOwnerId(filter.ownerId)
+            : await this.store.listRecordsByStudioId(filter.studioId);
+        for (let record of records) {
+            totalItems += this.getItemRecord(record.name).size;
+        }
+        return {
+            ...info,
+            totalItems,
+        };
+    }
+}
+//# sourceMappingURL=MemoryContractRecordsStore.js.map

package/contracts/MemoryContractRecordsStore.js.map

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

package/contracts/index.d.ts

@@ -0,0 +1,4 @@
+export * from './ContractRecordsStore';
+export * from './ContractRecordsController';
+export * from './MemoryContractRecordsStore';
+//# sourceMappingURL=index.d.ts.map

package/contracts/index.js

@@ -0,0 +1,21 @@
+/* CasualOS is a set of web-based tools designed to facilitate the creation of real-time, multi-user, context-aware interactive experiences.
+ *
+ * Copyright (c) 2019-2025 Casual Simulation, Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+export * from './ContractRecordsStore';
+export * from './ContractRecordsController';
+export * from './MemoryContractRecordsStore';
+//# sourceMappingURL=index.js.map

package/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}