@eide/foir-cli 0.1.15 → 0.1.17

package/dist/commands/pull.js

@@ -17,6 +17,18 @@ import { generateSwiftModelKeys } from '../codegen/generators/swift-model-keys.j
 import { generateCustomerProfileTypes } from '../codegen/generators/customer-profile-types.js';
 import { generateSwiftCustomerProfileFile } from '../codegen/generators/swift-customer-profile.js';
 import { generateCustomerProfileDocuments } from '../codegen/generators/customer-profile-documents.js';
+import { generateStaticDocuments } from '../codegen/generators/static-documents.js';
+import { generateTypedOperationsCommon } from '../codegen/generators/typed-operations-common.js';
+import { generateTypedOperations, computeTypesRelPath } from '../codegen/generators/typed-operations.js';
+import { generateTypedOperationsIndex } from '../codegen/generators/typed-operations-index.js';
+import { generateCustomerProfileOperations } from '../codegen/generators/customer-profile-operations.js';
+import { generateReactHooks } from '../codegen/generators/react-hooks.js';
+import { generateReactHooksIndex } from '../codegen/generators/react-hooks-index.js';
+import { generateCustomerProfileHooks } from '../codegen/generators/customer-profile-hooks.js';
+import { generateRemixLoaders } from '../codegen/generators/remix-loaders.js';
+import { generateRemixLoadersIndex } from '../codegen/generators/remix-loaders-index.js';
+import { generateCustomerProfileLoaders } from '../codegen/generators/customer-profile-loaders.js';
+import { fetchPublicSchema } from '../codegen/generators/public-schema-content.js';
 import { writeFiles } from '../codegen/write-files.js';
 export function registerPullCommand(program, globalOpts) {
     program
@@ -39,12 +51,13 @@ export function registerPullCommand(program, globalOpts) {
             swift: cmdOpts.swift,
         };
         const config = await loadPullConfig(flags);
-        // Fetch models + customer profile schema
+        // Fetch models + customer profile schema + public schema
         const client = await createClient(opts);
         console.log(chalk.dim('Fetching models…'));
-        const [allModels, cpSchema] = await Promise.all([
+        const [allModels, cpSchema, publicSchema] = await Promise.all([
             fetchModelsForCodegen(client),
             fetchCustomerProfileSchema(client),
+            fetchPublicSchema(client),
         ]);
         if (allModels.length === 0 && !cpSchema) {
             console.log(chalk.yellow('No models found. Nothing to generate.'));
@@ -59,7 +72,17 @@ export function registerPullCommand(program, globalOpts) {
         const cwd = process.cwd();
         const typesDir = resolve(cwd, config.output.types);
         const docsDir = resolve(cwd, config.output.documents);
+        const opsDir = resolve(cwd, config.output.operations);
+        const hooksDir = config.output.hooks
+            ? resolve(cwd, config.output.hooks)
+            : null;
+        const loadersDir = config.output.loaders
+            ? resolve(cwd, config.output.loaders)
+            : null;
         const files = [];
+        const hasCustomerProfile = !!(cpSchema && cpSchema.fields.length > 0);
+        const publicModels = models.filter((m) => m.config.publicApi && m.config.records);
+        // ─── Types ───────────────────────────────────────────────
         // 1. Static files
         files.push({
             path: resolve(typesDir, 'field-types.ts'),
@@ -81,22 +104,27 @@ export function registerPullCommand(program, globalOpts) {
             path: resolve(typesDir, 'models', 'index.ts'),
             content: generateModelIndex(models),
         });
-        // 4. Customer profile types (when schema exists)
-        if (cpSchema && cpSchema.fields.length > 0) {
+        // 4. Customer profile types
+        if (hasCustomerProfile) {
             files.push({
                 path: resolve(typesDir, 'customer-profile.ts'),
                 content: generateCustomerProfileTypes(cpSchema),
             });
         }
-        // 5. Per-model GraphQL documents (only for publicApi models with records)
-        const publicModels = models.filter((m) => m.config.publicApi && m.config.records);
+        // 5. Main index
+        files.push({
+            path: resolve(typesDir, 'index.ts'),
+            content: generateMainIndex(hasCustomerProfile),
+        });
+        // ─── Documents (.graphql) ────────────────────────────────
+        // 6. Per-model GraphQL documents
         for (const model of publicModels) {
             files.push({
                 path: resolve(docsDir, `${model.key}.graphql`),
                 content: generateModelDocuments(model),
             });
         }
-        // 5a. Shared fragments (emitted once when any model uses sharing)
+        // 6a. Shared fragments
         const hasSharingModels = publicModels.some((m) => m.config.sharing?.enabled);
         if (hasSharingModels) {
             files.push({
@@ -104,31 +132,101 @@ export function registerPullCommand(program, globalOpts) {
                 content: generateSharedFragments(),
             });
         }
-        // 5b. Customer profile GraphQL documents (always — static platform operations)
+        // 6b. Customer profile GraphQL documents
         files.push({
             path: resolve(docsDir, 'customer-profile.graphql'),
             content: generateCustomerProfileDocuments(),
         });
-        // 6. Main index
-        const hasCustomerProfile = !!(cpSchema && cpSchema.fields.length > 0);
+        // 6c. Static domain documents
+        const staticDocs = generateStaticDocuments(config.domains);
+        for (const doc of staticDocs) {
+            files.push({
+                path: resolve(docsDir, doc.filename),
+                content: doc.content,
+            });
+        }
+        // 6d. Public schema (for consumer codegen)
+        if (publicSchema) {
+            files.push({
+                path: resolve(docsDir, 'public-schema.graphql'),
+                content: publicSchema,
+            });
+        }
+        // ─── Typed Operations ────────────────────────────────────
+        // 7. Operations common types
+        const typesRelPath = computeTypesRelPath(opsDir, typesDir);
         files.push({
-            path: resolve(typesDir, 'index.ts'),
-            content: generateMainIndex(hasCustomerProfile),
+            path: resolve(opsDir, '_common.ts'),
+            content: generateTypedOperationsCommon(),
+        });
+        // 7a. Per-model typed operations
+        for (const model of publicModels) {
+            files.push({
+                path: resolve(opsDir, `${model.key}.ts`),
+                content: generateTypedOperations(model, typesRelPath),
+            });
+        }
+        // 7b. Customer profile operations
+        if (hasCustomerProfile) {
+            files.push({
+                path: resolve(opsDir, 'customer-profile.ts'),
+                content: generateCustomerProfileOperations(typesRelPath),
+            });
+        }
+        // 7c. Operations index
+        files.push({
+            path: resolve(opsDir, 'index.ts'),
+            content: generateTypedOperationsIndex(publicModels, hasCustomerProfile),
         });
-        // 7. Swift output (when configured)
+        // ─── React Hooks (when target includes 'react') ─────────
+        if (hooksDir) {
+            for (const model of publicModels) {
+                files.push({
+                    path: resolve(hooksDir, `${model.key}.ts`),
+                    content: generateReactHooks(model),
+                });
+            }
+            if (hasCustomerProfile) {
+                files.push({
+                    path: resolve(hooksDir, 'customer-profile.ts'),
+                    content: generateCustomerProfileHooks(),
+                });
+            }
+            files.push({
+                path: resolve(hooksDir, 'index.ts'),
+                content: generateReactHooksIndex(publicModels, hasCustomerProfile),
+            });
+        }
+        // ─── Remix Loaders (when target includes 'remix') ───────
+        if (loadersDir) {
+            for (const model of publicModels) {
+                files.push({
+                    path: resolve(loadersDir, `${model.key}.ts`),
+                    content: generateRemixLoaders(model),
+                });
+            }
+            if (hasCustomerProfile) {
+                files.push({
+                    path: resolve(loadersDir, 'customer-profile.ts'),
+                    content: generateCustomerProfileLoaders(),
+                });
+            }
+            files.push({
+                path: resolve(loadersDir, 'index.ts'),
+                content: generateRemixLoadersIndex(publicModels, hasCustomerProfile),
+            });
+        }
+        // ─── Swift (when configured) ────────────────────────────
         if (config.output.swift) {
             const swiftDir = resolve(cwd, config.output.swift);
-            // Shared types
             files.push({
                 path: resolve(swiftDir, 'FieldTypes.swift'),
                 content: generateSwiftFieldTypesFile(),
             });
-            // Model keys
             files.push({
                 path: resolve(swiftDir, 'ModelKeys.swift'),
                 content: generateSwiftModelKeys(models),
             });
-            // Per-model Swift files
             for (const model of models) {
                 const swiftTypeName = toPascalCase(model.key);
                 files.push({
@@ -136,7 +234,6 @@ export function registerPullCommand(program, globalOpts) {
                     content: generateSwiftModelFile(model),
                 });
             }
-            // Customer profile Swift file
             if (hasCustomerProfile) {
                 files.push({
                     path: resolve(swiftDir, 'CustomerProfile.swift'),
@@ -144,7 +241,8 @@ export function registerPullCommand(program, globalOpts) {
                 });
             }
         }
-        // Dry run: list files
+        // ─── Output ─────────────────────────────────────────────
+        // Dry run
         if (config.dryRun) {
             console.log(chalk.bold('\nDry run — files that would be generated:\n'));
             for (const file of files) {
@@ -158,17 +256,29 @@ export function registerPullCommand(program, globalOpts) {
         await writeFiles(files, config.prettier);
         // Summary
         const modelCount = models.length;
-        const docCount = publicModels.length;
-        const swiftCount = config.output.swift ? models.length + 2 : 0; // +2 for FieldTypes + ModelKeys
+        const docCount = publicModels.length + staticDocs.length;
+        const opsCount = publicModels.length + (hasCustomerProfile ? 1 : 0) + 2; // +2 for _common + index
+        const hookCount = hooksDir
+            ? publicModels.length + (hasCustomerProfile ? 1 : 0) + 1
+            : 0;
+        const loaderCount = loadersDir
+            ? publicModels.length + (hasCustomerProfile ? 1 : 0) + 1
+            : 0;
+        const swiftCount = config.output.swift ? models.length + 2 : 0;
         const cpSuffix = hasCustomerProfile ? ', customer profile' : '';
         console.log(chalk.green(`\nGenerated ${files.length} file(s)`) +
-            chalk.dim(` (${modelCount} model type(s), ${docCount} document(s)${cpSuffix}${swiftCount > 0 ? `, ${swiftCount} Swift file(s)` : ''})`));
-        console.log(chalk.dim(`  Types:     ${typesDir}`));
-        if (docCount > 0) {
-            console.log(chalk.dim(`  Documents: ${docsDir}`));
+            chalk.dim(` (${modelCount} type(s), ${docCount} document(s), ${opsCount} operation(s)${cpSuffix}${hookCount > 0 ? `, ${hookCount} hook(s)` : ''}${loaderCount > 0 ? `, ${loaderCount} loader(s)` : ''}${swiftCount > 0 ? `, ${swiftCount} Swift file(s)` : ''})`));
+        console.log(chalk.dim(`  Types:      ${typesDir}`));
+        console.log(chalk.dim(`  Documents:  ${docsDir}`));
+        console.log(chalk.dim(`  Operations: ${opsDir}`));
+        if (hooksDir) {
+            console.log(chalk.dim(`  Hooks:      ${hooksDir}`));
+        }
+        if (loadersDir) {
+            console.log(chalk.dim(`  Loaders:    ${loadersDir}`));
         }
         if (config.output.swift) {
-            console.log(chalk.dim(`  Swift:     ${resolve(cwd, config.output.swift)}`));
+            console.log(chalk.dim(`  Swift:      ${resolve(cwd, config.output.swift)}`));
         }
     }));
 }

package/dist/config/pull-config.d.ts

@@ -1,6 +1,7 @@
 /**
  * Pull config loader — searches for foir.config.ts / .foirrc.ts and merges with CLI flags.
  */
+import type { CodegenTarget, DomainConfig } from './types.js';
 export interface PullCliFlags {
     config?: string;
     only?: string;
@@ -13,8 +14,13 @@ export interface ResolvedPullConfig {
     output: {
         types: string;
         documents: string;
+        operations: string;
+        hooks?: string;
+        loaders?: string;
         swift?: string;
     };
+    targets: CodegenTarget[];
+    domains: Required<DomainConfig>;
     only: string[];
     includeInline: boolean;
     prettier: boolean;

package/dist/config/pull-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull-config.d.ts","sourceRoot":"","sources":["../../src/config/pull-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}
+{"version":3,"file":"pull-config.d.ts","sourceRoot":"","sources":["../../src/config/pull-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAuDpB,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAqE7B"}

package/dist/config/pull-config.js

@@ -14,6 +14,18 @@ const CONFIG_FILE_NAMES = [
 ];
 const DEFAULT_TYPES_DIR = './src/generated/types';
 const DEFAULT_DOCS_DIR = './src/generated/documents';
+const ALL_DOMAINS = {
+    auth: true,
+    authProviders: true,
+    files: true,
+    sync: true,
+    notifications: true,
+    operations: true,
+    schedules: true,
+    sharing: true,
+    search: true,
+    analytics: true,
+};
 /**
  * Resolve a config file from the given directory (or cwd).
  */
@@ -55,16 +67,53 @@ export async function loadPullConfig(flags) {
     const types = flags.out ?? fileConfig.output?.types ?? DEFAULT_TYPES_DIR;
     const documents = fileConfig.output?.documents ?? DEFAULT_DOCS_DIR;
     const swift = flags.swift ?? fileConfig.output?.swift;
+    // Targets
+    const targets = fileConfig.targets ?? [];
+    // Operations dir defaults to sibling of types dir
+    const typesParent = types.replace(/\/[^/]+$/, '');
+    const operations = fileConfig.output?.operations ?? `${typesParent}/operations`;
+    // Hooks and loaders only resolve when matching target is present
+    const hooks = targets.includes('react')
+        ? (fileConfig.output?.hooks ?? `${typesParent}/hooks`)
+        : undefined;
+    const loaders = targets.includes('remix')
+        ? (fileConfig.output?.loaders ?? `${typesParent}/loaders`)
+        : undefined;
     const output = {
         types,
         documents,
+        operations,
+        ...(hooks ? { hooks } : {}),
+        ...(loaders ? { loaders } : {}),
         ...(swift ? { swift } : {}),
     };
+    // Domains: true = all, false = none, object = selective
+    let domains;
+    if (fileConfig.domains === false) {
+        domains = {
+            auth: false,
+            authProviders: false,
+            files: false,
+            sync: false,
+            notifications: false,
+            operations: false,
+            schedules: false,
+            sharing: false,
+            search: false,
+            analytics: false,
+        };
+    }
+    else if (typeof fileConfig.domains === 'object') {
+        domains = { ...ALL_DOMAINS, ...fileConfig.domains };
+    }
+    else {
+        domains = { ...ALL_DOMAINS };
+    }
     const only = flags.only
         ? flags.only.split(',').map((s) => s.trim())
         : (fileConfig.only ?? []);
     const includeInline = fileConfig.includeInline ?? true;
     const prettier = flags.noPrettier ? false : (fileConfig.prettier ?? true);
     const dryRun = flags.dryRun ?? false;
-    return { output, only, includeInline, prettier, dryRun };
+    return { output, targets, domains, only, includeInline, prettier, dryRun };
 }

package/dist/config/types.d.ts

@@ -1,15 +1,38 @@
 /**
  * Configuration types for foir-cli
  */
+export type CodegenTarget = 'react' | 'remix';
+export interface DomainConfig {
+    auth?: boolean;
+    authProviders?: boolean;
+    files?: boolean;
+    sync?: boolean;
+    notifications?: boolean;
+    operations?: boolean;
+    schedules?: boolean;
+    sharing?: boolean;
+    search?: boolean;
+    analytics?: boolean;
+}
 export interface FoirPullConfig {
     output?: {
         /** Directory for generated TypeScript types (default: './src/generated/types') */
         types?: string;
         /** Directory for generated GraphQL documents (default: './src/generated/documents') */
         documents?: string;
+        /** Directory for generated typed operation modules (default: sibling of types) */
+        operations?: string;
+        /** Directory for generated React hooks (requires 'react' target) */
+        hooks?: string;
+        /** Directory for generated Remix loaders (requires 'remix' target) */
+        loaders?: string;
         /** Directory for generated Swift files (e.g., './generated/swift') */
         swift?: string;
     };
+    /** Code generation targets — 'react' for Apollo hooks, 'remix' for typed loaders */
+    targets?: CodegenTarget[];
+    /** Enable static domain document generation (default: all enabled) */
+    domains?: boolean | DomainConfig;
     /** Filter to specific model keys */
     only?: string[];
     /** Include inline-only models for type resolution (default: true) */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE;QACP,kFAAkF;QAClF,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,uFAAuF;QACvF,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,sEAAsE;QACtE,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE;QACP,kFAAkF;QAClF,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,uFAAuF;QACvF,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kFAAkF;QAClF,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,oEAAoE;QACpE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,sEAAsE;QACtE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sEAAsE;QACtE,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,oFAAoF;IACpF,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IACjC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eide/foir-cli",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Universal platform CLI for EIDE — scriptable, composable resource management",
   "type": "module",
   "publishConfig": {