@oxy.so/core 4.6.0 → 4.9.0

package/dist/esm/i18n/locales/en-US.js

@@ -1,4 +1,65 @@
 const dict = {
+    organizationDirectory: {
+        invalidName: 'Use a plain-text organization name (up to 300 characters).',
+        review: {
+            title: 'Review organization access requests',
+            forbidden: 'This action requires current staff authorization.',
+            empty: 'No requests are waiting for review.',
+            hint: 'Review the supporting evidence independently. Approval grants management access to the existing organization account.',
+            independent: 'Another reviewer must decide your own request.',
+            evidence: 'Review evidence reference',
+            approved: 'Approve access',
+            rejected: 'Reject request',
+            conflict: 'This request or organization changed. Refresh the queue before making another decision.',
+            failed: 'The review could not be saved. Your decision has not been confirmed.',
+        },
+        title: 'Organization directory',
+        search: 'Find your organization',
+        searchHint: 'Find an existing organization before creating an account. Its identity is shared across Oxy apps.',
+        empty: 'No organizations found.',
+        retry: 'Try again',
+        loadMore: 'Show more',
+        failed: 'Could not load the organization directory.',
+        unclaimed: 'Unclaimed',
+        claimed: 'Managed organization',
+        inactive: 'Inactive',
+        newAccount: 'Create a new organization account',
+        newAccountHint: 'Create and manage a new organization. Choose an existing entry if your organization is already listed.',
+        addDirectory: 'Add to directory',
+        directoryHint: 'This creates a shared, unclaimed entry. It does not give you access to manage the organization.',
+        added: 'Organization added to the directory',
+        back: 'Back to search',
+        type: 'Organization type',
+        types: {
+            business: 'Business',
+            nonprofit: 'Nonprofit',
+            public_body: 'Public body',
+            community: 'Community',
+            other: 'Other',
+        },
+        name: 'Organization name',
+        legalName: 'Legal name',
+        website: 'Website',
+        country: 'Country code',
+        save: 'Save organization',
+        saved: 'Organization updated',
+        invalid: 'Check the organization details. Use a complete website URL and a two-letter country code.',
+        saveFailed: 'Could not save the organization. Try again.',
+        claim: 'Request management access',
+        claimHint: 'Oxy reviews evidence of your authority. A request does not grant access or verify your role.',
+        evidence: 'Supporting evidence reference',
+        evidenceHint: 'Provide a reference to your private verification case or supporting records. Only you and reviewers can read it.',
+        claimSent: 'Request submitted for review',
+        claimFailed: 'Could not submit your request. Try again.',
+        claimedHint: 'This organization already has managers. Contact a manager to request access.',
+        requests: 'Organization access requests',
+        pending: 'Pending review',
+        approved: 'Approved',
+        rejected: 'Rejected',
+        requestError: 'Could not load your access requests.',
+        view: 'Organization details',
+        readonly: 'You do not have permission to edit this organization.',
+    },
     signin: {
         title: 'Sign in',
         subtitle: 'Use your Oxy account',
@@ -1373,6 +1434,13 @@ const dict = {
         },
     },
     preferences: {
+        displayCurrency: {
+            label: 'Display currency',
+            saveFailed: 'Could not save display currency. Please try again.',
+            unavailable: 'Equivalent in {{currency}} unavailable',
+            approximate: 'Approx. {{amount}}',
+            estimate: 'Display estimate. The final payable amount is quoted in FAIR at checkout.',
+        },
         title: 'Preferences',
         subtitle: 'Theme, motion, and regional settings',
         sections: {

package/dist/esm/i18n/locales/es-ES.js

@@ -1,4 +1,65 @@
 const dict = {
+    organizationDirectory: {
+        invalidName: 'Usa un nombre de organización en texto plano (hasta 300 caracteres).',
+        review: {
+            title: 'Revisar solicitudes de acceso a organizaciones',
+            forbidden: 'Esta acción requiere autorización vigente del personal de Oxy.',
+            empty: 'No hay solicitudes pendientes de revisión.',
+            hint: 'Revisa la documentación de forma independiente. La aprobación concede acceso de administración a la cuenta existente.',
+            independent: 'Otro revisor debe decidir sobre tu propia solicitud.',
+            evidence: 'Referencia de la documentación de revisión',
+            approved: 'Aprobar acceso',
+            rejected: 'Rechazar solicitud',
+            conflict: 'La solicitud o la organización ha cambiado. Actualiza la lista antes de tomar otra decisión.',
+            failed: 'No se pudo guardar la revisión. Tu decisión no se ha confirmado.',
+        },
+        title: 'Directorio de organizaciones',
+        search: 'Busca tu organización',
+        searchHint: 'Busca una organización existente antes de crear una cuenta. Su identidad se comparte entre las aplicaciones de Oxy.',
+        empty: 'No se encontraron organizaciones.',
+        retry: 'Reintentar',
+        loadMore: 'Mostrar más',
+        failed: 'No se pudo cargar el directorio de organizaciones.',
+        unclaimed: 'Sin reclamar',
+        claimed: 'Organización administrada',
+        inactive: 'Inactiva',
+        newAccount: 'Crear una nueva cuenta de organización',
+        newAccountHint: 'Crea y administra una organización nueva. Si ya aparece en el directorio, elige la entrada existente.',
+        addDirectory: 'Añadir al directorio',
+        directoryHint: 'Esto crea una entrada compartida sin reclamar. No te da acceso para administrar la organización.',
+        added: 'Organización añadida al directorio',
+        back: 'Volver a la búsqueda',
+        type: 'Tipo de organización',
+        types: {
+            business: 'Empresa',
+            nonprofit: 'Sin ánimo de lucro',
+            public_body: 'Organismo público',
+            community: 'Comunidad',
+            other: 'Otro',
+        },
+        name: 'Nombre de la organización',
+        legalName: 'Nombre legal',
+        website: 'Sitio web',
+        country: 'Código de país',
+        save: 'Guardar organización',
+        saved: 'Organización actualizada',
+        invalid: 'Revisa los datos. Usa una URL completa y un código de país de dos letras.',
+        saveFailed: 'No se pudo guardar la organización. Inténtalo de nuevo.',
+        claim: 'Solicitar acceso de administración',
+        claimHint: 'Oxy revisará las pruebas de tu autorización. Una solicitud no concede acceso ni verifica tu cargo.',
+        evidence: 'Referencia de la documentación',
+        evidenceHint: 'Indica una referencia a tu expediente privado de verificación o documentación acreditativa. Solo tú y los revisores podéis verla.',
+        claimSent: 'Solicitud enviada para revisión',
+        claimFailed: 'No se pudo enviar la solicitud. Inténtalo de nuevo.',
+        claimedHint: 'Esta organización ya tiene administradores. Contacta con uno para solicitar acceso.',
+        requests: 'Solicitudes de acceso a organizaciones',
+        pending: 'Pendiente de revisión',
+        approved: 'Aprobada',
+        rejected: 'Rechazada',
+        requestError: 'No se pudieron cargar tus solicitudes.',
+        view: 'Datos de la organización',
+        readonly: 'No tienes permiso para editar esta organización.',
+    },
     signin: {
         title: 'Iniciar sesión',
         subtitle: 'Usa tu cuenta de Oxy',
@@ -1373,6 +1434,13 @@ const dict = {
         },
     },
     preferences: {
+        displayCurrency: {
+            label: 'Moneda mostrada',
+            saveFailed: 'No se ha podido guardar la moneda. Inténtalo de nuevo.',
+            unavailable: 'Equivalencia en {{currency}} no disponible',
+            approximate: 'Aprox. {{amount}}',
+            estimate: 'Importe orientativo. El importe final se cotiza en FAIR al pagar.',
+        },
         title: 'Preferencias',
         subtitle: 'Tema, movimiento y configuración regional',
         sections: {

package/dist/types/OxyServices.d.ts

@@ -1,3 +1,4 @@
+import { SafetyApi } from './api/safety';
 /**
  * `OxyServices` — the Oxy API client.
  *
@@ -31,6 +32,7 @@ import { PrivacyApi } from './api/privacy';
 import { NotificationsApi } from './api/notifications';
 import { AssetsApi } from './api/assets';
 import { IdentityApi } from './api/identity';
+import { OrganizationsApi } from './api/organizations';
 import { AccountsApi } from './api/accounts';
 import { AppsApi } from './api/apps';
 import { LinkedAccountsApi } from './api/linkedAccounts';
@@ -116,6 +118,8 @@ export declare class OxyServices {
     private _assets?;
     private _identity?;
     private _accounts?;
+    private _organizations?;
+    private _safety?;
     private _apps?;
     private _linkedAccounts?;
     private _agency?;
@@ -145,6 +149,8 @@ export declare class OxyServices {
     /** DID, keys, identity links, domains, backup and the signed export. */
     get identity(): IdentityApi;
     /** The account graph: accounts and their members. */
+    get safety(): SafetyApi;
+    get organizations(): OrganizationsApi;
     get accounts(): AccountsApi;
     /** Applications an account owns, and the ones this user granted access. */
     get apps(): AppsApi;

package/dist/types/api/accounts.d.ts

@@ -1,3 +1,4 @@
+import type { OrganizationType } from '@oxy.so/contracts';
 /**
  * `oxy.accounts` — the unified account graph (`/accounts`).
  *
@@ -193,6 +194,7 @@ export interface CreateAccountInput {
      * keep working. At most `MAX_ACCOUNT_CATEGORIES`, no duplicates.
      */
     accountCategories?: AccountCategoryId[];
+    organizationType?: OrganizationType;
     /**
      * Create the account already opted OUT of discovery — kept out of people
      * search, the follow-graph lists, `/similar` and the recommendation pools,
@@ -261,6 +263,7 @@ export interface UpdateAccountInput {
      * every other field here (`account:update`).
      */
     character?: AvatarCharacter;
+    organizationType?: OrganizationType;
 }
 /** Input accepted by `accounts.members.invite`. The owner role cannot be invited. */
 export interface InviteAccountMemberInput {
@@ -333,7 +336,8 @@ export declare class AccountMembersApi {
      */
     list(accountId: string): Promise<AccountMember[]>;
     /**
-     * Add a member to an account.
+     * @deprecated The API returns 410. Use accounts.invitations.create with an email.
+     * Access is granted only after recipient confirmation.
      * @param accountId - The account's `_id`.
      * @param data - Target user's username or email and role (never `owner`).
      *   The server resolves `usernameOrEmail` to a personal account; an unknown
@@ -390,10 +394,46 @@ export declare class AccountAgentKeysApi {
         revokedMethodIds: string[];
     }>;
 }
+export interface AccountInvitation {
+    id: string;
+    accountId: string;
+    email: string;
+    role: Exclude<AccountRole, 'owner'>;
+    status: 'pending' | 'expired' | 'accepted' | 'cancelled';
+    expiresAt: string;
+    createdAt: string;
+}
+export interface AccountInvitationPreview {
+    invitation: AccountInvitation;
+    account: {
+        id: string;
+        username: string | null;
+        displayName: string | null;
+    };
+}
+/** Consent-based invitations; never cached or queued as offline mutations. */
+export declare class AccountInvitationsApi {
+    private readonly ctx;
+    constructor(ctx: OxyContext);
+    list(accountId: string): Promise<AccountInvitation[]>;
+    create(accountId: string, data: {
+        email: string;
+        role: Exclude<AccountRole, 'owner'>;
+        inherit?: boolean;
+    }): Promise<AccountInvitation>;
+    resend(accountId: string, id: string): Promise<AccountInvitation>;
+    cancel(accountId: string, id: string): Promise<AccountSuccessResult>;
+    preview(token: string): Promise<AccountInvitationPreview>;
+    /** selectedUserId must equal the currently authenticated personal account. */
+    accept(token: string, selectedUserId: string): Promise<AccountSuccessResult & {
+        accountId: string;
+    }>;
+}
 export declare class AccountsApi {
     private readonly ctx;
     /** Who can act on an account, and with what role. */
     readonly members: AccountMembersApi;
+    readonly invitations: AccountInvitationsApi;
     readonly agentKeys: AccountAgentKeysApi;
     constructor(ctx: OxyContext);
     /**

package/dist/types/api/billing.d.ts

@@ -1,4 +1,4 @@
-import { type PersonalPlanCheckoutRequest, type PersonalPlanCheckoutResult } from '@oxy.so/contracts';
+import { type ProductSubscriptionRenewalRequest, type ProductPlanCheckoutRequest, type ProductPlanCatalogue, type PersonalPlanCheckoutRequest, type PersonalPlanCheckoutResult } from '@oxy.so/contracts';
 /**
  * `oxy.billing` — the signed-in user's subscription, wallet and payment history.
  *
@@ -101,6 +101,9 @@ export interface WalletTransactionsPage {
 export declare class BillingApi {
     protected readonly ctx: OxyContext;
     constructor(ctx: OxyContext);
+    renewProductSubscription(request: ProductSubscriptionRenewalRequest): Promise<PersonalPlanCheckoutResult>;
+    startProductPlanCheckout(request: ProductPlanCheckoutRequest): Promise<PersonalPlanCheckoutResult>;
+    productPlans(productId: string): Promise<ProductPlanCatalogue>;
     startPersonalPlanCheckout(request: PersonalPlanCheckoutRequest): Promise<PersonalPlanCheckoutResult>;
     /** Public versioned personal plans. Discovery never proves customer access. */
     personalPlans(): Promise<PersonalPlanCatalogue>;

package/dist/types/api/organizations.d.ts

@@ -0,0 +1,246 @@
+import { type OrganizationCuration, type OrganizationImportBatch, type OrganizationClaimListQuery, type CreateOrganization, type OrganizationSearch, type UpdateOrganization, type OrganizationClaimInput, type OrganizationClaimReview, type OrganizationExternalInput, type OrganizationMerge } from '@oxy.so/contracts';
+import type { OxyContext } from '../client/context';
+/** The public canonical organization directory. Claiming changes authority, never identity. */
+export declare class OrganizationsApi {
+    private readonly ctx;
+    constructor(ctx: OxyContext);
+    search(input: OrganizationSearch): Promise<{
+        items: {
+            status: "active" | "inactive" | "merged" | "suppressed";
+            name: string;
+            organizationType: "business" | "nonprofit" | "public_body" | "community" | "other";
+            legalName: string | null;
+            websiteUrl: string | null;
+            countryCode: string | null;
+            aliases: {
+                alias: string;
+                kind: "name_variant" | "former_name" | "localized_name" | "marketing_name" | "misspelling";
+                language?: string | undefined;
+            }[];
+            accountId: string;
+            username: string | null;
+            avatar: string | null;
+            verifiedDomains: string[];
+            claimStatus: "unclaimed" | "claimed";
+            mergedIntoAccountId: string | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        nextCursor: string | null;
+    }>;
+    get(accountId: string): Promise<{
+        status: "active" | "inactive" | "merged" | "suppressed";
+        name: string;
+        organizationType: "business" | "nonprofit" | "public_body" | "community" | "other";
+        legalName: string | null;
+        websiteUrl: string | null;
+        countryCode: string | null;
+        aliases: {
+            alias: string;
+            kind: "name_variant" | "former_name" | "localized_name" | "marketing_name" | "misspelling";
+            language?: string | undefined;
+        }[];
+        accountId: string;
+        username: string | null;
+        avatar: string | null;
+        verifiedDomains: string[];
+        claimStatus: "unclaimed" | "claimed";
+        mergedIntoAccountId: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    batch(input: {
+        ids: string[];
+    }): Promise<{
+        items: {
+            requestedAccountId: string;
+            organization: {
+                status: "active" | "inactive" | "merged" | "suppressed";
+                name: string;
+                organizationType: "business" | "nonprofit" | "public_body" | "community" | "other";
+                legalName: string | null;
+                websiteUrl: string | null;
+                countryCode: string | null;
+                aliases: {
+                    alias: string;
+                    kind: "name_variant" | "former_name" | "localized_name" | "marketing_name" | "misspelling";
+                    language?: string | undefined;
+                }[];
+                accountId: string;
+                username: string | null;
+                avatar: string | null;
+                verifiedDomains: string[];
+                claimStatus: "unclaimed" | "claimed";
+                mergedIntoAccountId: string | null;
+                createdAt: string;
+                updatedAt: string;
+            };
+        }[];
+        missingIds: string[];
+    }>;
+    create(input: CreateOrganization): Promise<{
+        status: "active" | "inactive" | "merged" | "suppressed";
+        name: string;
+        organizationType: "business" | "nonprofit" | "public_body" | "community" | "other";
+        legalName: string | null;
+        websiteUrl: string | null;
+        countryCode: string | null;
+        aliases: {
+            alias: string;
+            kind: "name_variant" | "former_name" | "localized_name" | "marketing_name" | "misspelling";
+            language?: string | undefined;
+        }[];
+        accountId: string;
+        username: string | null;
+        avatar: string | null;
+        verifiedDomains: string[];
+        claimStatus: "unclaimed" | "claimed";
+        mergedIntoAccountId: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    update(accountId: string, input: UpdateOrganization): Promise<{
+        status: "active" | "inactive" | "merged" | "suppressed";
+        name: string;
+        organizationType: "business" | "nonprofit" | "public_body" | "community" | "other";
+        legalName: string | null;
+        websiteUrl: string | null;
+        countryCode: string | null;
+        aliases: {
+            alias: string;
+            kind: "name_variant" | "former_name" | "localized_name" | "marketing_name" | "misspelling";
+            language?: string | undefined;
+        }[];
+        accountId: string;
+        username: string | null;
+        avatar: string | null;
+        verifiedDomains: string[];
+        claimStatus: "unclaimed" | "claimed";
+        mergedIntoAccountId: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    claim(accountId: string, input: OrganizationClaimInput): Promise<{
+        status: "pending" | "approved" | "rejected";
+        accountId: string;
+        createdAt: string;
+        id: string;
+        claimantUserId: string;
+    }>;
+    myClaims(input?: OrganizationClaimListQuery): Promise<{
+        items: {
+            status: "pending" | "approved" | "rejected";
+            accountId: string;
+            createdAt: string;
+            evidenceReference: string;
+            id: string;
+            claimantUserId: string;
+            reviewEvidenceReference: string | null;
+            reviewedAt: string | null;
+        }[];
+        nextCursor: string | null;
+    }>;
+    myClaim(claimId: string): Promise<{
+        status: "pending" | "approved" | "rejected";
+        accountId: string;
+        createdAt: string;
+        evidenceReference: string;
+        id: string;
+        claimantUserId: string;
+        reviewEvidenceReference: string | null;
+        reviewedAt: string | null;
+    }>;
+    reviewClaims(input?: OrganizationClaimListQuery): Promise<{
+        items: {
+            status: "pending" | "approved" | "rejected";
+            accountId: string;
+            createdAt: string;
+            evidenceReference: string;
+            id: string;
+            claimantUserId: string;
+            reviewEvidenceReference: string | null;
+            reviewedAt: string | null;
+        }[];
+        nextCursor: string | null;
+    }>;
+    reviewClaimDetail(claimId: string): Promise<{
+        status: "pending" | "approved" | "rejected";
+        accountId: string;
+        createdAt: string;
+        evidenceReference: string;
+        id: string;
+        claimantUserId: string;
+        reviewEvidenceReference: string | null;
+        reviewedAt: string | null;
+    }>;
+    reviewClaim(claimId: string, input: OrganizationClaimReview): Promise<{
+        status: "pending" | "approved" | "rejected";
+        accountId: string;
+        createdAt: string;
+        id: string;
+        claimantUserId: string;
+    }>;
+    importBatch(input: OrganizationImportBatch): Promise<{
+        items: {
+            accountId: string;
+            externalId: string;
+            created: boolean;
+        }[];
+    }>;
+    importExternal(input: OrganizationExternalInput): Promise<{
+        accountId: string;
+        created: boolean;
+    }>;
+    resolveExternal(input: {
+        namespace: string;
+        externalId: string;
+    }): Promise<{
+        accountId: string;
+    }>;
+    curate(accountId: string, input: OrganizationCuration): Promise<{
+        status: "active" | "inactive" | "suppressed";
+        accountId: string;
+    }>;
+    merge(accountId: string, input: OrganizationMerge): Promise<{
+        status: "active" | "inactive" | "merged" | "suppressed";
+        name: string;
+        organizationType: "business" | "nonprofit" | "public_body" | "community" | "other";
+        legalName: string | null;
+        websiteUrl: string | null;
+        countryCode: string | null;
+        aliases: {
+            alias: string;
+            kind: "name_variant" | "former_name" | "localized_name" | "marketing_name" | "misspelling";
+            language?: string | undefined;
+        }[];
+        accountId: string;
+        username: string | null;
+        avatar: string | null;
+        verifiedDomains: string[];
+        claimStatus: "unclaimed" | "claimed";
+        mergedIntoAccountId: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    iterate(input: OrganizationSearch): AsyncGenerator<{
+        status: "active" | "inactive" | "merged" | "suppressed";
+        name: string;
+        organizationType: "business" | "nonprofit" | "public_body" | "community" | "other";
+        legalName: string | null;
+        websiteUrl: string | null;
+        countryCode: string | null;
+        aliases: {
+            alias: string;
+            kind: "name_variant" | "former_name" | "localized_name" | "marketing_name" | "misspelling";
+            language?: string | undefined;
+        }[];
+        accountId: string;
+        username: string | null;
+        avatar: string | null;
+        verifiedDomains: string[];
+        claimStatus: "unclaimed" | "claimed";
+        mergedIntoAccountId: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }, void, unknown>;
+}

package/dist/types/api/safety.d.ts

@@ -0,0 +1,14 @@
+import { type ProfileAccessInput } from '@oxy.so/contracts';
+import type { OxyContext } from '../client/context';
+export declare class SafetyApi {
+    private readonly ctx;
+    constructor(ctx: OxyContext);
+    /** Server callers must explicitly supply the incoming user bearer or null for anonymous access. */
+    profileAccess(input: ProfileAccessInput, options?: {
+        accessToken: string | null;
+    }): Promise<{
+        allowed: boolean;
+        reason: "unavailable" | "owner" | "public" | "private" | "blocked";
+        policyVersion: "1";
+    }>;
+}

package/dist/types/i18n/locales/en-US.d.ts

@@ -1,4 +1,65 @@
 declare const dict: {
+    organizationDirectory: {
+        invalidName: string;
+        review: {
+            title: string;
+            forbidden: string;
+            empty: string;
+            hint: string;
+            independent: string;
+            evidence: string;
+            approved: string;
+            rejected: string;
+            conflict: string;
+            failed: string;
+        };
+        title: string;
+        search: string;
+        searchHint: string;
+        empty: string;
+        retry: string;
+        loadMore: string;
+        failed: string;
+        unclaimed: string;
+        claimed: string;
+        inactive: string;
+        newAccount: string;
+        newAccountHint: string;
+        addDirectory: string;
+        directoryHint: string;
+        added: string;
+        back: string;
+        type: string;
+        types: {
+            business: string;
+            nonprofit: string;
+            public_body: string;
+            community: string;
+            other: string;
+        };
+        name: string;
+        legalName: string;
+        website: string;
+        country: string;
+        save: string;
+        saved: string;
+        invalid: string;
+        saveFailed: string;
+        claim: string;
+        claimHint: string;
+        evidence: string;
+        evidenceHint: string;
+        claimSent: string;
+        claimFailed: string;
+        claimedHint: string;
+        requests: string;
+        pending: string;
+        approved: string;
+        rejected: string;
+        requestError: string;
+        view: string;
+        readonly: string;
+    };
     signin: {
         title: string;
         subtitle: string;
@@ -1364,6 +1425,13 @@ declare const dict: {
         };
     };
     preferences: {
+        displayCurrency: {
+            label: string;
+            saveFailed: string;
+            unavailable: string;
+            approximate: string;
+            estimate: string;
+        };
         title: string;
         subtitle: string;
         sections: {