@rjromeoent/ein-supabase 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# @rjromeoent/ein-supabase
+
+Shared Supabase contract package for EIN-connected apps.
+
+This package is the canonical home for:
+
+- Generated Supabase database types across EIN schemas.
+- Registered app slugs and the `x-ein-app` header helper.
+- Shared org-role helpers for `core.app_organization_memberships`.
+- Typed schema-client helpers.
+
+Regenerate database types from the Event Intelligence Network repo root:
+
+```sh
+npm run generate:supabase-types
+```
+
+Apps should import shared contracts from this package instead of hand-maintaining
+partial copies of `core`, `rad`, `booking_engine`, `launchpad`, or other shared
+schemas.
+
+App-specific role variation should be a small local mapping from canonical
+`CoreOrgRole` values. For example, Booking Engine maps `owner/admin` to its
+local `admin` workflow role and `member` to `rep`.
+
+## Build
+
+From the Event Intelligence Network repo root:
+
+```sh
+npm install
+npm run generate:supabase-types
+npm run build:packages
+```
+
+Or from this package directory:
+
+```sh
+npm run clean
+npm run build
+```
+
+The package publishes compiled ESM and declarations from `dist`.
+
+## Publish
+
+This package is intended to be installed by independent Lovable app repos, so
+apps should not depend on `file:../Event-Intelligence-Network/...` outside local
+development.
+
+Publish from the EIN repo root after the `rjromeoent` npm organization is
+available to the publishing user, types are regenerated, and the package build
+passes:
+
+```sh
+npm run build:packages
+npm run pack:ein-supabase
+npm run publish:ein-supabase
+```
+
+The package is configured as a public scoped package. That is intentional for
+Lovable apps: app deploys can install it without an npm auth token. Do not put
+secrets, service-role keys, database passwords, or private environment values in
+this package.
+
+Then app repos should depend on the released version:
+
+```json
+{
+  "dependencies": {
+    "@rjromeoent/ein-supabase": "^0.1.0"
+  }
+}
+```
+
+Use semver intentionally:
+
+- Patch: regenerated types, additive helpers, docs.
+- Minor: additive contracts or new schemas/functions.
+- Major: renamed or removed contracts, breaking permission/app context changes.
+
+## Consumer Rule
+
+App repos may keep their UI-specific adapters and view models locally, but
+shared backend contracts belong here first:
+
+- generated `Database` types
+- app slugs and `x-ein-app`
+- canonical org roles and permission helpers
+- Edge Function request/response contracts
+- shared runtime guards that protect persisted JSON or Edge response boundaries

package/dist/app-context.d.ts

@@ -0,0 +1,13 @@
+export declare const EIN_APP_HEADER = "x-ein-app";
+export declare const EIN_APP_SLUGS: {
+    readonly atlas: "atlas";
+    readonly bookingEngine: "booking_engine";
+    readonly eventOpsConsole: "ein_ops";
+    readonly festivalOs: "festivalos";
+    readonly rad: "rad";
+    readonly rockitLaunchpad: "rockit_launchpad";
+};
+export type EinAppKey = keyof typeof EIN_APP_SLUGS;
+export type EinAppSlug = (typeof EIN_APP_SLUGS)[EinAppKey];
+export declare function isEinAppSlug(value: unknown): value is EinAppSlug;
+export declare function einAppHeaders(appSlug: EinAppSlug): Record<typeof EIN_APP_HEADER, EinAppSlug>;

package/dist/app-context.js

@@ -0,0 +1,16 @@
+export const EIN_APP_HEADER = "x-ein-app";
+export const EIN_APP_SLUGS = {
+    atlas: "atlas",
+    bookingEngine: "booking_engine",
+    eventOpsConsole: "ein_ops",
+    festivalOs: "festivalos",
+    rad: "rad",
+    rockitLaunchpad: "rockit_launchpad",
+};
+const EIN_APP_SLUG_SET = new Set(Object.values(EIN_APP_SLUGS));
+export function isEinAppSlug(value) {
+    return typeof value === "string" && EIN_APP_SLUG_SET.has(value);
+}
+export function einAppHeaders(appSlug) {
+    return { [EIN_APP_HEADER]: appSlug };
+}

package/dist/auth.d.ts

@@ -0,0 +1,7 @@
+import type { Database } from "./generated/database.types.js";
+export type CoreOrgRole = Database["core"]["Enums"]["org_role"];
+export declare const CORE_ORG_ROLES: readonly CoreOrgRole[];
+export declare const CORE_ORG_ROLE_RANK: Record<CoreOrgRole, number>;
+export declare function isCoreOrgRole(value: unknown): value is CoreOrgRole;
+export declare function parseCoreOrgRole(value: unknown, fallback?: CoreOrgRole): CoreOrgRole;
+export declare function coreOrgRoleAtLeast(role: CoreOrgRole, minimum: CoreOrgRole): boolean;

package/dist/auth.js

@@ -0,0 +1,22 @@
+export const CORE_ORG_ROLES = [
+    "owner",
+    "admin",
+    "member",
+    "viewer",
+];
+const CORE_ORG_ROLE_SET = new Set(CORE_ORG_ROLES);
+export const CORE_ORG_ROLE_RANK = {
+    viewer: 0,
+    member: 1,
+    admin: 2,
+    owner: 3,
+};
+export function isCoreOrgRole(value) {
+    return typeof value === "string" && CORE_ORG_ROLE_SET.has(value);
+}
+export function parseCoreOrgRole(value, fallback = "viewer") {
+    return isCoreOrgRole(value) ? value : fallback;
+}
+export function coreOrgRoleAtLeast(role, minimum) {
+    return CORE_ORG_ROLE_RANK[role] >= CORE_ORG_ROLE_RANK[minimum];
+}