@guinetik/primitives-ts 0.8.2 → 0.8.4

package/README.md

@@ -40,31 +40,105 @@ const metrics: SystemMetrics = {
 };
 ```
 
-## Type Categories
-
-### Authentication (`auth.types.ts`)
-- `User` - User information
-- `AuthResponse` - Authentication response
-- `AuthProvider` - Authentication provider types
-- `UserUpdateData` - User profile update data
-- `LoginPayload` - Login request payload
-
-### System Monitoring (`system.types.ts`)
-- `SystemMetrics` - System metrics (CPU, memory, disk)
-- `Container` - Docker container information
-- `LogEntry` - Container log entry
-- `NetworkStats` - Network statistics
-- `DeploymentInfo` - Deployment information
-- `CommandResult` - Shell command execution result
-
-### Website Content (`website.types.ts`)
-- `SiteContent` - Full site content structure
-- `SiteMetadata` - Site metadata
-- `Menu`, `MenuItem` - Navigation menu
-- `Theme`, `ThemeConfig` - Theme configuration
-- `Card`, `Tag` - Project/demo cards with tags
-- `Experiment` - CodePen experiments
-- `AboutSection`, `ProjectsSection`, `DemosSection`, `ReposSection` - Content sections
+## Concept Catalog
+
+`primitives-ts` is the contract layer of the Guinetik stack. Every type below is
+consumed by at least two of: the NestJS API, the Vue admin panel, the Firestore
+migration tooling, and guinetik.com itself.
+
+```mermaid
+flowchart LR
+  P[primitives-ts]
+  P --> ID[Identity]
+  P --> CO[Content]
+  P --> OP[Operations]
+  P --> AS[Assistant]
+  P --> ST[Storage]
+
+  ID --> ID1[auth]
+  ID --> ID2[access]
+  ID --> ID3[totp]
+  ID --> ID4[security]
+
+  CO --> CO1[website]
+  CO --> CO2[launchpad]
+  CO --> CO3[files]
+
+  OP --> OP1[system]
+  OP --> OP2[agents]
+  OP --> OP3[deployments]
+  OP --> OP4[github]
+
+  AS --> AS1[chat]
+  AS --> AS2[guards]
+
+  ST --> ST1[firestore]
+```
+
+### How the domains relate
+
+```mermaid
+flowchart LR
+  A[auth<br/>who you are] --> B[access<br/>what you may do]
+  T[totp<br/>second factor] --> A
+  B --> F[FeatureKey]
+  F --> C[Content]
+  F --> O[Operations]
+  F --> X[Assistant]
+  C --> S[(firestore)]
+  X --> S
+```
+
+Authentication proves identity, access control turns that identity into a set of
+`FeatureKey` grants, and every other domain is gated by one of those keys. The
+Firestore document types are the persisted shape of whatever the other domains
+produce.
+
+---
+
+### Identity & Access
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `auth.types` | `User`, `AuthResponse`, `LoginPayload`, `AuthProvider`, `UserProvider` | Firebase-backed sign-in, email or Google |
+| `access.types` | `AdminRole`, `FeatureKey`, `FEATURE_CATALOG`, `AdminUser`, `userHasFeature` | Role plus per-feature grants for the admin panel |
+| `totp.types` | `TotpSetupResponse`, `TotpVerifyRequest`, `TotpStatusResponse` | Time-based one-time password enrolment and checks |
+| `security.interface` | `Security`, `SecurityLevel`, `SecurityChallengeResult` | Provider-agnostic challenge contract |
+
+An `AdminUser` is an `admin` or a `guest`; a guest sees only the features
+explicitly granted to it. The nine grantable features are `dashboard`, `site`,
+`runtime`, `files`, `launchpad`, `users`, `system`, `chat` and `agents`.
+
+### Content
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `website.types` | `SiteContent`, `SiteMetadata`, `SiteSections`, `Menu`, `Theme`, `Card` | Everything guinetik.com renders |
+| `website-firestore.types` | `ProjectDocument`, `DemoDocument`, `FIRESTORE_COLLECTIONS` | The stored counterparts of the above |
+| `launchpad.types` | `LaunchpadBoard`, `LaunchpadGroup`, `LaunchpadItem` | Bookmark board grouping and layout |
+| `file.types` | `FileMetadata`, `FileUploadResponse`, `FileUploadProgress` | Uploads and their lifecycle |
+
+### Operations
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `system.types` | `SystemMetrics`, `Container`, `LogEntry`, `NetworkStats`, `CommandResult` | Host and Docker telemetry |
+| `agent.types` | `AgentInfo`, `AgentStatus`, `AgentTask`, `AgentTasksResponse` | Autonomous agent fleet monitoring |
+| `deployment-history.types` | `DeploymentRecord`, `DeploymentHistoryResponse` | What shipped, when, and whether it held |
+| `github.types` | `GitHubRepository`, `GitHubOwner`, `GitHubLicense` | The subset of the GitHub REST shape we consume |
+
+### Assistant
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `chat.types` | `ChatSession`, `ChatMessage`, `ClaudeModel`, `SendMessageRequest` | Session-based chat with model selection |
+| `type-guards` | `isChatMessage`, `isChatSession`, `isModel`, `isClaudeModel` | Runtime validation at the API boundary |
+
+### Storage
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `firestore.types` | `FirestoreDocument`, `FirestoreCollection` | Base document shape every stored type extends |
 
 ## Development
 
@@ -151,62 +225,52 @@ Available type guards:
 
 ### Publishing Process
 
-When you make changes to primitives:
+Releases are published to the public npm registry by **GitHub Actions using npm
+trusted publishing (OIDC)** — there is no npm token to fetch or set, and
+`npm publish` is never run by hand.
 
-1. **Bump the version** (automatically updates package.json and creates git tag):
+1. **Make and test your changes** in `src/`, then check the consumers compile:
    ```bash
