@danainnovations/directory 0.1.1 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # @danainnovations/directory
 
-Sonance employee directory SDK. Zero-config access to the company's active directory (synced from Okta/AD via SCIM).
+Sonance employee directory SDK. Access the company's active directory (synced live from Okta/AD via SCIM).
 
 ## Install
 
@@ -8,7 +8,24 @@ Sonance employee directory SDK. Zero-config access to the company's active direc
 npm install @danainnovations/directory
 ```
 
-No environment variables or API keys needed. Just install and use.
+## Setup (pick one)
+
+**Option A: Environment variable**
+
+Add to your `.env`:
+```
+DIRECTORY_KEY=your-key-here
+```
+
+**Option B: Call `init()` at app startup**
+
+```ts
+import { init } from '@danainnovations/directory'
+
+init('your-key-here')
+```
+
+Get your key from the Sonance IT team or internal wiki.
 
 ## React Hooks
 
@@ -90,16 +107,17 @@ interface UserSearchParams {
 
 ## How It Works
 
-This package connects directly to a Supabase database that receives live SCIM provisioning from Okta. The data updates automatically whenever IT makes changes in Okta/Active Directory (new hires, terminations, department changes, etc.). Only active employees are returned — non-person accounts (service accounts, rooms, test users) are filtered out by row-level security.
+This package connects directly to a Supabase database that receives live SCIM provisioning from Okta. The data updates automatically whenever IT makes changes in Okta/Active Directory (new hires, terminations, department changes, etc.). Only active employees are returned — non-person accounts (service accounts, rooms, test users) are filtered out by row-level security. A valid directory key is required to access the data.
 
 ## AI Integration Notes
 
 When integrating this package into a project:
+- **IMPORTANT**: The project must have a `DIRECTORY_KEY` env var set, or call `init("key")` before any queries. Without it, all queries return empty results.
 - Use the React hooks (`useUsers`, `useUser`, `useDepartments`, `useOrgChart`) for client components
 - Use the async functions (`getUsers`, `getUser`, `getDepartments`, `getOrgChart`) for server components, API routes, or scripts
 - All hooks return `{ loading, error }` alongside the data
 - The `useUsers` hook re-fetches automatically when search params change
-- No providers, context, or setup needed — just import and use
+- No providers or context needed — just set the key and import
 - For people pickers / autocomplete, use `useUsers({ search: inputValue })` with a debounced input
 - For org charts, `useOrgChart()` returns a tree — each node has a `.reports[]` array of direct reports
 - For department filters, `useDepartments()` returns departments sorted alphabetically with employee counts

package/dist/index.d.mts

@@ -38,6 +38,12 @@ interface OrgNode {
     reports: OrgNode[];
 }
 
+/**
+ * Initialize the directory SDK with your access key.
+ * Alternatively, set the DIRECTORY_KEY environment variable.
+ */
+declare function init(key: string): void;
+
 declare function getUsers(params?: UserSearchParams): Promise<UserSearchResult>;
 declare function getUser(emailOrId: string): Promise<DirectoryUser | null>;
 declare function getDepartments(): Promise<Department[]>;
@@ -65,4 +71,4 @@ declare function useOrgChart(): {
     error: Error | null;
 };
 
-export { type Department, type DirectoryUser, type OrgNode, type UserSearchParams, type UserSearchResult, getDepartments, getOrgChart, getUser, getUsers, useDepartments, useOrgChart, useUser, useUsers };
+export { type Department, type DirectoryUser, type OrgNode, type UserSearchParams, type UserSearchResult, getDepartments, getOrgChart, getUser, getUsers, init, useDepartments, useOrgChart, useUser, useUsers };

package/dist/index.d.ts

@@ -38,6 +38,12 @@ interface OrgNode {
     reports: OrgNode[];
 }
 
+/**
+ * Initialize the directory SDK with your access key.
+ * Alternatively, set the DIRECTORY_KEY environment variable.
+ */
+declare function init(key: string): void;
+
 declare function getUsers(params?: UserSearchParams): Promise<UserSearchResult>;
 declare function getUser(emailOrId: string): Promise<DirectoryUser | null>;
 declare function getDepartments(): Promise<Department[]>;
@@ -65,4 +71,4 @@ declare function useOrgChart(): {
     error: Error | null;
 };
 
-export { type Department, type DirectoryUser, type OrgNode, type UserSearchParams, type UserSearchResult, getDepartments, getOrgChart, getUser, getUsers, useDepartments, useOrgChart, useUser, useUsers };
+export { type Department, type DirectoryUser, type OrgNode, type UserSearchParams, type UserSearchResult, getDepartments, getOrgChart, getUser, getUsers, init, useDepartments, useOrgChart, useUser, useUsers };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   getOrgChart: () => getOrgChart,
   getUser: () => getUser,
   getUsers: () => getUsers,
+  init: () => init,
   useDepartments: () => useDepartments,
   useOrgChart: () => useOrgChart,
   useUser: () => useUser,
@@ -36,12 +37,29 @@ var import_supabase_js = require("@supabase/supabase-js");
 var SUPABASE_URL = "https://vfwtukipsinfkfjtivbw.supabase.co";
 var SUPABASE_ANON_KEY = "sb_publishable_V0y4tzcVuftRGEAdvwHloA_iQf7tPUz";
 var client = null;
+var directoryKey = null;
+function init(key) {
+  directoryKey = key;
+  client = null;
+}
+function getKey() {
+  const key = directoryKey || typeof process !== "undefined" && process.env?.DIRECTORY_KEY || "";
+  if (!key) {
+    console.warn('[@danainnovations/directory] No DIRECTORY_KEY set. Call init("your-key") or set the DIRECTORY_KEY env var.');
+  }
+  return key;
+}
 function getDirectoryClient() {
   if (!client) {
     client = (0, import_supabase_js.createClient)(SUPABASE_URL, SUPABASE_ANON_KEY, {
       auth: {
         autoRefreshToken: false,
         persistSession: false
+      },
+      global: {
+        headers: {
+          "x-directory-key": getKey()
+        }
       }
     });
   }
@@ -238,6 +256,7 @@ function useOrgChart() {
   getOrgChart,
   getUser,
   getUsers,
+  init,
   useDepartments,
   useOrgChart,
   useUser,

package/dist/index.mjs

@@ -3,12 +3,29 @@ import { createClient } from "@supabase/supabase-js";
 var SUPABASE_URL = "https://vfwtukipsinfkfjtivbw.supabase.co";
 var SUPABASE_ANON_KEY = "sb_publishable_V0y4tzcVuftRGEAdvwHloA_iQf7tPUz";
 var client = null;
+var directoryKey = null;
+function init(key) {
+  directoryKey = key;
+  client = null;
+}
+function getKey() {
+  const key = directoryKey || typeof process !== "undefined" && process.env?.DIRECTORY_KEY || "";
+  if (!key) {
+    console.warn('[@danainnovations/directory] No DIRECTORY_KEY set. Call init("your-key") or set the DIRECTORY_KEY env var.');
+  }
+  return key;
+}
 function getDirectoryClient() {
   if (!client) {
     client = createClient(SUPABASE_URL, SUPABASE_ANON_KEY, {
       auth: {
         autoRefreshToken: false,
         persistSession: false
+      },
+      global: {
+        headers: {
+          "x-directory-key": getKey()
+        }
       }
     });
   }
@@ -204,6 +221,7 @@ export {
   getOrgChart,
   getUser,
   getUsers,
+  init,
   useDepartments,
   useOrgChart,
   useUser,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danainnovations/directory",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Sonance employee directory — zero-config React hooks and async functions",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",