@restforgejs/platform 5.2.13 → 5.3.5

package/generators/cli/endpoint/create.js

@@ -34,6 +34,8 @@ const DemoGenerator = require('../../src/utils/demo-generator');
 const projectRegistry = require('../../lib/utils/project-registry');
 const cliOutput = require('../../lib/utils/cli-output');
 const endpointSchemaValidator = require('../../lib/payload/endpoint-schema-validator');
+const { deriveFieldProjections, augmentProjectionsForSoftDelete } = require('../../lib/payload/field-projections');
+const configResolver = require('../../lib/utils/config-resolver');
 
 function hasAuditRequired(payload) {
     if (!payload || !payload.fieldPolicy) return false;
@@ -143,14 +145,12 @@ module.exports = {
     async handler(args) {
         const startTime = Date.now();
         let muted = false;
+        let summary = null;
 
         try {
             const project = ArgumentValidator.validateProjectName(args.project);
             const endpoint = ArgumentValidator.validateEndpointName(args.name);
             const payloadFile = ArgumentValidator.validatePayloadName(args.payload);
-            const database = args.database
-                ? ArgumentValidator.validateDatabaseType(args.database)
-                : 'postgres';
             const force = !!args.force;
             const createExamples = !!args['create-examples'];
             const skipSqlValidation = !!args['skip-sql-validation'];
@@ -161,6 +161,30 @@ module.exports = {
                 ? args.config.trim()
                 : null;
 
+            // Resolusi tipe database:
+            //   1. --database eksplisit → dipakai apa adanya (prioritas tertinggi)
+            //   2. Auto-deteksi DB_TYPE dari config aktif (--config, atau default
+            //      config .restforge/defaults.json) → mengikuti DB_TYPE project
+            //   3. Fallback 'postgres' bila tidak ada config yang bisa di-resolve
+            let database;
+            let databaseSource;
+            if (args.database) {
+                database = ArgumentValidator.validateDatabaseType(args.database);
+                databaseSource = 'flag';
+            } else {
+                const resolvedCfg = configResolver.resolveConfig(configArg, process.cwd());
+                const detected = resolvedCfg
+                    ? configResolver.readDatabaseTypeFromConfig(resolvedCfg.path)
+                    : null;
+                if (detected) {
+                    database = detected;
+                    databaseSource = resolvedCfg.source === 'default' ? 'config-default' : 'config';
+                } else {
+                    database = 'postgres';
+                    databaseSource = 'fallback';
+                }
+            }
+
             if (!verbose) {
                 cliOutput.mute();
                 muted = true;
@@ -170,12 +194,17 @@ module.exports = {
             console.log(`   Project: ${project}`);
             console.log(`   Endpoint: ${endpoint}`);
             console.log(`   Payload: ${payloadFile}`);
-            console.log(`   Database: ${database}`);
+            const databaseNote = databaseSource === 'config'
+                ? ' (auto-detected from --config)'
+                : databaseSource === 'config-default'
+                    ? ' (auto-detected from default config)'
+                    : '';
+            console.log(`   Database: ${database}${databaseNote}`);
             console.log(`   Force overwrite: ${force}`);
             console.log('');
 
             const cwd = process.cwd();
-            const summary = {
+            summary = {
                 config: { project, endpoint, database, force },
                 payload: null,
                 archive: null,
@@ -204,7 +233,7 @@ module.exports = {
             const schemaResult = await endpointSchemaValidator.validateEndpointSchema({
                 payload,
                 payloadFileName: path.basename(payloadFile),
-                payloadFilePath: payloadFile,
+                payloadFilePath: rawPayload._payloadPath,
                 configArg,
                 skipSchemaCheck,
                 workingDir: cwd
@@ -216,6 +245,37 @@ module.exports = {
             summary.schemaValidation = schemaResult;
             summary.config.config = configArg || null;
 
+            // Derivasi field projections dan embed ke payload sebagai _fieldProjections.
+            // Template membaca ini untuk emit schemaFields/readableFields/datatablesFields.
+            // Fallback ke fieldName bila DB tidak tersedia (skipSchemaCheck atau projectionInputs absent).
+            {
+                const fn = payload.fieldName || [];
+                let fieldProjections;
+                if (schemaResult.status === 'ok' && schemaResult.projectionInputs) {
+                    fieldProjections = deriveFieldProjections({
+                        fieldName: fn,
+                        physicalColumns: schemaResult.projectionInputs.physicalColumns,
+                        readSourceColumns: schemaResult.projectionInputs.readSourceColumns,
+                        datatablesColumns: schemaResult.projectionInputs.datatablesColumns,
+                        overrides: {
+                            readableFields: payload.readableFields,
+                            datatablesFields: payload.datatablesFields
+                        }
+                    });
+                } else {
+                    // skipSchemaCheck atau projectionInputs tidak tersedia:
+                    // fallback langsung ke fieldName untuk semua proyeksi tanpa DB.
+                    // Override payload.readableFields / datatablesFields diterapkan bila ada.
+                    fieldProjections = {
+                        schemaFields: fn.slice(),
+                        readableFields: payload.readableFields || fn.slice(),
+                        datatablesFields: payload.datatablesFields || fn.slice()
+                    };
+                }
+                augmentProjectionsForSoftDelete(fieldProjections, payload);
+                payload._fieldProjections = fieldProjections;
+            }
+
             const registry = projectRegistry.loadProjectRegistry();
             if (registry.projects[project]) {
                 const existing = registry.projects[project];
@@ -312,6 +372,9 @@ module.exports = {
             // cli-entry.js men-print `Error: <message>` ke stderr saat handler
             // re-throw (lihat handler dispatch). Jangan double-print di sini.
             if (muted) cliOutput.unmute();
+            if (summary && summary.config) {
+                cliOutput.printCreatePartial(summary);
+            }
             throw error;
         }
     }

package/generators/cli/fast-track.js

@@ -385,7 +385,9 @@ async function collectConfig(args, ask, fileCfg = {}) {
         console.log('  SQLite mode: DB_HOST, DB_PORT, DB_USER, DB_PASSWORD are ignored.');
         console.log('  The database file path is set in DB_FILE.');
         console.log('');
-        cfg.DB_FILE = await askField('DB_FILE (.db file path)', fileCfg.DB_FILE || DEFAULTS.DB_FILE);
+        // fileCfg.DB_NAME: file legacy hasil `restforge init` menyimpan path
+        // sqlite di DB_NAME, bukan DB_FILE (lihat init.js & server.js runtime).
+        cfg.DB_FILE = await askField('DB_FILE (.db file path)', fileCfg.DB_FILE || fileCfg.DB_NAME || DEFAULTS.DB_FILE);
         cfg.DB_NAME = cfg.DB_FILE;
     } else {
         const dbDef = DB_TYPE_DEFAULTS[cfg.DB_TYPE] || {};
@@ -415,7 +417,7 @@ function defaultCfgFromFile(args, fileCfg = {}) {
     cfg.DB_TYPE = (fileCfg.DB_TYPE || DEFAULTS.DB_TYPE).toLowerCase();
 
     if (cfg.DB_TYPE === 'sqlite') {
-        cfg.DB_FILE = fileCfg.DB_FILE || DEFAULTS.DB_FILE;
+        cfg.DB_FILE = fileCfg.DB_FILE || fileCfg.DB_NAME || DEFAULTS.DB_FILE;
         cfg.DB_NAME = cfg.DB_FILE;
     } else {
         const dbDef = DB_TYPE_DEFAULTS[cfg.DB_TYPE] || {};

package/generators/cli/payload/sync.js

@@ -32,10 +32,11 @@ module.exports = {
             description: 'Sync only a specific table (default: all)'
         },
         'expand-fk': {
-            type: 'boolean',
+            type: 'string',
             required: false,
-            default: false,
-            description: 'Generate JOIN configuration from foreign keys: creates SQL file query/<table>-join.sql and sets datatablesQuery/viewQuery to that file. Opt-in; without this flag sync behavior is unchanged. Requires --table. If --fk-columns is empty, display columns per FK are auto-selected (name → code → primary key)'
+            default: null,
+            bareDefault: 'both',
+            description: 'Generate JOIN configuration from foreign keys: creates SQL file query/<table>-join.sql. Values: "both" (updates datatablesQuery and viewQuery) or "datatables-only" (updates datatablesQuery only, viewQuery unchanged). Bare --expand-fk (without value) defaults to "both". Requires --table. If --fk-columns is empty, display columns per FK are auto-selected (name → code → primary key)'
         },
         'fk-columns': {
             type: 'string',
@@ -47,16 +48,25 @@ module.exports = {
     examples: [
         'npx restforge payload sync --config=db.env',
         'npx restforge payload sync --config=db.env --table=users',
-        'npx restforge payload sync --table=visitors --expand-fk',
-        'npx restforge payload sync --table=visitors --expand-fk --fk-columns=visitor_categories.category_code,visitor_categories.category_name'
+        'npx restforge payload sync --table=visitors --expand-fk=both',
+        'npx restforge payload sync --table=visitors --expand-fk=datatables-only',
+        'npx restforge payload sync --table=visitors --expand-fk=both --fk-columns=visitor_categories.category_code,visitor_categories.category_name'
     ],
     async handler(args) {
+        const expandFkRaw = args['expand-fk'];
+        let expandFkMode = null;
+        if (expandFkRaw === 'both' || expandFkRaw === 'datatables-only') {
+            expandFkMode = expandFkRaw;
+        } else if (expandFkRaw !== null && expandFkRaw !== undefined) {
+            throw new Error(`Invalid --expand-fk value "${expandFkRaw}". Valid values: both, datatables-only`);
+        }
+
         const generator = new PayloadGenerator();
         await generator.run({
             config: args.config,
             table: args.table || null,
             sync: true,
-            expandFk: args['expand-fk'] === true,
+            expandFkMode,
             fkColumns: args['fk-columns'] || null
         });
     }

package/generators/cli/project/auth.js

@@ -0,0 +1,209 @@
+'use strict';
+
+/**
+ * Contract: project auth
+ *
+ * Memasang "auth extension" (SDF, tabel, component, processor) ke project
+ * RESTForge yang sudah ada. Setelah validasi prasyarat (phase 00), handler
+ * menulis dua file SDF auth ber-prefix `rfx` ke `--schema-path` (Fungsi 1),
+ * lalu membuat tabelnya di DB via primitif dbschema-kit langsung (Fungsi 2),
+ * lalu menulis component middleware + router auth termasuk route google (Fungsi 3a),
+ * lalu menulis ketujuh processor auth termasuk google (Fungsi 3b), lalu
+ * menginjeksi variabel env auth ke `--config` dan memverifikasi/mencatat
+ * dependency runtime `bcrypt`+`jsonwebtoken` (Fungsi tambahan, phase 05),
+ * lalu mencetak ringkasan akhir.
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { validateSafeName } = require('../../lib/utils/path-validator');
+const projectRegistry = require('../../lib/utils/project-registry');
+const { PREFIX } = require('../../lib/auth/prefix');
+const { generateAuthSdf } = require('../../lib/auth/sdf-generator');
+const { runAuthMigrate } = require('../../lib/auth/migrate-runner');
+const { generateAuthComponents } = require('../../lib/auth/component-generator');
+const { generateAuthProcessors } = require('../../lib/auth/processor-generator');
+const { injectAuthEnv } = require('../../lib/auth/env-injector');
+const { ensureAuthDependencies } = require('../../lib/auth/dependency-checker');
+
+function projectExists(workingDir, projectName) {
+    const modulePath = path.join(workingDir, 'src', 'modules', `${projectName}.js`);
+    if (fs.existsSync(modulePath)) {
+        return true;
+    }
+
+    const registry = projectRegistry.loadProjectRegistry();
+    return Boolean(registry.projects && registry.projects[projectName]);
+}
+
+module.exports = {
+    resource: 'project',
+    verb: 'auth',
+    description: 'Install auth extension (SDF, tabel, component, processor) ke project existing',
+    category: 'generation',
+    flags: {
+        create: {
+            type: 'boolean',
+            required: false,
+            default: false,
+            description: 'Trigger eksekusi instalasi auth extension (wajib disertakan)'
+        },
+        project: {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Nama project target (kanonik; alias: --name)'
+        },
+        name: {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Alias dari --project'
+        },
+        'schema-path': {
+            type: 'string',
+            required: false,
+            default: './schema',
+            description: 'Folder output file SDF auth'
+        },
+        config: {
+            type: 'string',
+            required: false,
+            default: 'config/db-connection.env',
+            description: 'File konfigurasi koneksi DB untuk langkah migrate'
+        },
+        force: {
+            type: 'boolean',
+            required: false,
+            default: false,
+            description: 'Timpa file yang sudah ada (backup tetap dibuat)'
+        }
+    },
+    examples: [
+        'npx restforge project auth --create --project=myapp',
+        'npx restforge project auth --create --name=myapp --schema-path=./schema'
+    ],
+    async handler(args) {
+        if (args.create !== true) {
+            throw new Error(
+                'Flag --create wajib disertakan untuk memicu instalasi auth extension. ' +
+                'Contoh: npx restforge project auth --create --project=<nama-project>'
+            );
+        }
+
+        const rawName = args.project || args.name;
+        if (!rawName) {
+            throw new Error('Salah satu dari --project atau --name wajib diisi dengan nama project target');
+        }
+
+        const projectName = validateSafeName(rawName, 'project');
+        const workingDir = process.cwd();
+
+        if (!projectExists(workingDir, projectName)) {
+            throw new Error(
+                `Project "${projectName}" tidak ditemukan (src/modules/${projectName}.js tidak ada). ` +
+                'Buat project lebih dulu (mis. "npx restforge endpoint create") sebelum menjalankan project auth.'
+            );
+        }
+
+        const schemaPath = path.resolve(workingDir, args['schema-path'] || './schema');
+        const { written, skipped } = generateAuthSdf({ schemaPath, force: args.force === true });
+
+        console.log('');
+        console.log(`Prasyarat OK untuk project "${projectName}" (prefix artefak: ${PREFIX}).`);
+        if (written.length > 0) {
+            console.log(`SDF auth ditulis: ${written.map((p) => path.basename(p)).join(', ')}`);
+        }
+        if (skipped.length > 0) {
+            console.log(
+                `SDF auth sudah ada, dilewati (gunakan --force untuk overwrite): ${skipped.map((p) => path.basename(p)).join(', ')}`
+            );
+        }
+
+        const configPath = args.config || 'config/db-connection.env';
+        const migrateResult = await runAuthMigrate({ schemaPath, configPath });
+        console.log(
+            `Tabel auth siap: ${migrateResult.tables.join(', ')} ` +
+            `(dialect: ${migrateResult.dialect}, ${migrateResult.statementsApplied} statement diterapkan).`
+        );
+
+        const middlewareDir = path.join(workingDir, 'src', 'components', 'handlers');
+        const routerDir = path.join(workingDir, 'src', 'modules', projectName);
+        const { written: componentsWritten, skipped: componentsSkipped } = generateAuthComponents({
+            middlewareDir,
+            routerDir,
+            projectName,
+            force: args.force === true
+        });
+
+        if (componentsWritten.length > 0) {
+            console.log(
+                `Component/router auth ditulis: ${componentsWritten.map((p) => path.relative(workingDir, p)).join(', ')}`
+            );
+        }
+        if (componentsSkipped.length > 0) {
+            console.log(
+                `Component/router auth sudah ada, dilewati (gunakan --force untuk overwrite): ` +
+                `${componentsSkipped.map((p) => path.relative(workingDir, p)).join(', ')}`
+            );
+        }
+
+        const processorDir = path.join(workingDir, 'src', 'modules', projectName, 'processor', 'auth');
+        const { written: processorsWritten, skipped: processorsSkipped } = generateAuthProcessors({
+            processorDir,
+            force: args.force === true
+        });
+
+        if (processorsWritten.length > 0) {
+            console.log(
+                `Processor auth ditulis: ${processorsWritten.map((p) => path.relative(workingDir, p)).join(', ')}`
+            );
+        }
+        if (processorsSkipped.length > 0) {
+            console.log(
+                `Processor auth sudah ada, dilewati (gunakan --force untuk overwrite): ` +
+                `${processorsSkipped.map((p) => path.relative(workingDir, p)).join(', ')}`
+            );
+        }
+        const envResult = injectAuthEnv({ configPath });
+        const dependencyResult = ensureAuthDependencies({ workingDir });
+
+        console.log('');
+        console.log(`Environment auth (${path.relative(workingDir, envResult.filePath) || envResult.filePath}):`);
+        if (envResult.added.length > 0) {
+            console.log(`  ditambahkan: ${envResult.added.join(', ')}`);
+        }
+        if (envResult.skipped.length > 0) {
+            console.log(`  sudah ada, dilewati (nilai existing dipertahankan): ${envResult.skipped.join(', ')}`);
+        }
+
+        console.log('Dependency runtime (bcrypt, jsonwebtoken):');
+        for (const [depName, info] of Object.entries(dependencyResult.resolution)) {
+            console.log(`  ${depName}: ${info.resolvable ? `resolvable (${info.resolvedPath})` : 'TIDAK resolvable dari project target'}`);
+        }
+        if (dependencyResult.packageJson.hasPackageJson) {
+            if (dependencyResult.packageJson.added.length > 0) {
+                console.log(`  package.json diperbarui, dependencies ditambahkan: ${dependencyResult.packageJson.added.join(', ')}`);
+            } else {
+                console.log('  package.json project sudah mencantumkan bcrypt & jsonwebtoken (tidak diubah)');
+            }
+        } else {
+            console.log('  package.json tidak ditemukan di project target, tidak dicatat otomatis');
+        }
+        if (dependencyResult.needsInstallInstruction) {
+            console.log('  Jalankan "npm install bcrypt jsonwebtoken" di project target sebelum start server.');
+        }
+
+        console.log('');
+        console.log('Auth extension terpasang.');
+        console.log('Langkah lanjutan:');
+        if (envResult.jwtSecretGenerated) {
+            console.log('  - JWT_SECRET baru di-generate acak; rotate berkala sesuai kebijakan keamanan bila perlu.');
+        }
+        if (dependencyResult.needsInstallInstruction) {
+            console.log('  - Jalankan npm install agar bcrypt/jsonwebtoken terpasang sebelum start server.');
+        }
+        console.log('  - Restart server agar perubahan environment dan route auth termuat.');
+        console.log('');
+    }
+};

package/generators/cli/project/sdk.js

@@ -0,0 +1,112 @@
+'use strict';
+
+/**
+ * Contract: project sdk
+ *
+ * Menghasilkan SDK JavaScript untuk satu project RESTForge — satu layer tipis di
+ * atas REST API hasil generate, dipakai frontend apa pun tanpa menulis ulang
+ * boilerplate fetch/$.ajax.
+ *
+ * Rujukan desain: docs/plan/sdk-generator-command.md.
+ *
+ * Versi awal:
+ * - TANPA auth (flag --with-auth & core/auth-client.js menyusul terpisah).
+ * - --generate hanya MENULIS source buildable (src/, package.json, tsup.config.js);
+ *   `npm install && npm run build` adalah langkah terpisah milik user.
+ * - Sumber kebenaran resource = metadata/<project>.json (key endpoint = slug = segment route).
+ */
+
+const { validateSafeName } = require('../../lib/utils/path-validator');
+const { generateSdk, resolveBaseUrl } = require('../../lib/sdk/generator');
+
+module.exports = {
+    resource: 'project',
+    verb: 'sdk',
+    description: 'Generate a JavaScript SDK for a project (derived from backend metadata + payload)',
+    category: 'generation',
+    flags: {
+        project: {
+            type: 'string',
+            required: true,
+            description: 'Target project name (also the SDK package name)'
+        },
+        generate: {
+            type: 'boolean',
+            required: true,
+            description: 'Trigger SDK source generation'
+        },
+        'sdk-path': {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Output folder for the SDK source (default: <project-root>/sdk)'
+        },
+        'base-url': {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Override the API base URL baked into sdk-client.js (default: derived from the project config)'
+        },
+        force: {
+            type: 'boolean',
+            required: false,
+            default: false,
+            description: 'Overwrite existing SDK source'
+        }
+    },
+    examples: [
+        'npx restforge project sdk --generate --project=myapp',
+        'npx restforge project sdk --generate --project=myapp --sdk-path=./client-sdk',
+        'npx restforge project sdk --generate --project=myapp --force'
+    ],
+    async handler(args) {
+        const project = validateSafeName(args.project, 'project');
+
+        if (args.generate !== true) {
+            const err = new Error('The --generate flag must be set to run SDK generation.');
+            err.exitCode = 2;
+            throw err;
+        }
+
+        const workingDir = process.cwd();
+
+        console.log('');
+        console.log(`Generating SDK for project '${project}'...`);
+        console.log('');
+
+        const baseUrl = resolveBaseUrl({
+            workingDir,
+            project,
+            override: args['base-url'],
+            log: (line) => console.log(`  ${line}`)
+        });
+
+        const result = generateSdk({
+            workingDir,
+            project,
+            sdkPath: args['sdk-path'],
+            baseUrl,
+            force: args.force === true,
+            log: (line) => console.log(`  ${line}`)
+        });
+
+        console.log('');
+        console.log('==========================================');
+        console.log('SDK GENERATION COMPLETE');
+        console.log('==========================================');
+        console.log(`Project   : ${project}`);
+        console.log(`Output    : ${result.outputDir}`);
+        console.log(`Base URL  : ${result.baseUrl}`);
+        console.log(`Auth      : ${result.hasAuth ? 'enabled (client.auth)' : 'none'}`);
+        console.log(`Resources : ${result.resources.length} (${result.resources.join(', ')})`);
+        console.log('');
+        console.log('Next steps (optional, owned by you):');
+        console.log(`  cd ${result.outputDir}`);
+        console.log('  npm install');
+        console.log('  npm run build');
+        console.log('  npm run deploy        # copy into a frontend app js/ folder (asks for target)');
+        console.log('  # or: node deploy.mjs <target-app-js-folder>');
+        console.log('==========================================');
+        console.log('');
+    }
+};

package/generators/lib/arg-parser.js

@@ -119,6 +119,12 @@ function parseArgs(argv, contract) {
 
             if (!valueProvided) {
                 if (i + 1 >= argv.length || argv[i + 1].startsWith('--')) {
+                    if (flagDef.bareDefault !== undefined) {
+                        args[flagName] = flagDef.bareDefault;
+                        seenFlags.add(flagName);
+                        i += 1;
+                        continue;
+                    }
                     errors.push(`Flag --${flagName} requires a value`);
                     i += 1;
                     continue;

package/generators/lib/auth/component-generator.js

@@ -0,0 +1,58 @@
+'use strict';
+
+/**
+ * Generator component middleware + router auth (Fungsi 3a). Merender aset
+ * template di `templates/` via template-renderer, lalu menulis ke lokasi
+ * target memakai writeFileWithBackup — perilaku force/skip identik Fungsi 1
+ * (sdf-generator.js): tanpa --force file existing di-skip, dengan --force
+ * di-overwrite + backup.
+ *
+ * Processor (Fungsi 3b, Phase 04) TIDAK ditulis di sini.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { renderTemplate } = require('./template-renderer');
+const FileUtils = require('../utils/file-utils');
+const { AUTH_MIDDLEWARE_NAME, AUTH_ROUTER_NAME } = require('./prefix');
+
+const TEMPLATES_DIR = path.join(__dirname, 'templates');
+
+/**
+ * @param {{ middlewareDir: string, routerDir: string, projectName: string, force?: boolean }} options
+ * @returns {{ written: string[], skipped: string[] }}
+ */
+function generateAuthComponents({ middlewareDir, routerDir, projectName, force = false }) {
+    const targets = [
+        {
+            templateFile: 'rfx_auth-middleware.js.tmpl',
+            targetPath: path.join(middlewareDir, `${AUTH_MIDDLEWARE_NAME}.js`),
+            params: {}
+        },
+        {
+            templateFile: 'rfx_auth.js.tmpl',
+            targetPath: path.join(routerDir, `${AUTH_ROUTER_NAME}.js`),
+            params: { PROJECT_NAME: projectName }
+        }
+    ];
+
+    const written = [];
+    const skipped = [];
+
+    for (const target of targets) {
+        if (fs.existsSync(target.targetPath) && !force) {
+            skipped.push(target.targetPath);
+            continue;
+        }
+
+        const templatePath = path.join(TEMPLATES_DIR, target.templateFile);
+        const content = renderTemplate(templatePath, target.params);
+        FileUtils.writeFileWithBackup(target.targetPath, content, true);
+        written.push(target.targetPath);
+    }
+
+    return { written, skipped };
+}
+
+module.exports = { generateAuthComponents };