-   cd primitives
-   npm version patch  # for bug fixes (0.2.5 -> 0.2.6)
-   npm version minor  # for new features (0.2.5 -> 0.3.0)
-   npm version major  # for breaking changes (0.2.5 -> 1.0.0)
+   npm test && npm run build
+   # temporary overlay for a quick type-check; the real install replaces it later
+   cp -r dist/* ../api/node_modules/@guinetik/primitives-ts/dist/ && (cd ../api && npx tsc --noEmit)
    ```
 
-2. **Build the package**:
-   ```bash
-   npm run build
+2. **Cut the release** from the monorepo root (bumps `package.json`, commits,
+   tags `primitives-v<version>`, pushes branch + tag):
+   ```powershell
+   .\scripts\release-primitives.ps1             # patch: 0.8.1 -> 0.8.2
+   .\scripts\release-primitives.ps1 -Bump minor # 0.8.1 -> 0.9.0
    ```
 
-3. **Publish to npm** (requires `NPM_KEY` environment variable):
+3. **Wait for the workflow** (`.github/workflows/publish-primitives.yml`,
+   about a minute) and confirm the registry has it:
    ```bash
-   # The NPM_KEY is stored in Bitwarden and should be set as environment variable
-   # Set it with: $env:NPM_KEY = "your-npm-access-token"
-   npm publish --access public
+   npm view @guinetik/primitives-ts version
    ```
 
-4. **Update dependent projects** (api, admin):
+4. **Pin the new version in dependent projects** (exact, no `^`/`~`):
    ```bash
-   # In api/package.json or admin/package.json, update the version:
-   # "@guinetik/primitives-ts": "0.2.6"  (use exact version, no ^ or ~)
-   
-   # Then install in each project
-   cd ../api
-   npm install
-   
-   cd ../admin
-   npm install
+   cd ../api   && npm install --save-exact @guinetik/primitives-ts@<version>
+   cd ../admin && npm install --save-exact @guinetik/primitives-ts@<version>
+   cd ../db    && npm install --save-exact @guinetik/primitives-ts@<version>
    ```
 
+Full details, one-time trusted-publisher setup and troubleshooting:
+[`docs/development/primitives-publishing.md`](../docs/development/primitives-publishing.md).
+
 ### Why No Local Linking?
 
 - **Prevents version drift** - Ensures all projects use exact versions
 - **Avoids build issues** - npm link can cause TypeScript declaration file problems
-- **Deployment consistency** - Production uses npm packages, dev should match
-- **Simple workflow** - Publish is fast and ensures types are properly compiled
-
-### NPM Authentication
+- **Deployment consistency** - Docker build contexts are the app folders, so `../primitives` does not exist there
+- **Simple workflow** - A tag push publishes; consumers just `npm install`
 
-The `NPM_KEY` environment variable contains the npm access token for publishing:
-- Stored in: Bitwarden Secrets Manager
-- Secret name: `NPM_KEY`
-- Used by: Local development, CI/CD, and autonomous agents
+### Authentication
 
-```bash
-# Fetch from Bitwarden (if you have access)
-$env:NPM_KEY = (bws secret get NPM_KEY --output json | ConvertFrom-Json).value
-
-# Or set manually if you have the token
-$env:NPM_KEY = "npm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
-```
+None. Installing the package needs no credentials (it is public), and
+publishing is authenticated by the GitHub Actions workflow's OIDC identity,
+registered on npmjs.com as the package's trusted publisher.
 
 ## License
 

package/dist/access.types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Feature-based access control types shared between API and Admin.
+ */
+import type { User } from './auth.types';
+/** Application roles for admin panel users. */
+export type AdminRole = 'admin' | 'guest';
+/** Lifecycle status for admin directory records. */
+export type AdminUserStatus = 'invited' | 'active' | 'disabled';
+/** Avatar resolution strategy for admin users. */
+export type AvatarSource = 'gravatar' | 'google' | 'custom';
+/** Feature keys that gate admin panel pages and API areas. */
+export type FeatureKey = 'dashboard' | 'site' | 'runtime' | 'files' | 'launchpad' | 'users' | 'system' | 'chat' | 'agents';
+/** Canonical ordered list of grantable features. */
+export declare const FEATURE_CATALOG: readonly FeatureKey[];
+/** Human-readable labels for feature checklist UI. */
+export declare const FEATURE_LABELS: Record<FeatureKey, string>;
+/**
+ * Returns true when the value is a known feature key.
+ *
+ * @param value - Candidate feature key.
+ */
+export declare function isFeatureKey(value: unknown): value is FeatureKey;
+/**
+ * Normalizes and validates a feature grant list.
+ *
+ * @param features - Raw feature keys from input or Firestore.
+ * @returns Deduplicated feature keys in catalog order.
+ * @throws Error when an unknown or duplicate value is present.
+ */
+export declare function normalizeFeatureKeys(features: unknown): FeatureKey[];
+/** Authenticated admin panel user returned by `/auth/me` and login flows. */
+export interface AuthenticatedUser extends User {
+    role?: AdminRole;
+    features?: FeatureKey[];
+    status?: AdminUserStatus;
+    avatarSource?: AvatarSource;
+}
+/** Admin directory user exposed by `/users` management APIs. */
+export interface AdminUser {
+    id: string;
+    uid?: string;
+    email: string;
+    displayName?: string;
+    role: AdminRole;
+    features: FeatureKey[];
+    status: AdminUserStatus;
+    avatarSource: AvatarSource;
+    photoURL: string;
+    customPhotoURL?: string;
+    emailVerified: boolean;
+    invitedByUid?: string;
+    createdAt: string;
+    updatedAt: string;
+    lastSignInAt?: string;
+}
+/** Payload for inviting a new admin panel user. */
+export interface InviteAdminUserInput {
+    email: string;
+    displayName?: string;
+    role?: AdminRole;
+    features?: FeatureKey[];
+}
+/** Payload for updating an admin directory user. */
+export interface UpdateAdminUserInput {
+    displayName?: string;
+    status?: AdminUserStatus;
+    avatarSource?: AvatarSource;
+    customPhotoURL?: string;
+    role?: AdminRole;
+    features?: FeatureKey[];
+}
+/**
+ * Resolves the effective role for legacy documents without an explicit role.
+ *
+ * @param role - Stored role, if any.
+ */
+export declare function resolveAdminRole(role?: AdminRole): AdminRole;
+/**
+ * Returns whether the user has admin-level unrestricted access.
+ *
+ * @param user - Authenticated or directory user.
+ */
+export declare function isAdminUser(user: Pick<AuthenticatedUser, 'role'>): boolean;
+/**
+ * Checks whether a user may access a feature.
+ *
+ * @param user - Authenticated user with role and feature grants.
+ * @param feature - Required feature key.
+ */
+export declare function userHasFeature(user: Pick<AuthenticatedUser, 'role' | 'features'>, feature: FeatureKey): boolean;
+/**
+ * Checks whether a user may access at least one of the given features.
+ *
+ * @param user - Authenticated user with role and feature grants.
+ * @param features - Candidate feature keys.
+ */
+export declare function userHasAnyFeature(user: Pick<AuthenticatedUser, 'role' | 'features'>, features: readonly FeatureKey[]): boolean;
+//# sourceMappingURL=access.types.d.ts.map

