@viyv/account-client 0.2.1 → 0.3.0

package/dist/server.d.ts

@@ -1,4 +1,5 @@
-import { a as AccountUser, E as Entitlement } from './entitlement-B3pXM2vO.js';
+import { a as AccountUser, E as Entitlement } from './entitlement-CfKncUyH.js';
+export { A as AccountOrg } from './entitlement-CfKncUyH.js';
 import '@viyv/shared';
 
 interface ServerSessionConfig {
@@ -10,12 +11,39 @@ interface ServerSessionConfig {
      */
     cookie: string;
 }
+/** An org the signed-in user belongs to, plus their role in it. */
+interface ResolvedOrg {
+    id: string;
+    slug: string | null;
+    name: string | null;
+    /** The signed-in user's role in this org (e.g. "owner" | "admin" | "member"). */
+    role: string | null;
+}
 /** Resolve the signed-in user from forwarded cookies (or null). */
 declare function getCurrentSession(config: ServerSessionConfig): Promise<{
     user: AccountUser;
     activeOrganizationId: string | null;
 } | null>;
-/** Resolve the org entitlement from forwarded cookies (or null). */
-declare function getEntitlement(config: ServerSessionConfig): Promise<Entitlement | null>;
+/**
+ * Resolve the org entitlement from forwarded cookies (or null).
+ *
+ * Pass `org` (an org id or slug) to read a SPECIFIC org's entitlement — the
+ * URL-scoped read (docs/14). The API membership-verifies it; a non-member org
+ * resolves to null. Omit `org` for the legacy cookie active-org behavior.
+ */
+declare function getEntitlement(config: ServerSessionConfig & {
+    org?: string | null;
+}): Promise<Entitlement | null>;
+/** List every org the signed-in user belongs to (from forwarded cookies). */
+declare function listUserOrgs(config: ServerSessionConfig): Promise<ResolvedOrg[]>;
+/**
+ * Resolve the org named by a URL slug (or id) to a membership-verified org, or
+ * null when the signed-in user is NOT a member of it (docs/14). This is the
+ * server-side seam a product uses to turn `/o/:slug/...` into the org it scopes
+ * its queries to — the URL says *which* org, this verifies the user may see it.
+ */
+declare function resolveOrgFromSlug(config: ServerSessionConfig & {
+    slug: string;
+}): Promise<ResolvedOrg | null>;
 
-export { type ServerSessionConfig, getCurrentSession, getEntitlement };
+export { type ResolvedOrg, type ServerSessionConfig, getCurrentSession, getEntitlement, listUserOrgs, resolveOrgFromSlug };

package/dist/server.js

@@ -1,4 +1,4 @@
-import { parseEntitlement } from './chunk-UX6UAFIF.js';
+import { parseEntitlement } from './chunk-V3SLFECG.js';
 
 // src/server.ts
 async function getJson(url, cookie) {
@@ -27,13 +27,32 @@ async function getCurrentSession(config) {
   };
 }
 async function getEntitlement(config) {
+  const qs = config.org ? `?org=${encodeURIComponent(config.org)}` : "";
   const wire = await getJson(
-    `${config.apiBase}/v1/license/entitlement`,
+    `${config.apiBase}/v1/license/entitlement${qs}`,
     config.cookie
   );
   return wire ? parseEntitlement(wire) : null;
 }
+async function listUserOrgs(config) {
+  const body = await getJson(
+    `${config.apiBase}/v1/users/me/orgs`,
+    config.cookie
+  );
+  return (body?.organizations ?? []).map((o) => ({
+    id: o.organization_id,
+    slug: o.slug ?? null,
+    name: o.name ?? null,
+    role: o.role ?? null
+  }));
+}
+async function resolveOrgFromSlug(config) {
+  const wanted = config.slug.trim();
+  if (!wanted) return null;
+  const orgs = await listUserOrgs(config);
+  return orgs.find((o) => o.slug === wanted || o.id === wanted) ?? null;
+}
 
-export { getCurrentSession, getEntitlement };
+export { getCurrentSession, getEntitlement, listUserOrgs, resolveOrgFromSlug };
 //# sourceMappingURL=server.js.map
 //# sourceMappingURL=server.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viyv/account-client",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "React SDK for viyv account SSO (useUser, useEntitlement, AccountProvider).",
   "type": "module",
   "main": "./dist/index.cjs",