@oxyhq/core 3.1.0 → 3.4.0

package/src/i18n/locales/en-US.json

@@ -125,9 +125,9 @@
         "No selling your data"
       ]
     },
-    "karma": {
-      "title": "Karma = Trust & Growth",
-      "body": "Oxy Karma is a points system that reacts to what you do. Helpful, respectful, constructive actions earn it. Harmful or low‑effort stuff chips it away. More karma can unlock benefits; low karma can limit features. It keeps things fair and rewards real contribution."
+    "reputation": {
+      "title": "Reputation = Trust & Growth",
+      "body": "Oxy Trust is a reputation system that reacts to what you do. Helpful, respectful, constructive actions earn it. Harmful or low‑effort stuff chips it away. More reputation can unlock benefits; low reputation can limit features. It keeps things fair and rewards real contribution."
     },
     "avatar": {
       "title": "Make It Yours",
@@ -137,7 +137,7 @@
     },
     "ready": {
       "title": "You're Ready",
-      "body": "Explore. Contribute. Earn karma. Stay in control."
+      "body": "Explore. Contribute. Earn reputation. Stay in control."
     },
     "actions": {
       "back": "Back",
@@ -160,7 +160,7 @@
     "noBio": "This user has no bio yet.",
     "joinedOn": "Joined {{date}}",
     "bornOn": "Born {{date}}",
-    "karma": "Karma",
+    "reputation": "Reputation",
     "followers": "Followers",
     "following": "Following",
     "more": "+ {{count}} more"
@@ -354,69 +354,69 @@
       "subtitle": "Add another account to switch between them quickly"
     }
   },