package/dist/access.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.types.d.ts","sourceRoot":"","sources":["../src/access.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhE,kDAAkD;AAClD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,MAAM,GACN,SAAS,GACT,OAAO,GACP,WAAW,GACX,OAAO,GACP,QAAQ,GACR,MAAM,GACN,QAAQ,CAAC;AAEb,oDAAoD;AACpD,eAAO,MAAM,eAAe,EAAE,SAAS,UAAU,EAUvC,CAAC;AAEX,sDAAsD;AACtD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAUrD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,EAAE,CAiBpE;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAkB,SAAQ,IAAI;IAC7C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,OAAO,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,UAAU,CAAC,EAClD,OAAO,EAAE,UAAU,GAClB,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,UAAU,CAAC,EAClD,QAAQ,EAAE,SAAS,UAAU,EAAE,GAC9B,OAAO,CAGT"}

package/dist/access.types.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Feature-based access control types shared between API and Admin.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE_LABELS = exports.FEATURE_CATALOG = void 0;
+exports.isFeatureKey = isFeatureKey;
+exports.normalizeFeatureKeys = normalizeFeatureKeys;
+exports.resolveAdminRole = resolveAdminRole;
+exports.isAdminUser = isAdminUser;
+exports.userHasFeature = userHasFeature;
+exports.userHasAnyFeature = userHasAnyFeature;
+/** Canonical ordered list of grantable features. */
+exports.FEATURE_CATALOG = [
+    'dashboard',
+    'site',
+    'runtime',
+    'files',
+    'launchpad',
+    'users',
+    'system',
+    'chat',
+    'agents',
+];
+/** Human-readable labels for feature checklist UI. */
+exports.FEATURE_LABELS = {
+    dashboard: 'Dashboard',
+    site: 'Site',
+    runtime: 'Runtime',
+    files: 'File uploads',
+    launchpad: 'Launchpad',
+    users: 'Users',
+    system: 'System monitoring',
+    chat: 'Chat',
+    agents: 'Agents',
+};
+/**
+ * Returns true when the value is a known feature key.
+ *
+ * @param value - Candidate feature key.
+ */
+function isFeatureKey(value) {
+    return typeof value === 'string' && exports.FEATURE_CATALOG.includes(value);
+}
+/**
+ * Normalizes and validates a feature grant list.
+ *
+ * @param features - Raw feature keys from input or Firestore.
+ * @returns Deduplicated feature keys in catalog order.
+ * @throws Error when an unknown or duplicate value is present.
+ */
+function normalizeFeatureKeys(features) {
+    if (!Array.isArray(features)) {
+        throw new Error('Features must be an array');
+    }
+    const seen = new Set();
+    for (const value of features) {
+        if (!isFeatureKey(value)) {
+            throw new Error(`Unknown feature key: ${String(value)}`);
+        }
+        if (seen.has(value)) {
+            throw new Error(`Duplicate feature key: ${value}`);
+        }
+        seen.add(value);
+    }
+    return exports.FEATURE_CATALOG.filter((key) => seen.has(key));
+}
+/**
+ * Resolves the effective role for legacy documents without an explicit role.
+ *
+ * @param role - Stored role, if any.
+ */
+function resolveAdminRole(role) {
+    return role ?? 'admin';
+}
+/**
+ * Returns whether the user has admin-level unrestricted access.
+ *
+ * @param user - Authenticated or directory user.
+ */
+function isAdminUser(user) {
+    return resolveAdminRole(user.role) === 'admin';
+}
+/**
+ * Checks whether a user may access a feature.
+ *
+ * @param user - Authenticated user with role and feature grants.
+ * @param feature - Required feature key.
+ */
+function userHasFeature(user, feature) {
+    if (isAdminUser(user))
+        return true;
+    return user.features?.includes(feature) ?? false;
+}
+/**
+ * Checks whether a user may access at least one of the given features.
+ *
+ * @param user - Authenticated user with role and feature grants.
+ * @param features - Candidate feature keys.
+ */
+function userHasAnyFeature(user, features) {
+    if (isAdminUser(user))
+        return true;
+    return features.some((feature) => user.features?.includes(feature));
+}

