@omnifyjp/omnify 3.14.1 → 3.15.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnifyjp/omnify",
-  "version": "3.14.1",
+  "version": "3.15.1",
   "description": "Schema-driven code generation for Laravel, TypeScript, and SQL",
   "license": "MIT",
   "repository": {
@@ -36,10 +36,10 @@
     "zod": "^3.24.0"
   },
   "optionalDependencies": {
-    "@omnifyjp/omnify-darwin-arm64": "3.14.1",
-    "@omnifyjp/omnify-darwin-x64": "3.14.1",
-    "@omnifyjp/omnify-linux-x64": "3.14.1",
-    "@omnifyjp/omnify-linux-arm64": "3.14.1",
-    "@omnifyjp/omnify-win32-x64": "3.14.1"
+    "@omnifyjp/omnify-darwin-arm64": "3.15.1",
+    "@omnifyjp/omnify-darwin-x64": "3.15.1",
+    "@omnifyjp/omnify-linux-x64": "3.15.1",
+    "@omnifyjp/omnify-linux-arm64": "3.15.1",
+    "@omnifyjp/omnify-win32-x64": "3.15.1"
   }
 }

package/ts-dist/cli.js

@@ -102,6 +102,8 @@ function resolveFromConfig(configPath) {
         inputSpec,
         tsEnabled,
         tsOutput,
+        tsPlatform: tsConfig?.platform,
+        tsAuth: tsConfig?.auth,
         laravelEnabled,
         laravelOverrides,
     };
@@ -120,6 +122,8 @@ program
     let inputSpec;
     let tsEnabled = true;
     let tsOutput;
+    let tsPlatform;
+    let tsAuth;
     let laravelEnabled = false;
     let laravelOverrides;
     let configDir = process.cwd();
@@ -142,6 +146,8 @@ program
         inputSpec = opts.input ?? resolved.inputSpec;
         tsEnabled = resolved.tsEnabled;
         tsOutput = opts.output ? resolve(opts.output) : resolved.tsOutput;
+        tsPlatform = resolved.tsPlatform;
+        tsAuth = resolved.tsAuth;
         laravelEnabled = resolved.laravelEnabled;
         laravelOverrides = resolved.laravelOverrides;
     }
