@fonderie/workspaces 1.0.0

package/dist/migrations/sql/001_workspaces.sql

@@ -0,0 +1,85 @@
+-- fonderie_workspaces
+CREATE TABLE IF NOT EXISTS fonderie_workspaces (
+	id          UUID        PRIMARY KEY DEFAULT gen_random_uuid(),
+	name        TEXT        NOT NULL,
+	slug        TEXT        NOT NULL,
+	type        TEXT        NOT NULL DEFAULT 'ORGANIZATION',
+	description TEXT,
+	plan        TEXT        NOT NULL DEFAULT 'free',
+	owner_id    UUID        NOT NULL,
+	settings    JSONB       NOT NULL DEFAULT '{}',
+	archived_at TIMESTAMPTZ,
+	archived_by UUID,
+	created_at  TIMESTAMPTZ NOT NULL DEFAULT now(),
+	updated_at  TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_fw_slug
+	ON fonderie_workspaces (slug) WHERE archived_at IS NULL;
+
+CREATE INDEX IF NOT EXISTS idx_fw_owner
+	ON fonderie_workspaces (owner_id);
+
+-- fonderie_roles
+CREATE TABLE IF NOT EXISTS fonderie_roles (
+	id           UUID        PRIMARY KEY DEFAULT gen_random_uuid(),
+	name         TEXT        NOT NULL,
+	workspace_id UUID,
+	is_system    BOOLEAN     NOT NULL DEFAULT false,
+	active       BOOLEAN     NOT NULL DEFAULT true,
+	description  TEXT,
+	created_at   TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_fr_name_ws
+	ON fonderie_roles (name, workspace_id) WHERE workspace_id IS NOT NULL;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_fr_name_system
+	ON fonderie_roles (name) WHERE workspace_id IS NULL;
+
+CREATE INDEX IF NOT EXISTS idx_fr_workspace
+	ON fonderie_roles (workspace_id);
+
+-- Seed system roles
+INSERT INTO fonderie_roles (name, workspace_id, is_system, description)
+VALUES
+	('ADMIN', NULL, true, 'System administrator with full access'),
+	('GUEST', NULL, true, 'Guest user with read-only access')
+ON CONFLICT DO NOTHING;
+
+-- fonderie_role_user_workspaces: one row per (user, workspace, role) assignment
+CREATE TABLE IF NOT EXISTS fonderie_role_user_workspaces (
+	user_id      UUID        NOT NULL,
+	workspace_id UUID        NOT NULL,
+	role_id      UUID        NOT NULL,
+	confirmed    BOOLEAN     NOT NULL DEFAULT false,
+	removed      BOOLEAN     NOT NULL DEFAULT false,
+	suspended    BOOLEAN     NOT NULL DEFAULT false,
+	created_at   TIMESTAMPTZ NOT NULL DEFAULT now(),
+	PRIMARY KEY (user_id, workspace_id, role_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_fruw_user_ws
+	ON fonderie_role_user_workspaces (user_id, workspace_id);
+
+CREATE INDEX IF NOT EXISTS idx_fruw_workspace
+	ON fonderie_role_user_workspaces (workspace_id);
+
+-- fonderie_workspace_invitations
+CREATE TABLE IF NOT EXISTS fonderie_workspace_invitations (
+	id           UUID        PRIMARY KEY DEFAULT gen_random_uuid(),
+	workspace_id UUID        NOT NULL,
+	email        TEXT        NOT NULL,
+	role_id      UUID        NOT NULL,
+	token        TEXT        UNIQUE,
+	pin          TEXT,
+	status       TEXT        NOT NULL DEFAULT 'PENDING',
+	expires_at   TIMESTAMPTZ NOT NULL,
+	created_at   TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS idx_fwi_ws_email
+	ON fonderie_workspace_invitations (workspace_id, email) WHERE status = 'PENDING';
+
+CREATE INDEX IF NOT EXISTS idx_fwi_token
+	ON fonderie_workspace_invitations (token) WHERE token IS NOT NULL;

package/dist/migrations/sql/002_personal_workspace.sql

@@ -0,0 +1,8 @@
+-- Add is_personal flag to fonderie_workspaces
+ALTER TABLE fonderie_workspaces
+	ADD COLUMN IF NOT EXISTS is_personal BOOLEAN NOT NULL DEFAULT false;
+
+-- One personal workspace per user — enforced at the DB level
+CREATE UNIQUE INDEX IF NOT EXISTS idx_fw_personal_owner
+	ON fonderie_workspaces (owner_id)
+	WHERE is_personal = true;

package/dist/migrations/sql/003_organization_profile.sql

@@ -0,0 +1,5 @@
+ALTER TABLE fonderie_workspaces
+  ADD COLUMN IF NOT EXISTS motto          TEXT,
+  ADD COLUMN IF NOT EXISTS phone          TEXT,
+  ADD COLUMN IF NOT EXISTS business_type  TEXT,
+  ADD COLUMN IF NOT EXISTS address        JSONB NOT NULL DEFAULT '{}';

package/dist/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["export type WorkspaceType = 'ORGANIZATION' | 'PERSONAL' | 'TEAM' | 'COMMUNITY' | 'VENDOR';\nexport type InvitationStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'CANCELLED';\nexport type BusinessType = 'SOLE_PROP' | 'PARTNERSHIP' | 'LLC' | 'INC' | 'NONPROFIT' | 'COOPERATIVE';\n\nexport interface IWorkspaceAddress {\n\tline1?: string;\n\tline2?: string;\n\tcity?: string;\n\tstate?: string;\n\tzip?: string;\n\tcountry?: string;\n}\n\nexport interface IWorkspace {\n\tid: string;\n\tname: string;\n\tslug: string;\n\ttype: WorkspaceType;\n\tdescription: string | null;\n\tmotto: string | null;\n\tphone: string | null;\n\tbusinessType: string | null;\n\taddress: IWorkspaceAddress | null;\n\tplan: string;\n\townerId: string;\n\tisPersonal: boolean;\n\tarchivedAt: string | null;\n\tarchivedBy: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string | null;\n}\n\nexport interface IRole {\n\tid: string;\n\tname: string;\n\tisSystem: boolean;\n\tactive: boolean;\n\tdescription: string | null;\n\tworkspaceId: string | null;\n}\n\nexport interface IMember {\n\tuserId: string;\n\tworkspaceId: string;\n\troleId: string;\n\troleName: string;\n\tconfirmed: boolean;\n\tcreatedAt: string;\n\tfirstName: string | null;\n\tlastName: string | null;\n\temail: string | null;\n\tprofileImageUrl: string | null;\n}\n\nexport interface IInvitation {\n\tid: string;\n\tworkspaceId: string;\n\temail: string;\n\troleId: string;\n\ttoken: string;\n\tpin: string | null;\n\tstatus: InvitationStatus;\n\texpiresAt: string;\n\tcreatedAt: string;\n}\n\nexport interface IWorkspaceSettings {\n\tlocale: string;\n\ttimezone: string;\n\tcurrency: string;\n\tdateFormat: string;\n\ttimeFormat: string;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types.d.cts

@@ -0,0 +1,69 @@
+type WorkspaceType = 'ORGANIZATION' | 'PERSONAL' | 'TEAM' | 'COMMUNITY' | 'VENDOR';
+type InvitationStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'CANCELLED';
+type BusinessType = 'SOLE_PROP' | 'PARTNERSHIP' | 'LLC' | 'INC' | 'NONPROFIT' | 'COOPERATIVE';
+interface IWorkspaceAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    zip?: string;
+    country?: string;
+}
+interface IWorkspace {
+    id: string;
+    name: string;
+    slug: string;
+    type: WorkspaceType;
+    description: string | null;
+    motto: string | null;
+    phone: string | null;
+    businessType: string | null;
+    address: IWorkspaceAddress | null;
+    plan: string;
+    ownerId: string;
+    isPersonal: boolean;
+    archivedAt: string | null;
+    archivedBy: string | null;
+    createdAt: string;
+    updatedAt: string | null;
+}
+interface IRole {
+    id: string;
+    name: string;
+    isSystem: boolean;
+    active: boolean;
+    description: string | null;
+    workspaceId: string | null;
+}
+interface IMember {
+    userId: string;
+    workspaceId: string;
+    roleId: string;
+    roleName: string;
+    confirmed: boolean;
+    createdAt: string;
+    firstName: string | null;
+    lastName: string | null;
+    email: string | null;
+    profileImageUrl: string | null;
+}
+interface IInvitation {
+    id: string;
+    workspaceId: string;
+    email: string;
+    roleId: string;
+    token: string;
+    pin: string | null;
+    status: InvitationStatus;
+    expiresAt: string;
+    createdAt: string;
+}
+interface IWorkspaceSettings {
+    locale: string;
+    timezone: string;
+    currency: string;
+    dateFormat: string;
+    timeFormat: string;
+}
+
+export type { BusinessType, IInvitation, IMember, IRole, IWorkspace, IWorkspaceAddress, IWorkspaceSettings, InvitationStatus, WorkspaceType };

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+type WorkspaceType = 'ORGANIZATION' | 'PERSONAL' | 'TEAM' | 'COMMUNITY' | 'VENDOR';
+type InvitationStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'CANCELLED';
+type BusinessType = 'SOLE_PROP' | 'PARTNERSHIP' | 'LLC' | 'INC' | 'NONPROFIT' | 'COOPERATIVE';
+interface IWorkspaceAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    zip?: string;
+    country?: string;
+}
+interface IWorkspace {
+    id: string;
+    name: string;
+    slug: string;
+    type: WorkspaceType;
+    description: string | null;
+    motto: string | null;
+    phone: string | null;
+    businessType: string | null;
+    address: IWorkspaceAddress | null;
+    plan: string;
+    ownerId: string;
+    isPersonal: boolean;
+    archivedAt: string | null;
+    archivedBy: string | null;
+    createdAt: string;
+    updatedAt: string | null;
+}
+interface IRole {
+    id: string;
+    name: string;
+    isSystem: boolean;
+    active: boolean;
+    description: string | null;
+    workspaceId: string | null;
+}
+interface IMember {
+    userId: string;
+    workspaceId: string;
+    roleId: string;
+    roleName: string;
+    confirmed: boolean;
+    createdAt: string;
+    firstName: string | null;
+    lastName: string | null;
+    email: string | null;
+    profileImageUrl: string | null;
+}
+interface IInvitation {
+    id: string;
+    workspaceId: string;
+    email: string;
+    roleId: string;
+    token: string;
+    pin: string | null;
+    status: InvitationStatus;
+    expiresAt: string;
+    createdAt: string;
+}
+interface IWorkspaceSettings {
+    locale: string;
+    timezone: string;
+    currency: string;
+    dateFormat: string;
+    timeFormat: string;
+}
+
+export type { BusinessType, IInvitation, IMember, IRole, IWorkspace, IWorkspaceAddress, IWorkspaceSettings, InvitationStatus, WorkspaceType };

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,92 @@
+{
+	"name": "@fonderie/workspaces",
+	"version": "1.0.0",
+	"description": "Multi-tenant team layer — create workspaces, manage members, define custom roles, handle token-based invitations, and scope any route to a specific workspace.",
+	"keywords": [
+		"fonderie-js",
+		"workspaces",
+		"multi-tenant",
+		"teams",
+		"organizations",
+		"invitations",
+		"rbac",
+		"saas",
+		"typescript"
+	],
+	"license": "MIT",
+	"type": "module",
+	"engines": {
+		"node": ">=20"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
+		"./types": {
+			"types": "./dist/types.d.ts",
+			"import": "./dist/types.js",
+			"require": "./dist/types.cjs"
+		},
+		"./middleware": {
+			"types": "./dist/middlewares/index.d.ts",
+			"import": "./dist/middlewares/index.js",
+			"require": "./dist/middlewares/index.cjs"
+		},
+		"./migrations": {
+			"types": "./dist/migrations/index.d.ts",
+			"import": "./dist/migrations/index.js"
+		}
+	},
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "tsup && node -e \"require('node:fs').cpSync('src/migrations/sql', 'dist/migrations/sql', {recursive:true})\"",
+		"dev": "tsup --watch",
+		"typecheck": "tsc --noEmit",
+		"test": "tsx --test src/__tests__/*.test.ts",
+		"lint": "biome lint src",
+		"format": "biome format --write src",
+		"check": "biome check --write src"
+	},
+	"peerDependencies": {
+		"@fonderie/billing": "^1.0.0",
+		"@fonderie/core": "^0.1.0",
+		"@fonderie/events": "^1.0.0",
+		"@fonderie/store": "^0.1.0"
+	},
+	"peerDependenciesMeta": {
+		"@fonderie/events": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@fonderie/billing": "../billing",
+		"@fonderie/core": "../core",
+		"@fonderie/events": "../events",
+		"@fonderie/store": "../store",
+		"@types/node": "^25.6.0",
+		"tsup": "^8.5.1",
+		"tsx": "^4.21.0",
+		"typescript": "^6.0.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist",
+		"LICENSE",
+		"README.md"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/fonderie-js/sdk.git",
+		"directory": "packages/workspaces"
+	},
+	"homepage": "https://github.com/fonderie-js/sdk/tree/main/packages/workspaces#readme",
+	"bugs": {
+		"url": "https://github.com/fonderie-js/sdk/issues"
+	}
+}