package/dist/access.types.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=access.types.spec.d.ts.map

package/dist/access.types.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.types.spec.d.ts","sourceRoot":"","sources":["../src/access.types.spec.ts"],"names":[],"mappings":""}

package/dist/access.types.spec.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const access_types_1 = require("./access.types");
+describe('access.types', () => {
+    it('recognizes valid feature keys', () => {
+        expect((0, access_types_1.isFeatureKey)('dashboard')).toBe(true);
+        expect((0, access_types_1.isFeatureKey)('unknown')).toBe(false);
+    });
+    it('normalizes feature keys in catalog order', () => {
+        expect((0, access_types_1.normalizeFeatureKeys)(['chat', 'site'])).toEqual(['site', 'chat']);
+    });
+    it('rejects duplicate feature keys', () => {
+        expect(() => (0, access_types_1.normalizeFeatureKeys)(['chat', 'site', 'chat'])).toThrow(/Duplicate feature key/);
+    });
+    it('rejects unknown feature keys', () => {
+        expect(() => (0, access_types_1.normalizeFeatureKeys)(['dashboard', 'billing'])).toThrow(/Unknown feature key/);
+    });
+    it('defaults missing roles to admin for legacy users', () => {
+        expect((0, access_types_1.resolveAdminRole)(undefined)).toBe('admin');
+        expect((0, access_types_1.resolveAdminRole)('guest')).toBe('guest');
+    });
+    it('grants admins every feature without explicit grants', () => {
+        const admin = { role: 'admin', features: [] };
+        expect((0, access_types_1.userHasFeature)(admin, 'system')).toBe(true);
+        expect((0, access_types_1.userHasAnyFeature)(admin, ['dashboard', 'launchpad'])).toBe(true);
+    });
+    it('requires explicit grants for guests', () => {
+        const guest = { role: 'guest', features: ['dashboard'] };
+        expect((0, access_types_1.userHasFeature)(guest, 'dashboard')).toBe(true);
+        expect((0, access_types_1.userHasFeature)(guest, 'system')).toBe(false);
+        expect((0, access_types_1.userHasAnyFeature)(guest, ['dashboard', 'launchpad'])).toBe(true);
+        expect((0, access_types_1.userHasAnyFeature)(guest, ['system', 'chat'])).toBe(false);
+    });
+    it('exposes a stable feature catalog', () => {
+        expect(access_types_1.FEATURE_CATALOG).toContain('users');
+        expect(access_types_1.FEATURE_CATALOG.length).toBe(9);
+    });
+});