-  "karma": {
+  "reputation": {
     "faq": {
-      "title": "Karma FAQ",
-      "subtitle": "Frequently asked questions about karma",
+      "title": "Reputation FAQ",
+      "subtitle": "Frequently asked questions about reputation",
       "search": "Search FAQ...",
       "noResults": "No FAQ items found matching \"{{query}}\"",
       "items": {
         "what": {
-          "q": "What is karma?",
-          "a": "Karma is a recognition of your positive actions in the Oxy Ecosystem. It cannot be sent or received directly."
+          "q": "What is reputation?",
+          "a": "Reputation is a recognition of your positive actions in the Oxy Ecosystem. It cannot be sent or received directly."
         },
         "earn": {
-          "q": "How do I earn karma?",
+          "q": "How do I earn reputation?",
           "a": "By helping others, reporting bugs, contributing content, and participating in community events."
         },
         "lose": {
-          "q": "Can I lose karma?",
-          "a": "Karma may be reduced for negative actions or breaking community rules."
+          "q": "Can I lose reputation?",
+          "a": "Reputation may be reduced for negative actions or breaking community rules."
         },
         "use": {
-          "q": "What can I do with karma?",
-          "a": "Unlock rewards, badges, and special features as you earn more karma."
+          "q": "What can I do with reputation?",
+          "a": "Unlock rewards, badges, and special features as you earn more reputation."
         },
         "transfer": {
-          "q": "Can I transfer karma to others?",
-          "a": "No, karma cannot be sent or received. It is only earned by your actions."
+          "q": "Can I transfer reputation to others?",
+          "a": "No, reputation cannot be sent or received. It is only earned by your actions."
         },
         "support": {
           "q": "How do I get support?",
-          "a": "Contact Oxy support via the app or website for any karma-related questions."
+          "a": "Contact Oxy support via the app or website for any reputation-related questions."
         }
       }
     },
     "rules": {
-      "title": "Karma Rules",
-      "subtitle": "How to earn karma points",
+      "title": "Reputation Rules",
+      "subtitle": "How to earn reputation points",
       "empty": "No rules found."
     },
     "leaderboard": {
-      "title": "Karma Leaderboard",
+      "title": "Reputation Leaderboard",
       "subtitle": "Top contributors in the community",
       "empty": "No leaderboard data."
     },
     "rewards": {
-      "title": "Karma Rewards",
+      "title": "Reputation Rewards",
       "subtitle": "Unlock special features and recognition",
-      "intro": "Unlock special features and recognition by earning karma!",
+      "intro": "Unlock special features and recognition by earning reputation!",
       "earlyAccess": {
         "title": "🎉 Early Access",
-        "desc": "Get early access to new features with 100+ karma."
+        "desc": "Get early access to new features with 100+ reputation."
       },
       "badge": {
         "title": "🏅 Community Badge",
-        "desc": "Earn a special badge for 500+ karma."
+        "desc": "Earn a special badge for 500+ reputation."
       },
       "featured": {
         "title": "🌟 Featured Member",
-        "desc": "Be featured in the community for 1000+ karma."
+        "desc": "Be featured in the community for 1000+ reputation."
       },
       "moreComing": "More rewards coming soon!"
     },
     "center": {
-      "balance": "Karma Balance",
+      "balance": "Reputation Balance",
       "actions": {
         "leaderboard": "Leaderboard",
         "rules": "Rules",
@@ -424,17 +424,17 @@
         "rewards": "Rewards",
         "faq": "FAQ"
       },
-      "info": "Karma can only be earned by positive actions in the Oxy Ecosystem. It cannot be sent or received directly.",
-      "history": "Karma History",
-      "noHistory": "No karma history yet.",
+      "info": "Reputation can only be earned by positive actions in the Oxy Ecosystem. It cannot be sent or received directly.",
+      "history": "Reputation History",
+      "noHistory": "No reputation history yet.",
       "noDescription": "No description"
     },
     "about": {
-      "title": "About Karma",
-      "subtitle": "Learn about the karma system",
-      "intro": "Karma is a recognition of your positive actions in the Oxy Ecosystem. It cannot be sent or received directly, only earned by contributing to the community.",
+      "title": "About Reputation",
+      "subtitle": "Learn about the reputation system (Oxy Trust)",
+      "intro": "Reputation is a recognition of your positive actions in the Oxy Ecosystem. It cannot be sent or received directly, only earned by contributing to the community.",
       "how": {
-        "title": "How to Earn Karma",
+        "title": "How to Earn Reputation",
         "help": "Helping other users",
         "report": "Reporting bugs",
         "contribute": "Contributing content",
@@ -442,31 +442,31 @@
         "other": "Other positive actions"
       },
       "why": {
-        "title": "Why Karma?",
-        "text": "Karma unlocks special features and recognition in the Oxy Ecosystem. The more you contribute, the more you earn!"
+        "title": "Why Reputation?",
+        "text": "Reputation unlocks special features and recognition in the Oxy Ecosystem. The more you contribute, the more you earn!"
       }
     },
     "achievements": {
       "unlocked": "Unlocked Achievements",
       "locked": "Locked Achievements",
       "firstStep": "First Step",
-      "firstStepDesc": "Earned your first karma point",
+      "firstStepDesc": "Earned your first reputation point",
       "novice": "Novice",
-      "noviceDesc": "Reached 10 karma points",
+      "noviceDesc": "Reached 10 reputation points",
       "contributor": "Contributor",
-      "contributorDesc": "Reached 50 karma points",
+      "contributorDesc": "Reached 50 reputation points",
       "risingStar": "Rising Star",
-      "risingStarDesc": "Reached 100 karma points",
+      "risingStarDesc": "Reached 100 reputation points",
       "earlyAdopter": "Early Adopter",
       "earlyAdopterDesc": "Been part of the community from the start",
       "communityHero": "Community Hero",
-      "communityHeroDesc": "Reached 500 karma points",
+      "communityHeroDesc": "Reached 500 reputation points",
       "legend": "Legend",
-      "legendDesc": "Reached 1000 karma points",
+      "legendDesc": "Reached 1000 reputation points",
       "phoenix": "Phoenix",
-      "phoenixDesc": "Reached 2500 karma points",
+      "phoenixDesc": "Reached 2500 reputation points",
       "unstoppable": "Unstoppable",
-      "unstoppableDesc": "Reached 5000 karma points",
+      "unstoppableDesc": "Reached 5000 reputation points",
       "bugHunter": "Bug Hunter",
       "bugHunterDesc": "Reported helpful bugs",
       "helper": "Helper",

package/src/i18n/locales/es-ES.json

@@ -107,7 +107,7 @@
     "noBio": "Este usuario aún no tiene biografía.",
     "joinedOn": "Se unió el {{date}}",
     "bornOn": "Nació el {{date}}",
-    "karma": "Karma",
+    "reputation": "Reputación",
     "followers": "Seguidores",
     "following": "Siguiendo",
     "more": "+ {{count}} más"
@@ -613,69 +613,69 @@
       "submitSuccess": "¡Comentario enviado correctamente!"
     }
   },
-  "karma": {
+  "reputation": {
     "faq": {
-      "title": "Preguntas frecuentes sobre karma",
-      "subtitle": "Preguntas frecuentes sobre el sistema de karma",
+      "title": "Preguntas frecuentes sobre reputación",
+      "subtitle": "Preguntas frecuentes sobre el sistema de reputación",
       "search": "Buscar en las FAQ...",
       "noResults": "No se encontraron preguntas que coincidan con \"{{query}}\"",
       "items": {
         "what": {
-          "q": "¿Qué es el karma?",
-          "a": "El karma es un reconocimiento de tus acciones positivas en el ecosistema de Oxy. No se puede enviar ni recibir directamente."
+          "q": "¿Qué es la reputación?",
+          "a": "La reputación es un reconocimiento de tus acciones positivas en el ecosistema de Oxy. No se puede enviar ni recibir directamente."
         },
         "earn": {
-          "q": "¿Cómo gano karma?",
+          "q": "¿Cómo gano reputación?",
           "a": "Ayudando a otros, reportando errores, contribuyendo contenido y participando en eventos de la comunidad."
         },
         "lose": {
-          "q": "¿Puedo perder karma?",
-          "a": "El karma puede reducirse por acciones negativas o por incumplir las reglas de la comunidad."
+          "q": "¿Puedo perder reputación?",
+          "a": "La reputación puede reducirse por acciones negativas o por incumplir las reglas de la comunidad."
         },
         "use": {
-          "q": "¿Qué puedo hacer con el karma?",
-          "a": "Desbloquea recompensas, insignias y funciones especiales a medida que ganas más karma."
+          "q": "¿Qué puedo hacer con la reputación?",
+          "a": "Desbloquea recompensas, insignias y funciones especiales a medida que ganas más reputación."
         },
         "transfer": {
-          "q": "¿Puedo transferir karma a otros?",
-          "a": "No, el karma no se puede enviar ni recibir. Solo se gana con tus acciones."
+          "q": "¿Puedo transferir reputación a otros?",
+          "a": "No, la reputación no se puede enviar ni recibir. Solo se gana con tus acciones."
         },
         "support": {
           "q": "¿Cómo obtengo soporte?",
-          "a": "Contacta con el soporte de Oxy a través de la app o el sitio web para cualquier pregunta relacionada con el karma."
+          "a": "Contacta con el soporte de Oxy a través de la app o el sitio web para cualquier pregunta relacionada con la reputación."
         }
       }
     },
     "rules": {
-      "title": "Reglas de karma",
-      "subtitle": "Cómo ganar puntos de karma",
+      "title": "Reglas de reputación",
+      "subtitle": "Cómo ganar puntos de reputación",
       "empty": "No se encontraron reglas."
     },
     "leaderboard": {
-      "title": "Clasificación de karma",
+      "title": "Clasificación de reputación",
       "subtitle": "Mayores contribuidores de la comunidad",
       "empty": "No hay datos de clasificación."
     },
     "rewards": {
-      "title": "Recompensas de karma",
+      "title": "Recompensas de reputación",
       "subtitle": "Desbloquea funciones especiales y reconocimiento",
-      "intro": "¡Desbloquea funciones especiales y reconocimiento ganando karma!",
+      "intro": "¡Desbloquea funciones especiales y reconocimiento ganando reputación!",
       "earlyAccess": {
         "title": "🎉 Acceso anticipado",
-        "desc": "Obtén acceso anticipado a nuevas funciones con 100+ de karma."
+        "desc": "Obtén acceso anticipado a nuevas funciones con 100+ de reputación."
       },
       "badge": {
         "title": "🏅 Insignia de la comunidad",
-        "desc": "Gana una insignia especial con 500+ de karma."
+        "desc": "Gana una insignia especial con 500+ de reputación."
       },
       "featured": {
         "title": "🌟 Miembro destacado",
-        "desc": "Destácate en la comunidad con 1000+ de karma."
+        "desc": "Destácate en la comunidad con 1000+ de reputación."
       },
       "moreComing": "¡Más recompensas próximamente!"
     },
     "center": {
-      "balance": "Saldo de karma",
+      "balance": "Saldo de reputación",
       "actions": {
         "leaderboard": "Clasificación",
         "rules": "Reglas",
@@ -683,17 +683,17 @@
         "rewards": "Recompensas",
         "faq": "FAQ"
       },
-      "info": "El karma solo se puede ganar con acciones positivas en el ecosistema de Oxy. No se puede enviar ni recibir directamente.",
-      "history": "Historial de karma",
-      "noHistory": "Aún no hay historial de karma.",
+      "info": "La reputación solo se puede ganar con acciones positivas en el ecosistema de Oxy. No se puede enviar ni recibir directamente.",
+      "history": "Historial de reputación",
+      "noHistory": "Aún no hay historial de reputación.",
       "noDescription": "Sin descripción"
     },
     "about": {
-      "title": "Acerca del karma",
-      "subtitle": "Aprende sobre el sistema de karma",
-      "intro": "El karma es un reconocimiento de tus acciones positivas en el ecosistema de Oxy. No se puede enviar ni recibir directamente, solo se gana contribuyendo a la comunidad.",
+      "title": "Acerca de la reputación",
+      "subtitle": "Aprende sobre el sistema de reputación (Oxy Trust)",
+      "intro": "La reputación es un reconocimiento de tus acciones positivas en el ecosistema de Oxy. No se puede enviar ni recibir directamente, solo se gana contribuyendo a la comunidad.",
       "how": {
-        "title": "Cómo ganar karma",
+        "title": "Cómo ganar reputación",
         "help": "Ayudando a otros usuarios",
         "report": "Reportando errores",
         "contribute": "Contribuyendo contenido",
@@ -701,31 +701,31 @@
         "other": "Otras acciones positivas"
       },
       "why": {
-        "title": "¿Por qué el karma?",
-        "text": "El karma desbloquea funciones especiales y reconocimiento en el ecosistema de Oxy. ¡Cuanto más contribuyas, más ganarás!"
+        "title": "¿Por qué la reputación?",
+        "text": "La reputación desbloquea funciones especiales y reconocimiento en el ecosistema de Oxy. ¡Cuanto más contribuyas, más ganarás!"
       }
     },
     "achievements": {
       "unlocked": "Logros desbloqueados",
       "locked": "Logros bloqueados",
       "firstStep": "Primer paso",
-      "firstStepDesc": "Ganaste tu primer punto de karma",
+      "firstStepDesc": "Ganaste tu primer punto de reputación",
       "novice": "Novato",
-      "noviceDesc": "Alcanzaste 10 puntos de karma",
+      "noviceDesc": "Alcanzaste 10 puntos de reputación",
       "contributor": "Contribuidor",
-      "contributorDesc": "Alcanzaste 50 puntos de karma",
+      "contributorDesc": "Alcanzaste 50 puntos de reputación",
       "risingStar": "Estrella en ascenso",
-      "risingStarDesc": "Alcanzaste 100 puntos de karma",
+      "risingStarDesc": "Alcanzaste 100 puntos de reputación",
       "earlyAdopter": "Pionero",
       "earlyAdopterDesc": "Parte de la comunidad desde el inicio",
       "communityHero": "Héroe de la comunidad",
-      "communityHeroDesc": "Alcanzaste 500 puntos de karma",
+      "communityHeroDesc": "Alcanzaste 500 puntos de reputación",
       "legend": "Leyenda",
-      "legendDesc": "Alcanzaste 1000 puntos de karma",
+      "legendDesc": "Alcanzaste 1000 puntos de reputación",
       "phoenix": "Fénix",
-      "phoenixDesc": "Alcanzaste 2500 puntos de karma",
+      "phoenixDesc": "Alcanzaste 2500 puntos de reputación",
       "unstoppable": "Imparable",
-      "unstoppableDesc": "Alcanzaste 5000 puntos de karma",
+      "unstoppableDesc": "Alcanzaste 5000 puntos de reputación",
       "bugHunter": "Cazador de errores",
       "bugHunterDesc": "Reportaste errores útiles",
       "helper": "Ayudante",
@@ -842,9 +842,9 @@
         "No vendemos tus datos"
       ]
     },
-    "karma": {
-      "title": "Karma = Confianza y crecimiento",
-      "body": "Oxy Karma es un sistema de puntos que reacciona a lo que haces. Las acciones útiles, respetuosas y constructivas lo aumentan. Las acciones dañinas o de poco esfuerzo lo reducen. Más karma puede desbloquear beneficios; poco karma puede limitar funciones. Mantiene la justicia y recompensa la contribución real."
+    "reputation": {
+      "title": "Reputación = Confianza y crecimiento",
+      "body": "Oxy Trust es un sistema de reputación que reacciona a lo que haces. Las acciones útiles, respetuosas y constructivas la aumentan. Las acciones dañinas o de poco esfuerzo la reducen. Más reputación puede desbloquear beneficios; poca reputación puede limitar funciones. Mantiene la justicia y recompensa la contribución real."
     },
     "avatar": {
       "title": "Hazlo tuyo",
@@ -854,7 +854,7 @@
     },
     "ready": {
       "title": "¡Todo listo!",
-      "body": "Explora. Contribuye. Gana karma. Mantén el control."
+      "body": "Explora. Contribuye. Gana reputación. Mantén el control."
     },
     "actions": {
       "back": "Atrás",

package/src/index.ts

@@ -67,6 +67,7 @@ export { OxyAppDataIdentifierError } from './mixins/OxyServices.appData';
 // ---------------------------------------------------------------------------
 export type {
     Application,
+    PublicApplication,
     ApplicationMember,
     ApplicationCredential,
     ApplicationRole,
@@ -92,6 +93,51 @@ export type {
     ApplicationSuccessResult,
 } from './mixins/OxyServices.applications';
 
+// ---------------------------------------------------------------------------
+// Workspaces (multi-user containers: membership, roles)
+// ---------------------------------------------------------------------------
+export type {
+    Workspace,
+    WorkspaceMember,
+    WorkspaceRole,
+    WorkspaceType,
+    WorkspaceStatus,
+    WorkspaceMemberStatus,
+    CreateWorkspaceInput,
+    UpdateWorkspaceInput,
+    InviteWorkspaceMemberInput,
+    UpdateWorkspaceMemberInput,
+    TransferWorkspaceOwnershipInput,
+    WorkspaceSuccessResult,
+} from './mixins/OxyServices.workspaces';
+
+// ---------------------------------------------------------------------------
+// Reputation (Oxy Trust: ledger, balances, disputes, rules, influence)
+// ---------------------------------------------------------------------------
+export type {
+    ReputationCategory,
+    TrustTier,
+    ReputationTransactionStatus,
+    ReputationTargetEntityType,
+    ReputationDisputeStatus,
+    ReputationInfluenceContext,
+    ReputationTransaction,
+    ReputationBalanceBreakdown,
+    ReputationInfluence,
+    ReputationReliability,
+    ReputationBalance,
+    ReputationDispute,
+    ReputationRule,
+    ReputationLeaderboardEntry,
+    ReputationInfluenceResult,
+    ReverseReputationTransactionResult,
+    AwardReputationInput,
+    CreateReputationDisputeInput,
+    ResolveReputationDisputeInput,
+    UpsertReputationRuleInput,
+    ReverseReputationTransactionInput,
+} from './mixins/OxyServices.reputation';
+
 // ---------------------------------------------------------------------------
 // Auth helpers (token refresh, error normalisation, retry policies)
 // ---------------------------------------------------------------------------
@@ -171,10 +217,6 @@ export type {
     TransactionResponse,
     PaginationInfo,
     SearchProfilesResponse,
-    KarmaRule,
-    KarmaHistory,
-    KarmaLeaderboardEntry,
-    KarmaAwardRequest,
     ApiError,
     PaymentMethod,
     PaymentRequest,
@@ -432,6 +474,11 @@ export type {
     RunColdBootOptions,
 } from './utils/coldBoot';
 
+// API response contracts (request/response Zod schemas + inferred types) live in
+// `@oxyhq/contracts` — the single source of truth shared by the backend and every
+// client SDK. Import them directly from `@oxyhq/contracts`; `@oxyhq/core` does NOT
+// re-export them (no barrel re-exports — clean imports from the owning package).
+
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------

package/src/mixins/OxyServices.applications.ts

@@ -58,12 +58,22 @@ export interface Application {
   webhookUrl?: string;
   devWebhookUrl?: string;
   createdByUserId: string;
+  /**
+   * The workspace this application belongs to (workspace `_id`), or `null` for
+   * applications not owned by a workspace. Used by the console to scope apps to
+   * a workspace and to branch on workspace-derived access.
+   */
+  workspaceId: string | null;
   createdAt: string;
   updatedAt: string;
   /**
    * The calling user's own membership in this application, embedded by the API
    * on list (`GET /applications`) and detail (`GET /applications/:appId`)
    * responses. Use `callerMembership.permissions` to gate UI affordances.
+   *
+   * When the caller's access is derived from a workspace membership rather than
+   * a direct application membership, the API returns a synthetic membership
+   * with `source: 'workspace'` and `_id: null`.
    */
   callerMembership?: ApplicationMember;
 }
@@ -73,7 +83,11 @@ export interface Application {
  * on the server at write time.
  */
 export interface ApplicationMember {
-  _id: string;
+  /**
+   * The membership's Mongo `_id`. `null` for a synthetic, workspace-derived
+   * membership (see {@link Application.callerMembership} and `source`).
+   */
+  _id: string | null;
   applicationId: string;
   userId: string;
   role: ApplicationRole;
@@ -81,6 +95,13 @@ export interface ApplicationMember {
   invitedByUserId?: string;
   joinedAt?: string;
   status: ApplicationMemberStatus;
+  /**
+   * Origin of this membership. When `'workspace'`, the membership is synthetic
+   * and derived from the caller's workspace membership rather than a direct
+   * application membership (in which case `_id` is `null`). Absent or any other
+   * value indicates a direct application membership.
+   */
+  source?: 'workspace';
   createdAt: string;
   updatedAt: string;
 }
@@ -110,6 +131,39 @@ export interface ApplicationCredential {
   updatedAt: string;
 }
 
+/**
+ * Sanitized, PUBLIC application identity returned by the API when resolving a
+ * cross-app/OAuth client to a registered {@link Application}.
+ *
+ * Unlike {@link Application}, this shape carries NO sensitive or membership
+ * fields — it is safe to display unauthenticated in consent/authorize screens
+ * and device-flow approval UIs. The API resolves a `client_id` (OAuth
+ * credential public key) to the owning application and projects only the
+ * fields below. `id` is the application's `_id` as a string.
+ */
+export interface PublicApplication {
+  /** The application's Mongo `_id` as a string. */
+  id: string;
+  /** Human-readable application name shown to the user. */
+  name: string;
+  /** Optional short description of what the application does. */
+  description?: string;
+  /** Optional icon URL for the application. */
+  icon?: string;
+  /** Optional public website/homepage URL for the application. */
+  websiteUrl?: string;
+  /** Application classification (set by Oxy platform staff). */
+  type: ApplicationType;
+  /** Whether the application is an officially endorsed Oxy application. */
+  isOfficial: boolean;
+  /** Whether the application is an internal Oxy ecosystem application. */
+  isInternal: boolean;
+  /** OAuth scopes the application is configured to request. */
+  scopes: string[];
+  /** Optional display name of the developer/owner organisation. */
+  developerName?: string;
+}
+
 /** Input accepted by `createApplication`. Staff-only fields are not settable here. */
 export interface CreateApplicationInput {
   name: string;
@@ -118,6 +172,11 @@ export interface CreateApplicationInput {
   icon?: string;
   redirectUris?: string[];
   scopes?: string[];
+  /**
+   * Optional workspace `_id` to create the app in. Omitted → API defaults to
+   * the caller's personal workspace.
+   */
+  workspaceId?: string;
 }
 
 /** Input accepted by `updateApplication`. Staff-only fields are not settable here. */
@@ -135,7 +194,11 @@ export interface UpdateApplicationInput {
 
 /** Input accepted by `inviteApplicationMember`. The owner role cannot be invited. */
 export interface InviteApplicationMemberInput {
-  userId: string;
+  /**
+   * The username or email of the user to invite. Resolved to a user server-side;
+   * an unknown value yields a 404 "User not found".
+   */
+  usernameOrEmail: string;
   role: Exclude<ApplicationRole, 'owner'>;
 }
 
@@ -222,14 +285,47 @@ export function OxyServicesApplicationsMixin<T extends typeof OxyServicesBase>(B
       super(...(args as [any]));
     }
 
+    /**
+     * Resolve an OAuth client identifier to the owning application's PUBLIC
+     * identity. No authentication required — the API returns only sanitized,
+     * display-safe metadata ({@link PublicApplication}). Use this to render the
+     * requesting application's name/icon in consent, authorize, and device-flow
+     * approval UIs before any session exists.
+     *
+     * @param clientId - The OAuth `client_id` (an active credential's public
+     *   key). URL-encoded before being placed in the path.
+     */
+    async getPublicApplication(clientId: string): Promise<PublicApplication> {
+      try {
+        const res = await this.makeRequest<{ application: PublicApplication }>(
+          'GET',
+          `/auth/oauth/client/${encodeURIComponent(clientId)}`,
+          undefined,
+          { cache: true, cacheTTL: CACHE_TIMES.MEDIUM },
+        );
+        return res.application;
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
     /**
      * List applications the current user is an active member of.
+     *
+     * @param workspaceId - Optional workspace `_id` to scope the listing to
+     *   applications belonging to that workspace. When provided it is appended
+     *   as a `workspaceId` query parameter (URL-encoded). The query string is
+     *   part of the request path, so the response cache keys on it
+     *   automatically — scoped and unscoped lists never collide.
      */
-    async getApplications(): Promise<Application[]> {
+    async getApplications(workspaceId?: string): Promise<Application[]> {
       try {
+        const path = workspaceId
+          ? `/applications?workspaceId=${encodeURIComponent(workspaceId)}`
+          : '/applications';
         const res = await this.makeRequest<{ applications?: Application[] }>(
           'GET',
-          '/applications',
+          path,
           undefined,
           { cache: true, cacheTTL: CACHE_TIMES.MEDIUM },
         );
@@ -335,7 +431,9 @@ export function OxyServicesApplicationsMixin<T extends typeof OxyServicesBase>(B
     /**
      * Add a member to an application.
      * @param applicationId - The application's Mongo `_id`.
-     * @param data - Target user id and role (never `owner`).
+     * @param data - Target user's username or email and role (never `owner`).
+     *   The server resolves `usernameOrEmail` to a user; an unknown value yields
+     *   a 404 "User not found".
      */
     async inviteApplicationMember(
       applicationId: string,

package/src/mixins/OxyServices.auth.ts

@@ -9,6 +9,7 @@ import type {
   RefreshAllAccount,
   RefreshCookieResponse,
 } from '../models/interfaces';
+import type { UserNameResponse } from '@oxyhq/contracts';
 import type { SessionLoginResponse } from '../models/session';
 import type { OxyServicesBase } from '../OxyServices.base';
 import { OxyAuthenticationError } from '../OxyServices.errors';
@@ -718,7 +719,7 @@ export function OxyServicesAuthMixin<T extends typeof OxyServicesBase>(Base: T)
           accessToken?: string;
           expiresAt?: string;
           sessionId?: string;
-          user?: { id?: string; _id?: string; username?: string; name?: string; avatar?: string | null; email?: string; color?: string | null };
+          user?: { id?: string; _id?: string; username?: string; name?: UserNameResponse; avatar?: string | null; email?: string; color?: string | null };
         };
         if (!e.accessToken || !e.expiresAt || !e.sessionId || !e.user) {
           continue;