@eide/foir-cli 0.1.16 → 0.1.18

package/dist/cli.js

@@ -36,6 +36,7 @@ import { registerFilesCommands } from './commands/files.js';
 import { registerNotesCommands } from './commands/notes.js';
 import { registerVariantCatalogCommands } from './commands/variant-catalog.js';
 import { registerPullCommand } from './commands/pull.js';
+import { registerCreateExtensionCommand } from './commands/create-extension.js';
 const program = new Command();
 program
     .name('foir')
@@ -81,4 +82,6 @@ registerNotesCommands(program, getGlobalOpts);
 registerVariantCatalogCommands(program, getGlobalOpts);
 // Codegen
 registerPullCommand(program, getGlobalOpts);
+// Scaffolding
+registerCreateExtensionCommand(program, getGlobalOpts);
 program.parse();

package/dist/codegen/field-mapping.d.ts

@@ -23,6 +23,7 @@ export declare function getRequiredImports(fields: FieldSchemaForGen[]): Set<str
 export declare function getInlineSchemaReferences(fields: FieldSchemaForGen[]): Set<string>;
 export declare function toCamelCase(str: string): string;
 export declare function toPascalCase(str: string): string;
+export declare function toUpperSnakeCase(str: string): string;
 export declare function sanitizeFieldName(key: string): string;
 export declare function generateFieldDef(field: FieldSchemaForGen): string;
 //# sourceMappingURL=field-mapping.d.ts.map