package/dist/chat.types.d.ts

@@ -20,14 +20,14 @@ export interface Model {
  * @deprecated Use Model type instead
  */
 export declare enum ClaudeModel {
-    /** Claude Haiku 3.5 - Fastest, most cost-effective */
-    HAIKU_3_5 = "claude-3-5-haiku-20241022",
-    /** Claude Sonnet 3.5 - Balanced performance and quality */
-    SONNET_3_5 = "claude-3-5-sonnet-20241022",
-    /** Claude Sonnet 3.7 - Extended thinking capability */
-    SONNET_3_7 = "claude-3-5-sonnet-20250219",
-    /** Claude Opus 3 - Most powerful model for complex reasoning */
-    OPUS_3 = "claude-3-opus-20240229"
+    /** Claude Haiku 4.5 - Fastest, most cost-effective */
+    HAIKU_4_5 = "claude-haiku-4-5",
+    /** Claude Sonnet 5 - Balanced performance and quality */
+    SONNET_5 = "claude-sonnet-5",
+    /** Claude Opus 5 - Powerful reasoning, adaptive thinking on by default */
+    OPUS_5 = "claude-opus-5",
+    /** Claude Fable 5 - Most capable model, premium pricing */
+    FABLE_5 = "claude-fable-5"
 }
 /**
  * Model metadata for display in UI
@@ -55,7 +55,7 @@ export interface ChatSession {
     id: string;
     /** User ID who created the session */
     userId: string;
-    /** Current model ID for the session (e.g., "claude-sonnet-4-5-20250929") */
+    /** Current model ID for the session (e.g., "claude-opus-5") */
     model: string;
     /** Session creation timestamp */
     createdAt: Date;
@@ -89,7 +89,7 @@ export interface SendMessageRequest {
     sessionId?: string;
     /** User message content */
     message: string;
-    /** Model ID to use for response (e.g., "claude-sonnet-4-5-20250929") */
+    /** Model ID to use for response (e.g., "claude-opus-5") */
     model: string;
 }
 /**
@@ -127,7 +127,7 @@ export interface GetSessionMessagesResponse {
  * Create new session request
  */
 export interface CreateSessionRequest {
-    /** Initial model ID for the session (e.g., "claude-sonnet-4-5-20250929") */
+    /** Initial model ID for the session (e.g., "claude-opus-5") */
     model: string;
     /** Optional session title */
     title?: string;

package/dist/chat.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../src/chat.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../src/chat.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;CACpD;AAED;;;GAGG;AACH,oBAAY,WAAW;IACrB,sDAAsD;IACtD,SAAS,qBAAqB;IAE9B,yDAAyD;IACzD,QAAQ,oBAAoB;IAE5B,0EAA0E;IAC1E,MAAM,kBAAkB;IAExB,2DAA2D;IAC3D,OAAO,mBAAmB;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,EAAE,EAAE,WAAW,CAAC;IAEhB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IAEd,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAEhB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;IAEhB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,IAAI,EAAE,QAAQ,CAAC;IAEf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE,CAAC;CACrC"}

package/dist/chat.types.js

@@ -11,12 +11,12 @@ exports.ClaudeModel = void 0;
  */
 var ClaudeModel;
 (function (ClaudeModel) {
-    /** Claude Haiku 3.5 - Fastest, most cost-effective */
-    ClaudeModel["HAIKU_3_5"] = "claude-3-5-haiku-20241022";
-    /** Claude Sonnet 3.5 - Balanced performance and quality */
-    ClaudeModel["SONNET_3_5"] = "claude-3-5-sonnet-20241022";
-    /** Claude Sonnet 3.7 - Extended thinking capability */
-    ClaudeModel["SONNET_3_7"] = "claude-3-5-sonnet-20250219";
-    /** Claude Opus 3 - Most powerful model for complex reasoning */
-    ClaudeModel["OPUS_3"] = "claude-3-opus-20240229";
+    /** Claude Haiku 4.5 - Fastest, most cost-effective */
+    ClaudeModel["HAIKU_4_5"] = "claude-haiku-4-5";
+    /** Claude Sonnet 5 - Balanced performance and quality */
+    ClaudeModel["SONNET_5"] = "claude-sonnet-5";
+    /** Claude Opus 5 - Powerful reasoning, adaptive thinking on by default */
+    ClaudeModel["OPUS_5"] = "claude-opus-5";
+    /** Claude Fable 5 - Most capable model, premium pricing */
+    ClaudeModel["FABLE_5"] = "claude-fable-5";
 })(ClaudeModel || (exports.ClaudeModel = ClaudeModel = {}));

package/dist/chat.types.spec.js

@@ -17,35 +17,35 @@ describe('Chat Types', () => {
             const modelCount = Object.keys(chat_types_1.ClaudeModel).length;
             expect(modelCount).toBe(4);
         });
-        it('should have HAIKU_3_5 with correct ID', () => {
-            expect(chat_types_1.ClaudeModel.HAIKU_3_5).toBe('claude-3-5-haiku-20241022');
+        it('should have HAIKU_4_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.HAIKU_4_5).toBe('claude-haiku-4-5');
         });
-        it('should have SONNET_3_5 with correct ID', () => {
-            expect(chat_types_1.ClaudeModel.SONNET_3_5).toBe('claude-3-5-sonnet-20241022');
+        it('should have SONNET_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.SONNET_5).toBe('claude-sonnet-5');
         });
-        it('should have SONNET_3_7 with correct ID', () => {
-            expect(chat_types_1.ClaudeModel.SONNET_3_7).toBe('claude-3-5-sonnet-20250219');
+        it('should have OPUS_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.OPUS_5).toBe('claude-opus-5');
         });
-        it('should have OPUS_3 with correct ID', () => {
-            expect(chat_types_1.ClaudeModel.OPUS_3).toBe('claude-3-opus-20240229');
+        it('should have FABLE_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.FABLE_5).toBe('claude-fable-5');
         });
         it('should not have duplicate model IDs', () => {
             const modelIds = Object.values(chat_types_1.ClaudeModel);
             const uniqueIds = new Set(modelIds);
             expect(modelIds.length).toBe(uniqueIds.size);
         });
-        it('should have model IDs with valid date format', () => {
+        it('should not carry legacy date suffixes', () => {
             const allModels = Object.values(chat_types_1.ClaudeModel);
-            const datePattern = /\d{8}$/; // YYYYMMDD at the end
+            const datePattern = /-\d{8}$/; // legacy YYYYMMDD snapshot suffix
             allModels.forEach((modelId) => {
-                expect(modelId).toMatch(datePattern);
+                expect(modelId).not.toMatch(datePattern);
             });
         });
         it('should be accessible by enum key', () => {
-            expect(chat_types_1.ClaudeModel['HAIKU_3_5']).toBeDefined();
-            expect(chat_types_1.ClaudeModel['SONNET_3_5']).toBeDefined();
-            expect(chat_types_1.ClaudeModel['SONNET_3_7']).toBeDefined();
-            expect(chat_types_1.ClaudeModel['OPUS_3']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['HAIKU_4_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['SONNET_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['OPUS_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['FABLE_5']).toBeDefined();
         });
         it('should support iteration over enum values', () => {
             const models = [];
@@ -53,10 +53,10 @@ describe('Chat Types', () => {
                 models.push(model);
             }
             expect(models).toHaveLength(4);
-            expect(models).toContain('claude-3-5-haiku-20241022');
-            expect(models).toContain('claude-3-5-sonnet-20241022');
-            expect(models).toContain('claude-3-5-sonnet-20250219');
-            expect(models).toContain('claude-3-opus-20240229');
+            expect(models).toContain('claude-haiku-4-5');
+            expect(models).toContain('claude-sonnet-5');
+            expect(models).toContain('claude-opus-5');
+            expect(models).toContain('claude-fable-5');
         });
     });
     describe('Model Tier Values', () => {

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  * @license MIT
  */
 export * from './auth.types';
+export * from './access.types';
 export * from './system.types';
 export * from './website.types';
 export * from './firestore.types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC;AAG7B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,mBAAmB,CAAC;AAGlC,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC;AAG7B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,mBAAmB,CAAC;AAGlC,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -26,6 +26,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SecurityLevel = void 0;
 // Auth types
 __exportStar(require("./auth.types"), exports);
+// Access control types
+__exportStar(require("./access.types"), exports);
 // System monitoring types
 __exportStar(require("./system.types"), exports);
 // Website/Site content types

package/dist/type-guards.spec.js

@@ -35,7 +35,7 @@ describe('Type Guards', () => {
         it('should return true for ChatMessage with optional model', () => {
             const messageWithModel = {
                 ...validMessage,
-                model: 'claude-sonnet-4-5-20250929',
+                model: 'claude-opus-5',
             };
             expect((0, type_guards_1.isChatMessage)(messageWithModel)).toBe(true);
         });
@@ -68,7 +68,7 @@ describe('Type Guards', () => {
         const validSession = {
             id: 'session_123',
             userId: 'user_456',
-            model: 'claude-sonnet-4-5-20250929',
+            model: 'claude-opus-5',
             createdAt: new Date(),
             updatedAt: new Date(),
         };
@@ -105,7 +105,7 @@ describe('Type Guards', () => {
     describe('isModel', () => {
         const validModel = {
             type: 'model',
-            id: 'claude-sonnet-4-5-20250929',
+            id: 'claude-opus-5',
             display_name: 'Claude Sonnet 4.5',
             created_at: '2025-09-29T00:00:00Z',
         };
@@ -139,19 +139,19 @@ describe('Type Guards', () => {
     });
     describe('isClaudeModel', () => {
         it('should return true for valid ClaudeModel enum values', () => {
-            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.HAIKU_3_5)).toBe(true);
-            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.SONNET_3_5)).toBe(true);
-            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.SONNET_3_7)).toBe(true);
-            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.OPUS_3)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.HAIKU_4_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.SONNET_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.OPUS_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.FABLE_5)).toBe(true);
         });
         it('should return true for valid model ID strings', () => {
-            expect((0, type_guards_1.isClaudeModel)('claude-3-5-haiku-20241022')).toBe(true);
-            expect((0, type_guards_1.isClaudeModel)('claude-3-5-sonnet-20241022')).toBe(true);
-            expect((0, type_guards_1.isClaudeModel)('claude-3-5-sonnet-20250219')).toBe(true);
-            expect((0, type_guards_1.isClaudeModel)('claude-3-opus-20240229')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-haiku-4-5')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-sonnet-5')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-opus-5')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-fable-5')).toBe(true);
         });
         it('should return false for invalid model IDs', () => {
-            expect((0, type_guards_1.isClaudeModel)('claude-4-sonnet')).toBe(false);
+            expect((0, type_guards_1.isClaudeModel)('claude-3-opus-20240229')).toBe(false);
             expect((0, type_guards_1.isClaudeModel)('gpt-4')).toBe(false);
             expect((0, type_guards_1.isClaudeModel)('invalid-model')).toBe(false);
             expect((0, type_guards_1.isClaudeModel)('')).toBe(false);
@@ -166,7 +166,7 @@ describe('Type Guards', () => {
     describe('isSendMessageRequest', () => {
         const validRequest = {
             message: 'Hello, Claude!',
-            model: 'claude-sonnet-4-5-20250929',
+            model: 'claude-opus-5',
         };
         it('should return true for valid SendMessageRequest', () => {
             expect((0, type_guards_1.isSendMessageRequest)(validRequest)).toBe(true);
@@ -194,7 +194,7 @@ describe('Type Guards', () => {
     });
     describe('isCreateSessionRequest', () => {
         const validRequest = {
-            model: 'claude-sonnet-4-5-20250929',
+            model: 'claude-opus-5',
         };
         it('should return true for valid CreateSessionRequest', () => {
             expect((0, type_guards_1.isCreateSessionRequest)(validRequest)).toBe(true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guinetik/primitives-ts",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Shared TypeScript primitives for Guinetik projects",
   "author": "Guinetik",
   "license": "MIT",