@rjromeoent/ein-supabase 0.1.1 → 0.1.2

package/README.md

@@ -5,6 +5,7 @@ Shared Supabase contract package for EIN-connected apps.
 This package is the canonical home for:
 
 - Generated Supabase database types across EIN schemas.
+- Type aliases for canonical database-owned enums.
 - Registered app slugs and the `x-ein-app` header helper.
 - Shared org-role helpers for `core.app_organization_memberships`.
 - Typed schema-client helpers.
@@ -106,6 +107,38 @@ These represent the actual EIN database contract. Every connected app should
 compile against the same source of truth instead of copying partial generated
 types.
 
+#### Database-Owned Enum Aliases
+
+Examples:
+
+- `CoreArtistGenre`
+- `RadDbAvailabilityStatus`
+- `RadDbAssignmentState`
+- `RadDbDecisionType`
+- `BookingOfferStatus`
+
+Why:
+
+These are type aliases over generated Supabase enum types. They give apps a
+stable import name for canonical database-owned values without copying enum
+strings into each app.
+
+Use these aliases at API, adapter, and database-boundary layers when the value
+is the raw backend contract:
+
+```ts
+import type { RadDbDecisionType } from "@rjromeoent/ein-supabase";
+
+interface DecisionRow {
+  decision_type: RadDbDecisionType | null;
+}
+```
+
+Do not use these aliases for app-specific display buckets or UI commands. For
+example, RAD's dashboard label `"Available"` and command action `"shortlist"`
+are app vocabulary, while database values like `available` and `shortlisted`
+are backend vocabulary.
+
 #### App Registry And Request Context
 
 Examples:

package/dist/db-enums.d.ts

@@ -0,0 +1,10 @@
+import type { Database } from "./generated/database.types.js";
+export type CoreArtistGenre = Database["core"]["Enums"]["artist_genre"];
+export type RadDbAssignmentState = Database["rad"]["Enums"]["assignment_state"];
+export type RadDbAssignmentStatus = Database["rad"]["Enums"]["assignment_status"];
+export type RadDbAvailabilityStatus = Database["rad"]["Enums"]["availability_status"];
+export type RadDbDecisionActorType = Database["rad"]["Enums"]["decision_actor_type"];
+export type RadDbDecisionType = Database["rad"]["Enums"]["decision_type"];
+export type RadDbOfferLinkStatus = Database["rad"]["Enums"]["offer_link_status"];
+export type BookingHoldLevel = Database["booking_engine"]["Enums"]["hold_level"];
+export type BookingOfferStatus = Database["booking_engine"]["Enums"]["offer_status"];

package/dist/db-enums.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./app-context.js";
 export * from "./auth.js";
+export type * from "./db-enums.js";
 export * from "./json.js";
 export * from "./schema-client.js";
 export type { Constants, Database, Enums, Json, Tables, TablesInsert, TablesUpdate, } from "./generated/database.types.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rjromeoent/ein-supabase",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Shared Supabase types, app context, and contract helpers for EIN-connected apps.",
   "type": "module",
   "sideEffects": false,