package/dist/codegen/field-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-mapping.d.ts","sourceRoot":"","sources":["../../src/codegen/field-mapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,qBAAqB,aAsBhC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA0D1D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAClC,MAAM,CAwCR;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAc3E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EAAE,GAC1B,GAAG,CAAC,MAAM,CAAC,CAiBb;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiFjE"}
+{"version":3,"file":"field-mapping.d.ts","sourceRoot":"","sources":["../../src/codegen/field-mapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,qBAAqB,aAsBhC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA0D1D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAClC,MAAM,CAwCR;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAc3E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EAAE,GAC1B,GAAG,CAAC,MAAM,CAAC,CAiBb;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiFjE"}

package/dist/codegen/field-mapping.js

@@ -164,6 +164,14 @@ export function toPascalCase(str) {
     const camel = toCamelCase(str);
     return camel.charAt(0).toUpperCase() + camel.slice(1);
 }
+export function toUpperSnakeCase(str) {
+    if (!str)
+        return 'UNKNOWN';
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .replace(/[-\s]+/g, '_')
+        .toUpperCase();
+}
 export function sanitizeFieldName(key) {
     if (!key)
         return 'unknown';

package/dist/codegen/generators/customer-profile-hooks.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generates React Apollo hooks for customer profiles.
+ */
+export declare function generateCustomerProfileHooks(): string;
+//# sourceMappingURL=customer-profile-hooks.d.ts.map

package/dist/codegen/generators/customer-profile-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-profile-hooks.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/customer-profile-hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,4BAA4B,IAAI,MAAM,CA0ErD"}

package/dist/codegen/generators/customer-profile-hooks.js

@@ -0,0 +1,78 @@
+/**
+ * Generates React Apollo hooks for customer profiles.
+ */
+export function generateCustomerProfileHooks() {
+    return `/**
+ * React Apollo hooks for Customer Profiles
+ *
+ * @generated by foir — DO NOT EDIT MANUALLY
+ */
+
+import { useQuery, useMutation } from '@apollo/client';
+import type { QueryHookOptions, MutationHookOptions } from '@apollo/client';
+import { gql } from '@apollo/client';
+import {
+  GET_MY_PROFILE,
+  GET_CUSTOMER_PROFILE,
+  SET_MY_PROFILE,
+  UPDATE_CUSTOMER_PROFILE,
+  DELETE_MY_PROFILE,
+} from '../operations/customer-profile.js';
+import type {
+  GetMyProfileResult,
+  GetCustomerProfileVariables,
+  GetCustomerProfileResult,
+  SetMyProfileVariables,
+  SetMyProfileResult,
+  UpdateCustomerProfileVariables,
+  UpdateCustomerProfileResult,
+  DeleteMyProfileResult,
+} from '../operations/customer-profile.js';
+
+export function useMyProfile(
+  options?: QueryHookOptions<GetMyProfileResult>
+) {
+  return useQuery<GetMyProfileResult>(
+    gql\`\${GET_MY_PROFILE}\`,
+    options
+  );
+}
+
+export function useCustomerProfile(
+  customerId: string | null | undefined,
+  options?: Omit<QueryHookOptions<GetCustomerProfileResult, GetCustomerProfileVariables>, 'variables' | 'skip'>
+) {
+  return useQuery<GetCustomerProfileResult, GetCustomerProfileVariables>(
+    gql\`\${GET_CUSTOMER_PROFILE}\`,
+    { ...options, variables: { customerId: customerId! }, skip: !customerId }
+  );
+}
+
+export function useSetMyProfile(
+  options?: MutationHookOptions<SetMyProfileResult, SetMyProfileVariables>
+) {
+  return useMutation<SetMyProfileResult, SetMyProfileVariables>(
+    gql\`\${SET_MY_PROFILE}\`,
+    options
+  );
+}
+
+export function useUpdateCustomerProfile(
+  options?: MutationHookOptions<UpdateCustomerProfileResult, UpdateCustomerProfileVariables>
+) {
+  return useMutation<UpdateCustomerProfileResult, UpdateCustomerProfileVariables>(
+    gql\`\${UPDATE_CUSTOMER_PROFILE}\`,
+    options
+  );
+}
+
+export function useDeleteMyProfile(
+  options?: MutationHookOptions<DeleteMyProfileResult>
+) {
+  return useMutation<DeleteMyProfileResult>(
+    gql\`\${DELETE_MY_PROFILE}\`,
+    options
+  );
+}
+`;
+}

package/dist/codegen/generators/customer-profile-loaders.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generates Remix/server-side loader functions for customer profiles.
+ */
+export declare function generateCustomerProfileLoaders(): string;
+//# sourceMappingURL=customer-profile-loaders.d.ts.map

package/dist/codegen/generators/customer-profile-loaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-profile-loaders.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/customer-profile-loaders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,8BAA8B,IAAI,MAAM,CA+DvD"}

package/dist/codegen/generators/customer-profile-loaders.js

@@ -0,0 +1,67 @@
+/**
+ * Generates Remix/server-side loader functions for customer profiles.
+ */
+export function generateCustomerProfileLoaders() {
+    return `/**
+ * Remix / server-side loader functions for Customer Profiles
+ *
+ * @generated by foir — DO NOT EDIT MANUALLY
+ */
+
+import {
+  GET_MY_PROFILE,
+  GET_CUSTOMER_PROFILE,
+  SET_MY_PROFILE,
+  UPDATE_CUSTOMER_PROFILE,
+  DELETE_MY_PROFILE,
+} from '../operations/customer-profile.js';
+import type {
+  GetMyProfileResult,
+  GetCustomerProfileVariables,
+  GetCustomerProfileResult,
+  SetMyProfileVariables,
+  SetMyProfileResult,
+  UpdateCustomerProfileVariables,
+  UpdateCustomerProfileResult,
+  DeleteMyProfileResult,
+} from '../operations/customer-profile.js';
+
+/** A minimal GraphQL client interface (works with graphql-request, urql, or custom). */
+export interface GraphQLClient {
+  request<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
+}
+
+export async function getMyProfile(
+  client: GraphQLClient
+): Promise<GetMyProfileResult> {
+  return client.request<GetMyProfileResult>(GET_MY_PROFILE);
+}
+
+export async function getCustomerProfile(
+  client: GraphQLClient,
+  variables: GetCustomerProfileVariables
+): Promise<GetCustomerProfileResult> {
+  return client.request<GetCustomerProfileResult>(GET_CUSTOMER_PROFILE, variables as Record<string, unknown>);
+}
+
+export async function setMyProfile(
+  client: GraphQLClient,
+  variables: SetMyProfileVariables
+): Promise<SetMyProfileResult> {
+  return client.request<SetMyProfileResult>(SET_MY_PROFILE, variables as Record<string, unknown>);
+}
+
+export async function updateCustomerProfile(
+  client: GraphQLClient,
+  variables: UpdateCustomerProfileVariables
+): Promise<UpdateCustomerProfileResult> {
+  return client.request<UpdateCustomerProfileResult>(UPDATE_CUSTOMER_PROFILE, variables as Record<string, unknown>);
+}
+
+export async function deleteMyProfile(
+  client: GraphQLClient
+): Promise<DeleteMyProfileResult> {
+  return client.request<DeleteMyProfileResult>(DELETE_MY_PROFILE);
+}
+`;
+}

package/dist/codegen/generators/customer-profile-operations.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generates typed operations for customer profiles.
+ */
+export declare function generateCustomerProfileOperations(typesRelPath: string): string;
+//# sourceMappingURL=customer-profile-operations.d.ts.map

package/dist/codegen/generators/customer-profile-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-profile-operations.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/customer-profile-operations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,MAAM,GACnB,MAAM,CA0HR"}

package/dist/codegen/generators/customer-profile-operations.js

@@ -0,0 +1,126 @@
+/**
+ * Generates typed operations for customer profiles.
+ */
+export function generateCustomerProfileOperations(typesRelPath) {
+    return `/**
+ * Typed operations for Customer Profiles
+ *
+ * @generated by foir — DO NOT EDIT MANUALLY
+ */
+
+import type { CustomerProfileData } from '${typesRelPath}/customer-profile.js';
+
+export const GET_MY_PROFILE = \`
+  query GetMyProfile {
+    myProfile {
+      id
+      customerId
+      data
+      createdAt
+      updatedAt
+    }
+  }
+\`;
+
+export interface GetMyProfileResult {
+  myProfile: {
+    id: string;
+    customerId: string;
+    data: CustomerProfileData;
+    createdAt: string;
+    updatedAt: string;
+  } | null;
+}
+
+export const GET_CUSTOMER_PROFILE = \`
+  query GetCustomerProfile($customerId: ID!) {
+    customerProfile(customerId: $customerId) {
+      id
+      customerId
+      data
+      createdAt
+      updatedAt
+    }
+  }
+\`;
+
+export interface GetCustomerProfileVariables {
+  customerId: string;
+}
+
+export interface GetCustomerProfileResult {
+  customerProfile: {
+    id: string;
+    customerId: string;
+    data: CustomerProfileData;
+    createdAt: string;
+    updatedAt: string;
+  } | null;
+}
+
+export const SET_MY_PROFILE = \`
+  mutation SetMyProfile($data: JSON!) {
+    setMyProfile(data: $data) {
+      id
+      customerId
+      data
+      createdAt
+      updatedAt
+    }
+  }
+\`;
+
+export interface SetMyProfileVariables {
+  data: Partial<CustomerProfileData>;
+}
+
+export interface SetMyProfileResult {
+  setMyProfile: {
+    id: string;
+    customerId: string;
+    data: CustomerProfileData;
+    createdAt: string;
+    updatedAt: string;
+  };
+}
+
+export const UPDATE_CUSTOMER_PROFILE = \`
+  mutation UpdateCustomerProfile($customerId: ID, $input: CustomerProfileInput!) {
+    updateCustomerProfile(customerId: $customerId, input: $input) {
+      id
+      customerId
+      data
+      createdAt
+      updatedAt
+    }
+  }
+\`;
+
+export interface UpdateCustomerProfileVariables {
+  customerId?: string;
+  input: {
+    data: Partial<CustomerProfileData>;
+  };
+}
+
+export interface UpdateCustomerProfileResult {
+  updateCustomerProfile: {
+    id: string;
+    customerId: string;
+    data: CustomerProfileData;
+    createdAt: string;
+    updatedAt: string;
+  };
+}
+
+export const DELETE_MY_PROFILE = \`
+  mutation DeleteMyProfile {
+    deleteMyProfile
+  }
+\`;
+
+export interface DeleteMyProfileResult {
+  deleteMyProfile: boolean;
+}
+`;
+}

package/dist/codegen/generators/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAiGlE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAgBhD"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAiGlE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAoBhD"}

package/dist/codegen/generators/documents.js

@@ -111,12 +111,16 @@ export function generateSharedFragments() {
 fragment ShareFields on Share {
   id
   resourceType
+  recordId
+  fileId
   permission
   status
+  sharedWithCustomerId
   acceptedAt
   declinedAt
   expiresAt
   createdAt
+  createdBy
   revokedAt
 }
 `;

package/dist/codegen/generators/public-schema-content.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fetches the public schema from the platform and writes it for consumer codegen.
+ *
+ * Instead of bundling a static copy, we fetch it at `foir pull` time
+ * using the introspection-like projectSchemas query. This ensures
+ * the schema always matches the connected platform version.
+ */
+import type { GraphQLClient } from 'graphql-request';
+/**
+ * Fetch the public schema SDL from the platform.
+ * Falls back to empty string if not available (non-critical).
+ */
+export declare function fetchPublicSchema(client: GraphQLClient): Promise<string | null>;
+//# sourceMappingURL=public-schema-content.d.ts.map

package/dist/codegen/generators/public-schema-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-schema-content.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/public-schema-content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB"}

package/dist/codegen/generators/public-schema-content.js

@@ -0,0 +1,22 @@
+/**
+ * Fetches the public schema from the platform and writes it for consumer codegen.
+ *
+ * Instead of bundling a static copy, we fetch it at `foir pull` time
+ * using the introspection-like projectSchemas query. This ensures
+ * the schema always matches the connected platform version.
+ */
+/**
+ * Fetch the public schema SDL from the platform.
+ * Falls back to empty string if not available (non-critical).
+ */
+export async function fetchPublicSchema(client) {
+    try {
+        // The public API exposes an SDL endpoint; if not available, skip.
+        const res = await client.request(`query { _service { sdl } }`);
+        return res._service?.sdl ?? null;
+    }
+    catch {
+        // Schema fetch is best-effort — not all deployments expose _service
+        return null;
+    }
+}

package/dist/codegen/generators/react-hooks-index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates the hooks/index.ts barrel re-export file.
+ */
+import type { CodegenModel } from '../fetch-models.js';
+export declare function generateReactHooksIndex(models: CodegenModel[], hasCustomerProfile: boolean): string;
+//# sourceMappingURL=react-hooks-index.d.ts.map

package/dist/codegen/generators/react-hooks-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-hooks-index.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/react-hooks-index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EAAE,EACtB,kBAAkB,EAAE,OAAO,GAC1B,MAAM,CAoBR"}

package/dist/codegen/generators/react-hooks-index.js

@@ -0,0 +1,20 @@
+/**
+ * Generates the hooks/index.ts barrel re-export file.
+ */
+export function generateReactHooksIndex(models, hasCustomerProfile) {
+    const lines = [];
+    lines.push(`/**
+ * React Apollo hooks for all models.
+ *
+ * @generated by foir — DO NOT EDIT MANUALLY
+ */
+`);
+    for (const model of models) {
+        lines.push(`export * from './${model.key}.js';`);
+    }
+    if (hasCustomerProfile) {
+        lines.push(`export * from './customer-profile.js';`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/codegen/generators/react-hooks.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates per-model React Apollo hooks.
+ * Each hook file imports from ../operations/{key}.js and wraps useQuery/useMutation.
+ */
+import type { CodegenModel } from '../fetch-models.js';
+export declare function generateReactHooks(model: CodegenModel): string;
+//# sourceMappingURL=react-hooks.d.ts.map

package/dist/codegen/generators/react-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-hooks.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/react-hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAiJ9D"}

package/dist/codegen/generators/react-hooks.js

@@ -0,0 +1,139 @@
+/**
+ * Generates per-model React Apollo hooks.
+ * Each hook file imports from ../operations/{key}.js and wraps useQuery/useMutation.
+ */
+import { toPascalCase, toUpperSnakeCase } from '../field-mapping.js';
+export function generateReactHooks(model) {
+    const typeName = toPascalCase(model.key);
+    const upperSnake = toUpperSnakeCase(model.key);
+    const pluralName = model.pluralName
+        ? toPascalCase(model.pluralName.replace(/\s+/g, ''))
+        : `${typeName}s`;
+    const pluralUpperSnake = model.pluralName
+        ? toUpperSnakeCase(model.pluralName.replace(/\s+/g, ''))
+        : `${upperSnake}S`;
+    const lines = [];
+    // Imports
+    lines.push(`/**
+ * React Apollo hooks for ${model.name ?? model.key}
+ *
+ * @generated by foir — DO NOT EDIT MANUALLY
+ */
+
+import { useQuery, useMutation } from '@apollo/client';
+import type { QueryHookOptions, MutationHookOptions } from '@apollo/client';
+import { gql } from '@apollo/client';
+import {
+  GET_${upperSnake},
+  GET_${upperSnake}_BY_KEY,
+  LIST_${pluralUpperSnake},
+  CREATE_${upperSnake},
+  UPDATE_${upperSnake},
+  DELETE_${upperSnake},
+  PUBLISH_${upperSnake}_VERSION,
+  UNPUBLISH_${upperSnake},
+} from '../operations/${model.key}.js';
+import type {
+  ${typeName}Record,
+  Get${typeName}Variables,
+  Get${typeName}Result,
+  Get${typeName}ByKeyVariables,
+  Get${typeName}ByKeyResult,
+  List${pluralName}Variables,
+  List${pluralName}Result,
+  Create${typeName}Variables,
+  Create${typeName}Result,
+  Update${typeName}Variables,
+  Update${typeName}Result,
+  Delete${typeName}Variables,
+  Delete${typeName}Result,
+} from '../operations/${model.key}.js';
+`);
+    // Re-export types for convenience
+    lines.push(`export type { ${typeName}Record };`);
+    lines.push('');
+    // useGet{Model}
+    lines.push(`export function useGet${typeName}(
+  id: string | null | undefined,
+  options?: Omit<QueryHookOptions<Get${typeName}Result, Get${typeName}Variables>, 'variables' | 'skip'>
+) {
+  return useQuery<Get${typeName}Result, Get${typeName}Variables>(
+    gql\`\${GET_${upperSnake}}\`,
+    { ...options, variables: { id: id! }, skip: !id }
+  );
+}`);
+    lines.push('');
+    // useGet{Model}ByKey
+    lines.push(`export function useGet${typeName}ByKey(
+  naturalKey: string | null | undefined,
+  options?: Omit<QueryHookOptions<Get${typeName}ByKeyResult, Get${typeName}ByKeyVariables>, 'variables' | 'skip'>
+) {
+  return useQuery<Get${typeName}ByKeyResult, Get${typeName}ByKeyVariables>(
+    gql\`\${GET_${upperSnake}_BY_KEY}\`,
+    { ...options, variables: { naturalKey: naturalKey! }, skip: !naturalKey }
+  );
+}`);
+    lines.push('');
+    // useList{Models}
+    lines.push(`export function useList${pluralName}(
+  variables?: List${pluralName}Variables,
+  options?: Omit<QueryHookOptions<List${pluralName}Result, List${pluralName}Variables>, 'variables'>
+) {
+  return useQuery<List${pluralName}Result, List${pluralName}Variables>(
+    gql\`\${LIST_${pluralUpperSnake}}\`,
+    { ...options, variables }
+  );
+}`);
+    lines.push('');
+    // useCreate{Model}
+    lines.push(`export function useCreate${typeName}(
+  options?: MutationHookOptions<Create${typeName}Result, Create${typeName}Variables>
+) {
+  return useMutation<Create${typeName}Result, Create${typeName}Variables>(
+    gql\`\${CREATE_${upperSnake}}\`,
+    options
+  );
+}`);
+    lines.push('');
+    // useUpdate{Model}
+    lines.push(`export function useUpdate${typeName}(
+  options?: MutationHookOptions<Update${typeName}Result, Update${typeName}Variables>
+) {
+  return useMutation<Update${typeName}Result, Update${typeName}Variables>(
+    gql\`\${UPDATE_${upperSnake}}\`,
+    options
+  );
+}`);
+    lines.push('');
+    // useDelete{Model}
+    lines.push(`export function useDelete${typeName}(
+  options?: MutationHookOptions<Delete${typeName}Result, Delete${typeName}Variables>
+) {
+  return useMutation<Delete${typeName}Result, Delete${typeName}Variables>(
+    gql\`\${DELETE_${upperSnake}}\`,
+    options
+  );
+}`);
+    lines.push('');
+    // usePublish{Model}Version
+    lines.push(`export function usePublish${typeName}Version(
+  options?: MutationHookOptions<{ publishVersion: boolean }, { versionId: string }>
+) {
+  return useMutation<{ publishVersion: boolean }, { versionId: string }>(
+    gql\`\${PUBLISH_${upperSnake}_VERSION}\`,
+    options
+  );
+}`);
+    lines.push('');
+    // useUnpublish{Model}
+    lines.push(`export function useUnpublish${typeName}(
+  options?: MutationHookOptions<{ unpublishRecord: boolean }, { id: string }>
+) {
+  return useMutation<{ unpublishRecord: boolean }, { id: string }>(
+    gql\`\${UNPUBLISH_${upperSnake}}\`,
+    options
+  );
+}`);
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/codegen/generators/remix-loaders-index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates the loaders/index.ts barrel re-export file.
+ */
+import type { CodegenModel } from '../fetch-models.js';
+export declare function generateRemixLoadersIndex(models: CodegenModel[], hasCustomerProfile: boolean): string;
+//# sourceMappingURL=remix-loaders-index.d.ts.map

package/dist/codegen/generators/remix-loaders-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix-loaders-index.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/remix-loaders-index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EAAE,EACtB,kBAAkB,EAAE,OAAO,GAC1B,MAAM,CAoBR"}

package/dist/codegen/generators/remix-loaders-index.js

@@ -0,0 +1,20 @@
+/**
+ * Generates the loaders/index.ts barrel re-export file.
+ */
+export function generateRemixLoadersIndex(models, hasCustomerProfile) {
+    const lines = [];
+    lines.push(`/**
+ * Remix / server-side loader functions for all models.
+ *
+ * @generated by foir — DO NOT EDIT MANUALLY
+ */
+`);
+    for (const model of models) {
+        lines.push(`export * from './${model.key}.js';`);
+    }
+    if (hasCustomerProfile) {
+        lines.push(`export * from './customer-profile.js';`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/codegen/generators/remix-loaders.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates per-model Remix loader functions.
+ * Each function is a typed async wrapper over a generic GraphQL client.
+ */
+import type { CodegenModel } from '../fetch-models.js';
+export declare function generateRemixLoaders(model: CodegenModel): string;
+//# sourceMappingURL=remix-loaders.d.ts.map

package/dist/codegen/generators/remix-loaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix-loaders.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/remix-loaders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAsGhE"}