@guinetik/primitives-ts 0.1.0 → 0.1.1

package/dist/firestore.types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Firestore Base Types
+ * Generic types for Firestore documents that can be used across all modules
+ */
+/**
+ * Base document with Firestore metadata fields
+ * Extend this interface for all Firestore document types
+ */
+export interface FirestoreDocument {
+    /** Document creation timestamp */
+    createdAt?: any;
+    /** Document last update timestamp */
+    updatedAt?: any;
+}
+/**
+ * Firestore collection reference helper
+ */
+export type FirestoreCollection<T> = {
+    [key: string]: T;
+};
+//# sourceMappingURL=firestore.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.types.d.ts","sourceRoot":"","sources":["../src/firestore.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,SAAS,CAAC,EAAE,GAAG,CAAC;IAEhB,qCAAqC;IACrC,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;CAClB,CAAC"}

package/dist/firestore.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Firestore Base Types
+ * Generic types for Firestore documents that can be used across all modules
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -10,4 +10,6 @@
 export * from './auth.types';
 export * from './system.types';
 export * from './website.types';
+export * from './firestore.types';
+export * from './website-firestore.types';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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"}

package/dist/index.js

@@ -29,3 +29,7 @@ __exportStar(require("./auth.types"), exports);
 __exportStar(require("./system.types"), exports);
 // Website/Site content types
 __exportStar(require("./website.types"), exports);
+// Firestore base types (backend only)
+__exportStar(require("./firestore.types"), exports);
+// Website Firestore document types (backend only)
+__exportStar(require("./website-firestore.types"), exports);

package/dist/website-firestore.types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Website Firestore Document Types
+ * Backend-only types that extend website types with Firestore metadata
+ *
+ * These types are used ONLY by backend/database code.
+ * Frontend should use the base types from website.types.ts
+ */
+import { FirestoreDocument } from './firestore.types';
+import { MenuItem, Theme, Card, Experiment, AboutSection } from './website.types';
+/**
+ * Firestore document for website config collection
+ * Collection: website-config
+ * Document ID: main
+ */
+export interface WebsiteConfigDocument extends FirestoreDocument {
+    /** Site title */
+    title: string;
+    /** Site description */
+    description: string;
+    /** Default theme ID */
+    theme: string;
+    /** Stats theme mappings */
+    statsTheme: Record<string, string>;
+    /** Contributions theme mappings */
+    contribsTheme: Record<string, string>;
+    /** Stats background mappings */
+    statsBg: Record<string, string>;
+    /** About section content */
+    about: AboutSection;
+}
+/**
+ * Firestore document for website menu collection
+ * Collection: website-menu
+ * Document IDs: 'main' | 'mobile'
+ */
+export interface MenuDocument extends FirestoreDocument {
+    /** Menu items */
+    items: MenuItem[];
+    /** Display order */
+    order: number;
+}
+/**
+ * Firestore document for website themes collection
+ * Collection: website-themes
+ * Document ID: theme ID (e.g., 'guinetik', 'synthwave')
+ */
+export interface ThemeDocument extends FirestoreDocument, Theme {
+    /** Display order */
+    order: number;
+    /** Is theme enabled? */
+    enabled: boolean;
+    /** Optional theme description */
+    description?: string;
+    /** Optional color palette */
+    colors?: {
+        primary?: string;
+        secondary?: string;
+        accent?: string;
+    };
+}
+/**
+ * Firestore document for website projects collection
+ * Collection: website-projects
+ * Document ID: auto-generated
+ */
+export interface ProjectDocument extends FirestoreDocument, Card {
+    /** Display order */
+    order: number;
+    /** Is project featured? */
+    featured: boolean;
+    /** Is project visible? */
+    visible: boolean;
+    /** Optional project year/timeframe */
+    year?: string;
+    /** Optional project category */
+    category?: string;
+}
+/**
+ * Firestore document for website demos collection
+ * Collection: website-demos
+ * Document ID: auto-generated
+ */
+export interface DemoDocument extends FirestoreDocument, Card {
+    /** Display order */
+    order: number;
+    /** Is demo visible? */
+    visible: boolean;
+    /** Optional source code URL */
+    sourceCode?: string;
+    /** Optional demo category */
+    category?: string;
+}
+/**
+ * Firestore document for website experiments collection
+ * Collection: website-experiments
+ * Document ID: auto-generated
+ */
+export interface ExperimentDocument extends FirestoreDocument, Experiment {
+    /** Display order */
+    order: number;
+    /** Is experiment visible? */
+    visible: boolean;
+    /** Is experiment featured? */
+    featured?: boolean;
+    /** Optional thumbnail URL */
+    thumbnail?: string;
+    /** Optional description */
+    description?: string;
+    /** Optional technology tags */
+    tags?: string[];
+}
+/**
+ * Firestore collection names
+ */
+export declare const FIRESTORE_COLLECTIONS: {
+    readonly CONFIG: "website-config";
+    readonly MENU: "website-menu";
+    readonly THEMES: "website-themes";
+    readonly PROJECTS: "website-projects";
+    readonly DEMOS: "website-demos";
+    readonly EXPERIMENTS: "website-experiments";
+};
+/**
+ * Firestore document IDs for singleton documents
+ */
+export declare const FIRESTORE_DOCUMENT_IDS: {
+    readonly CONFIG_MAIN: "main";
+    readonly MENU_MAIN: "main";
+    readonly MENU_MOBILE: "mobile";
+};
+//# sourceMappingURL=website-firestore.types.d.ts.map

package/dist/website-firestore.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-firestore.types.d.ts","sourceRoot":"","sources":["../src/website-firestore.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMlF;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,4BAA4B;IAC5B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,iBAAiB;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAElB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB,EAAE,KAAK;IAC7D,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,iBAAiB,EAAE,IAAI;IAC9D,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAElB,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IAEjB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB,EAAE,IAAI;IAC3D,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB,EAAE,UAAU;IACvE,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;CAOxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC"}

package/dist/website-firestore.types.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Website Firestore Document Types
+ * Backend-only types that extend website types with Firestore metadata
+ *
+ * These types are used ONLY by backend/database code.
+ * Frontend should use the base types from website.types.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIRESTORE_DOCUMENT_IDS = exports.FIRESTORE_COLLECTIONS = void 0;
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Firestore collection names
+ */
+exports.FIRESTORE_COLLECTIONS = {
+    CONFIG: 'website-config',
+    MENU: 'website-menu',
+    THEMES: 'website-themes',
+    PROJECTS: 'website-projects',
+    DEMOS: 'website-demos',
+    EXPERIMENTS: 'website-experiments',
+};
+/**
+ * Firestore document IDs for singleton documents
+ */
+exports.FIRESTORE_DOCUMENT_IDS = {
+    CONFIG_MAIN: 'main',
+    MENU_MAIN: 'main',
+    MENU_MOBILE: 'mobile',
+};

package/package.json

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