@aghents/identity 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,166 @@
+import { Result } from 'neverthrow';
+import { SupabaseClient, SupportedStorage } from '@supabase/supabase-js';
+import { z } from 'zod';
+
+type Database = {
+    identity: {
+        Tables: {
+            profiles: {
+                Row: {
+                    created_at: string;
+                    display_name: string | null;
+                    entitlement: string;
+                    handle: string;
+                    id: string;
+                    kind: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    display_name?: string | null;
+                    entitlement?: string;
+                    handle: string;
+                    id: string;
+                    kind?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    display_name?: string | null;
+                    entitlement?: string;
+                    handle?: string;
+                    id?: string;
+                    kind?: string;
+                };
+                Relationships: [];
+            };
+            ratings: {
+                Row: {
+                    dimension: string;
+                    game: string;
+                    profile_id: string;
+                    updated_at: string;
+                    value: number;
+                };
+                Insert: {
+                    dimension: string;
+                    game: string;
+                    profile_id: string;
+                    updated_at?: string;
+                    value?: number;
+                };
+                Update: {
+                    dimension?: string;
+                    game?: string;
+                    profile_id?: string;
+                    updated_at?: string;
+                    value?: number;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "ratings_profile_id_fkey";
+                        columns: ["profile_id"];
+                        isOneToOne: false;
+                        referencedRelation: "profiles";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            waitlist: {
+                Row: {
+                    created_at: string;
+                    email: string;
+                    id: number;
+                    note: string | null;
+                };
+                Insert: {
+                    created_at?: string;
+                    email: string;
+                    id?: never;
+                    note?: string | null;
+                };
+                Update: {
+                    created_at?: string;
+                    email?: string;
+                    id?: never;
+                    note?: string | null;
+                };
+                Relationships: [];
+            };
+        };
+        Views: {
+            [_ in never]: never;
+        };
+        Functions: {
+            claim_handle: {
+                Args: {
+                    p_handle: string;
+                };
+                Returns: {
+                    created_at: string;
+                    display_name: string | null;
+                    entitlement: string;
+                    handle: string;
+                    id: string;
+                    kind: string;
+                };
+                SetofOptions: {
+                    from: "*";
+                    to: "profiles";
+                    isOneToOne: true;
+                    isSetofReturn: false;
+                };
+            };
+            join_waitlist: {
+                Args: {
+                    p_email: string;
+                    p_note?: string;
+                };
+                Returns: undefined;
+            };
+        };
+        Enums: {
+            [_ in never]: never;
+        };
+        CompositeTypes: {
+            [_ in never]: never;
+        };
+    };
+};
+
+declare const schema: z.ZodObject<{
+    SUPABASE_URL: z.ZodString;
+    SUPABASE_ANON_KEY: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    SUPABASE_URL: string;
+    SUPABASE_ANON_KEY: string;
+}, {
+    SUPABASE_URL: string;
+    SUPABASE_ANON_KEY: string;
+}>;
+type IdentityEnv = z.infer<typeof schema>;
+declare function readEnv(raw: Record<string, string | undefined>): IdentityEnv;
+
+type IdentityClient = SupabaseClient<Database>;
+type IdentityClientOptions = {
+    persistSession?: boolean;
+    storage?: SupportedStorage;
+};
+declare function createIdentityClient(env: IdentityEnv, opts?: IdentityClientOptions): IdentityClient;
+
+type Profile = {
+    id: string;
+    handle: string;
+    displayName: string | null;
+    kind: "human" | "persona";
+    entitlement: string;
+};
+type IdentityError = {
+    code: "auth" | "db" | "taken";
+    message: string;
+};
+declare function getOrCreateGuest(client: IdentityClient): Promise<Result<{
+    userId: string;
+}, IdentityError>>;
+declare function claimHandle(client: IdentityClient, handle: string): Promise<Result<Profile, IdentityError>>;
+declare function joinWaitlist(client: IdentityClient, email: string, note?: string): Promise<Result<void, IdentityError>>;
+
+export { type Database, type IdentityClient, type IdentityEnv, type IdentityError, type Profile, claimHandle, createIdentityClient, getOrCreateGuest, joinWaitlist, readEnv };

package/dist/index.js

@@ -0,0 +1,56 @@
+// src/index.ts
+import { err, ok } from "neverthrow";
+
+// src/client.ts
+import { createClient } from "@supabase/supabase-js";
+function createIdentityClient(env, opts = {}) {
+  const persistSession = opts.persistSession ?? true;
+  if (persistSession && !opts.storage && typeof localStorage === "undefined") {
+    throw new Error(
+      "createIdentityClient: no localStorage here; pass { storage } (AsyncStorage on native) or { persistSession: false }"
+    );
+  }
+  return createClient(env.SUPABASE_URL, env.SUPABASE_ANON_KEY, {
+    auth: { persistSession, storage: opts.storage }
+  });
+}
+
+// src/env.ts
+import { z } from "zod";
+var schema = z.object({ SUPABASE_URL: z.string().url(), SUPABASE_ANON_KEY: z.string().min(20) });
+function readEnv(raw) {
+  return schema.parse(raw);
+}
+
+// src/index.ts
+var toProfile = (r) => ({
+  id: r.id,
+  handle: r.handle,
+  displayName: r.display_name,
+  kind: r.kind,
+  entitlement: r.entitlement
+});
+async function getOrCreateGuest(client) {
+  const existing = await client.auth.getSession();
+  if (existing.data.session) return ok({ userId: existing.data.session.user.id });
+  const { data, error } = await client.auth.signInAnonymously();
+  if (error || !data.user) return err({ code: "auth", message: error?.message ?? "no user" });
+  return ok({ userId: data.user.id });
+}
+async function claimHandle(client, handle) {
+  const { data, error } = await client.schema("identity").rpc("claim_handle", { p_handle: handle });
+  if (error) return err({ code: error.code === "23505" ? "taken" : "db", message: error.message });
+  return ok(toProfile(data));
+}
+async function joinWaitlist(client, email, note) {
+  const { error } = await client.schema("identity").rpc("join_waitlist", { p_email: email, p_note: note ?? void 0 });
+  if (error) return err({ code: "db", message: error.message });
+  return ok(void 0);
+}
+export {
+  claimHandle,
+  createIdentityClient,
+  getOrCreateGuest,
+  joinWaitlist,
+  readEnv
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@aghents/identity",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.110.2",
+    "neverthrow": "^8.1.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "jsdom": "^25.0.1",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  }
+}