@@ -166,7 +172,10 @@ program
     // ---- TypeScript generation ----
     if (tsEnabled && tsOutput) {
         console.log(`\n[TypeScript] Output: ${tsOutput}`);
-        const files = generateTypeScript(input);
+        const files = generateTypeScript(input, {
+            platform: tsPlatform,
+            auth: tsAuth,
+        });
         mkdirSync(join(tsOutput, 'base'), { recursive: true });
         mkdirSync(join(tsOutput, 'enum'), { recursive: true });
         let tsCreated = 0;

package/ts-dist/generator.d.ts

@@ -13,7 +13,15 @@
  *   index.ts               — Re-exports (always overwritten)
  */
 import type { SchemasJson, TypeScriptFile } from './types.js';
+/** Build GeneratorOptions from schemas.json. */
+/** Extra config that the CLI resolves from omnify.yaml's codegen.typescript section. */
+export interface GenerateExtraConfig {
+    platform?: 'web' | 'expo';
+    auth?: 'cookie' | 'secureStore';
+}
 /**
  * Generate all TypeScript files from schemas.json input.
+ *
+ * @param extra - Platform/auth config resolved from omnify.yaml's codegen.typescript section (issue #63).
  */
-export declare function generateTypeScript(input: SchemasJson): TypeScriptFile[];
+export declare function generateTypeScript(input: SchemasJson, extra?: GenerateExtraConfig): TypeScriptFile[];

package/ts-dist/generator.js

@@ -21,6 +21,7 @@ import { generateTsServices } from './ts-service-generator.js';
 import { generateTsQueryKeys } from './ts-query-keys-generator.js';
 import { generateTsHooks } from './ts-hooks-generator.js';
 import { buildFormShape, formatPayloadBuilderSection, } from './payload-builder-generator.js';
+import { generateRnQuerySetup } from './rn-query-setup-generator.js';
 /** Auto-generated file header. */
 function generateBaseHeader() {
     return `/**
@@ -33,13 +34,14 @@ function generateBaseHeader() {
 
 `;
 }
-/** Build GeneratorOptions from schemas.json. */
-function buildOptions(input) {
+function buildOptions(input, extra) {
     return {
         locales: input.locale.locales,
         defaultLocale: input.locale.defaultLocale,
         fallbackLocale: input.locale.fallbackLocale,
         customTypes: input.customTypes,
+        platform: extra?.platform,
+        auth: extra?.auth,
     };
 }
 /** Generate a base interface file for a schema. */
@@ -437,9 +439,11 @@ function validateSchemaNames(schemas) {
 }
 /**
  * Generate all TypeScript files from schemas.json input.
+ *
+ * @param extra - Platform/auth config resolved from omnify.yaml's codegen.typescript section (issue #63).
  */
-export function generateTypeScript(input) {
-    const options = buildOptions(input);
+export function generateTypeScript(input, extra) {
+    const options = buildOptions(input, extra);
     const schemas = input.schemas;
     // Validate no reserved name collisions
     validateSchemaNames(schemas);
@@ -501,6 +505,10 @@ export function generateTypeScript(input) {
     files.push(...generateTsServices(schemas, options));
     files.push(...generateTsQueryKeys(schemas));
     files.push(...generateTsHooks(schemas));
+    // React Native / Expo query setup (issue #63)
+    if (options.platform === 'expo') {
+        files.push(generateRnQuerySetup(options.auth ?? 'secureStore'));
+    }
     // Index re-exports
     files.push(generateIndexFile(schemas, schemaEnums, pluginEnums, inlineTypeAliases, hasFiles));
     return files;

package/ts-dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * TypeScript model type generator from Omnify schemas.json.
  */
-export { generateTypeScript } from './generator.js';
+export { generateTypeScript, type GenerateExtraConfig } from './generator.js';
 export type { SchemasJson, SchemaDefinition, PropertyDefinition, TypeScriptFile, TSInterface, TSProperty, TSEnum, TSEnumValue, TSTypeAlias, GeneratorOptions, LocalizedString, LocaleMap, } from './types.js';
 export { schemaToInterface, formatInterface, formatProperty, generateInterfaces, getPropertyType, toSnakeCase, } from './interface-generator.js';
 export { generateEnums, generatePluginEnums, formatEnum, formatTypeAlias, extractInlineEnums, toPascalCase, toEnumMemberName, } from './enum-generator.js';

package/ts-dist/php/schema-reader.d.ts

@@ -51,7 +51,9 @@ export declare class SchemaReader {
     getSchemasWithApi(): Record<string, SchemaDefinition>;
     /** Check if any schema has api options. */
     hasApiSchemas(): boolean;
-    /** Check if any schema has File-type properties. */
+    /** Check if any schema has File-type properties OR the project has
+     *  `file:` config (issue #64: generate File infrastructure even when
+     *  no schema declares `type: File` yet). */
     hasFileProperties(): boolean;
     /** Get the file config from schemas.json. */
     getFileConfig(): import("../types.js").FileConfigExport | null;

package/ts-dist/php/schema-reader.js

@@ -172,8 +172,12 @@ export class SchemaReader {
     hasApiSchemas() {
         return Object.keys(this.getSchemasWithApi()).length > 0;
     }
-    /** Check if any schema has File-type properties. */
+    /** Check if any schema has File-type properties OR the project has
+     *  `file:` config (issue #64: generate File infrastructure even when
+     *  no schema declares `type: File` yet). */
     hasFileProperties() {
+        if (this.data.fileConfig)
+            return true;
         for (const schema of Object.values(this.getObjectSchemas())) {
             const props = schema.properties ?? {};
             for (const prop of Object.values(props)) {

package/ts-dist/rn-query-setup-generator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @omnify/ts — React Native Query Setup Generator (issue #63)
+ *
+ * When the codegen target has `platform: 'expo'`, this module generates a
+ * `rn-query-setup.ts` utility file at the output root. The file wires up
+ * TanStack Query's `focusManager` and `onlineManager` for React Native so
+ * queries auto-refetch when the app comes back from the background and
+ * pause when the device is offline.
+ *
+ * The file also exports an `apiFetch` wrapper that reads the bearer token
+ * from Expo SecureStore (async) and injects it into every request. This
+ * replaces the browser-cookie auth path used by web targets.
+ */
+import type { TypeScriptFile } from './types.js';
+/**
+ * Generate `rn-query-setup.ts` for Expo / React Native targets.
+ *
+ * @param auth - Auth strategy: 'secureStore' (default for expo) or 'cookie'
+ */
+export declare function generateRnQuerySetup(auth?: string): TypeScriptFile;

package/ts-dist/rn-query-setup-generator.js

@@ -0,0 +1,154 @@
+/**
+ * @omnify/ts — React Native Query Setup Generator (issue #63)
+ *
+ * When the codegen target has `platform: 'expo'`, this module generates a
+ * `rn-query-setup.ts` utility file at the output root. The file wires up
+ * TanStack Query's `focusManager` and `onlineManager` for React Native so
+ * queries auto-refetch when the app comes back from the background and
+ * pause when the device is offline.
+ *
+ * The file also exports an `apiFetch` wrapper that reads the bearer token
+ * from Expo SecureStore (async) and injects it into every request. This
+ * replaces the browser-cookie auth path used by web targets.
+ */
+/**
+ * Generate `rn-query-setup.ts` for Expo / React Native targets.
+ *
+ * @param auth - Auth strategy: 'secureStore' (default for expo) or 'cookie'
+ */
+export function generateRnQuerySetup(auth = 'secureStore') {
+    const authImport = auth === 'secureStore'
+        ? `import * as SecureStore from 'expo-secure-store';`
+        : '';
+    const authHeaders = auth === 'secureStore'
+        ? `
+/**
+ * Read the bearer token from Expo SecureStore (async) and return the
+ * Authorization header. Returns an empty object when no token is stored.
+ */
+async function getAuthHeaders(): Promise<Record<string, string>> {
+  const token = await SecureStore.getItemAsync('auth_token');
+  return token ? { Authorization: \`Bearer \${token}\` } : {};
+}
+
+/**
+ * Authenticated fetch wrapper for React Native. Injects the bearer token
+ * from SecureStore into every request. Use this as the \`apiFetch\`
+ * parameter when creating service factories.
+ *
+ * @example
+ * const zoneService = createZoneBaseService((path) => \`\${BASE_URL}/zones\${path}\`);
+ * // In the app, wrap with apiFetch from this module.
+ */
+export async function apiFetch<T>(url: string, init?: RequestInit): Promise<T> {
+  const headers = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+    ...await getAuthHeaders(),
+    ...init?.headers,
+  };
+  const res = await fetch(url, { ...init, headers });
+  if (!res.ok) {
+    const body = await res.text().catch(() => '');
+    throw new Error(body || \`HTTP \${res.status}\`);
+  }
+  return res.json();
+}
+`
+        : `
+/**
+ * Basic fetch wrapper (cookie auth). Same as the web target's user-land
+ * apiFetch — provided here so the generated service files can import from
+ * a consistent location.
+ */
+export async function apiFetch<T>(url: string, init?: RequestInit): Promise<T> {
+  const headers = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+    ...init?.headers,
+  };
+  const res = await fetch(url, { ...init, headers, credentials: 'include' });
+  if (!res.ok) {
+    const body = await res.text().catch(() => '');
+    throw new Error(body || \`HTTP \${res.status}\`);
+  }
+  return res.json();
+}
+`;
+    const content = `/**
+ * DO NOT EDIT - Auto-generated by Omnify.
+ *
+ * React Native / Expo query setup. Wire this up in your app's entry point
+ * (e.g. \`app/_layout.tsx\`) to enable:
+ *   - Auto-refetch when the app returns from background (AppState)
+ *   - Pause queries when offline (NetInfo)
+ *   - Authenticated fetch with bearer token from SecureStore
+ *
+ * @generated by omnify (issue #63)
+ */
+
+import { AppState, type AppStateStatus } from 'react-native';
+import NetInfo from '@react-native-community/netinfo';
+import {
+  focusManager,
+  onlineManager,
+  QueryClient,
+} from '@tanstack/react-query';
+${authImport}
+
+// ---- Focus Manager (refetch on app foreground) ----
+
+function onAppStateChange(status: AppStateStatus) {
+  focusManager.setFocused(status === 'active');
+}
+
+/**
+ * Call once at app startup to wire AppState → TanStack Query focusManager.
+ * When the user switches back to the app, all stale queries refetch.
+ */
+export function setupFocusManager(): () => void {
+  const sub = AppState.addEventListener('change', onAppStateChange);
+  return () => sub.remove();
+}
+
+// ---- Online Manager (pause queries when offline) ----
+
+/**
+ * Call once at app startup to wire NetInfo → TanStack Query onlineManager.
+ * Queries pause when the device loses connectivity and resume when it's back.
+ */
+export function setupOnlineManager(): () => void {
+  return onlineManager.setEventListener((setOnline) => {
+    return NetInfo.addEventListener((state) => {
+      setOnline(!!state.isConnected);
+    });
+  });
+}
+
+// ---- Query Client factory ----
+
+/**
+ * Pre-configured QueryClient for React Native with sensible defaults:
+ * - \`refetchOnWindowFocus\` wired via focusManager above
+ * - \`retry: 2\` for flaky mobile networks
+ * - \`staleTime: 30s\` to reduce unnecessary refetches on tab switch
+ */
+export function createRnQueryClient(): QueryClient {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        retry: 2,
+        staleTime: 30_000,
+      },
+    },
+  });
+}
+${authHeaders}
+`;
+    return {
+        filePath: 'rn-query-setup.ts',
+        content,
+        types: ['setupFocusManager', 'setupOnlineManager', 'createRnQueryClient', 'apiFetch'],
+        overwrite: true,
+    };
+}

package/ts-dist/types.d.ts

@@ -51,6 +51,10 @@ export interface SchemasJson {
 export interface PackageExportInfo {
     readonly migrationsPath?: string;
     readonly codegen?: PackageCodegenExport;
+    /** Schema name → consumer FQCN mapping for relation resolution. Issue #61. */
+    readonly modelMap?: Record<string, string>;
+    /** Whether this package's models are MappedSuperclass (abstract). Issue #61. */
+    readonly abstract?: boolean;
 }
 /** Codegen namespace info from a package. */
 export interface PackageCodegenExport {
@@ -254,6 +258,9 @@ export interface PropertyDefinition {
     readonly mappedBy?: string;
     readonly orderBy?: readonly OrderByItem[];
     readonly useCurrent?: boolean;
+    readonly deprecated?: boolean;
+    readonly deprecatedSince?: string;
+    readonly removalTarget?: string;
     readonly searchable?: boolean;
     readonly filterable?: boolean;
     readonly sortable?: boolean;
@@ -347,4 +354,8 @@ export interface GeneratorOptions {
     readonly defaultLocale: string;
     readonly fallbackLocale: string;
     readonly customTypes: SchemasJson['customTypes'];
+    /** Target platform: 'web' (default) or 'expo' (React Native). Issue #63. */
+    readonly platform?: 'web' | 'expo';
+    /** Auth strategy: 'cookie' (default) or 'secureStore' (Expo). Issue #63. */
+    readonly auth?: 'cookie' | 'secureStore';
 }

package/types/config.d.ts

@@ -19,6 +19,8 @@ export interface MigrationConfig {
   schemasPath?: string;
   /** SQL dialect for generated migrations (sql only). */
   dialect?: SQLDialect;
+  /** Use deterministic timestamps (year-2000 base + sort-order offset) for packages. Issue #60. */
+  stableTimestamps?: boolean;
 }
 
 /** Per-connection database and migration configuration. */
@@ -135,6 +137,8 @@ export interface OmnifyConfig {
   compoundTypes?: string[];
   /** Code generation configuration (connection-independent). */
   codegen?: CodegenConfig;
+  /** Package mode: stable deterministic timestamps for all Laravel migrations. Issue #60. */
+  package?: boolean;
   /** Enable verbose output during generation. */
   verbose?: boolean;
 }