@classytic/arc 1.1.0 → 2.1.3

package/dist/cli/commands/generate.js

@@ -1,334 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
-
-// src/cli/commands/generate.ts
-function isTypeScriptProject() {
-  return existsSync(join(process.cwd(), "tsconfig.json"));
-}
-function getTemplates(ts) {
-  return {
-    model: (name) => `/**
- * ${name} Model
- * Generated by Arc CLI
- */
-
-import mongoose${ts ? ", { type HydratedDocument }" : ""} from 'mongoose';
-
-const { Schema } = mongoose;
-${ts ? `
-type ${name} = {
-  name: string;
-  description?: string;
-  isActive: boolean;
-};
-
-export type ${name}Document = HydratedDocument<${name}>;
-` : ""}
-const ${name.toLowerCase()}Schema = new Schema${ts ? `<${name}>` : ""}(
-  {
-    name: { type: String, required: true, trim: true },
-    description: { type: String, trim: true },
-    isActive: { type: Boolean, default: true },
-  },
-  { timestamps: true }
-);
-
-// Indexes
-${name.toLowerCase()}Schema.index({ name: 1 });
-${name.toLowerCase()}Schema.index({ isActive: 1 });
-
-const ${name} = mongoose.models.${name}${ts ? ` as mongoose.Model<${name}>` : ""} || mongoose.model${ts ? `<${name}>` : ""}('${name}', ${name.toLowerCase()}Schema);
-export default ${name};
-`,
-    repository: (name) => `/**
- * ${name} Repository
- * Generated by Arc CLI
- */
-
-import {
-  Repository,
-  methodRegistryPlugin,
-  softDeletePlugin,
-  mongoOperationsPlugin,
-} from '@classytic/mongokit';
-${ts ? `import type { ${name}Document } from './${name.toLowerCase()}.model.js';` : ""}
-import ${name} from './${name.toLowerCase()}.model.js';
-
-class ${name}Repository extends Repository${ts ? `<${name}Document>` : ""} {
-  constructor() {
-    super(${name}${ts ? " as any" : ""}, [
-      methodRegistryPlugin(),
-      softDeletePlugin(),
-      mongoOperationsPlugin(),
-    ]);
-  }
-
-  /**
-   * Find all active records
-   */
-  async findActive() {
-    return this.Model.find({ isActive: true, deletedAt: null }).lean();
-  }
-
-  // Add custom repository methods here
-}
-
-const ${name.toLowerCase()}Repository = new ${name}Repository();
-export default ${name.toLowerCase()}Repository;
-export { ${name}Repository };
-`,
-    controller: (name) => `/**
- * ${name} Controller
- * Generated by Arc CLI
- */
-
-import { BaseController } from '@classytic/arc';
-import ${name.toLowerCase()}Repository from './${name.toLowerCase()}.repository.js';
-import { ${name.toLowerCase()}SchemaOptions } from './${name.toLowerCase()}.schemas.js';
-
-class ${name}Controller extends BaseController {
-  constructor() {
-    super(${name.toLowerCase()}Repository${ts ? " as any" : ""}, { schemaOptions: ${name.toLowerCase()}SchemaOptions });
-  }
-
-  // Add custom controller methods here
-}
-
-const ${name.toLowerCase()}Controller = new ${name}Controller();
-export default ${name.toLowerCase()}Controller;
-`,
-    schemas: (name) => `/**
- * ${name} Schemas
- * Generated by Arc CLI
- */
-
-import ${name} from './${name.toLowerCase()}.model.js';
-import { buildCrudSchemasFromModel } from '@classytic/mongokit/utils';
-
-/**
- * CRUD Schemas with Field Rules
- */
-const crudSchemas = buildCrudSchemasFromModel(${name}, {
-  strictAdditionalProperties: true,
-  fieldRules: {
-    // Mark fields as system-managed (excluded from create/update)
-    // deletedAt: { systemManaged: true },
-  },
-  query: {
-    filterableFields: {
-      isActive: 'boolean',
-      createdAt: 'date',
-    },
-  },
-});
-
-// Schema options for controller
-export const ${name.toLowerCase()}SchemaOptions${ts ? ": any" : ""} = {
-  query: {
-    filterableFields: {
-      isActive: 'boolean',
-      createdAt: 'date',
-    },
-  },
-};
-
-export default crudSchemas;
-`,
-    resource: (name) => `/**
- * ${name} Resource
- * Generated by Arc CLI
- */
-
-import { defineResource } from '@classytic/arc';
-import { createAdapter } from '#shared/adapter.js';
-import { publicReadPermissions } from '#shared/permissions.js';
-import ${name} from './${name.toLowerCase()}.model.js';
-import ${name.toLowerCase()}Repository from './${name.toLowerCase()}.repository.js';
-import ${name.toLowerCase()}Controller from './${name.toLowerCase()}.controller.js';
-
-const ${name.toLowerCase()}Resource = defineResource({
-  name: '${name.toLowerCase()}',
-  displayName: '${name}s',
-  prefix: '/${name.toLowerCase()}s',
-
-  adapter: createAdapter(${name}, ${name.toLowerCase()}Repository),
-  controller: ${name.toLowerCase()}Controller,
-
-  presets: ['softDelete'],
-
-  permissions: publicReadPermissions,
-
-  // Add custom routes here:
-  // additionalRoutes: [
-  //   {
-  //     method: 'GET',
-  //     path: '/custom',
-  //     summary: 'Custom endpoint',
-  //     handler: async (request, reply) => { ... },
-  //   },
-  // ],
-});
-
-export default ${name.toLowerCase()}Resource;
-`,
-    test: (name) => `/**
- * ${name} Tests
- * Generated by Arc CLI
- */
-
-import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import mongoose from 'mongoose';
-import { createAppInstance } from '../src/app.js';
-${ts ? "import type { FastifyInstance } from 'fastify';\n" : ""}
-describe('${name} Resource', () => {
-  let app${ts ? ": FastifyInstance" : ""};
-
-  beforeAll(async () => {
-    const testDbUri = process.env.MONGODB_URI || 'mongodb://localhost:27017/test-${name.toLowerCase()}';
-    await mongoose.connect(testDbUri);
-    app = await createAppInstance();
-    await app.ready();
-  });
-
-  afterAll(async () => {
-    await app.close();
-    await mongoose.connection.close();
-  });
-
-  describe('GET /${name.toLowerCase()}s', () => {
-    it('should return a list', async () => {
-      const response = await app.inject({
-        method: 'GET',
-        url: '/${name.toLowerCase()}s',
-      });
-
-      expect(response.statusCode).toBe(200);
-      const body = JSON.parse(response.body);
-      expect(body).toHaveProperty('docs');
-    });
-  });
-});
-`
-  };
-}
-async function generate(type, args) {
-  if (!type) {
-    console.error("Error: Missing type argument");
-    console.log("Usage: arc generate <resource|controller|model|repository|schemas> <name>");
-    process.exit(1);
-  }
-  const [name] = args;
-  if (!name) {
-    console.error("Error: Missing name argument");
-    console.log("Usage: arc generate <type> <name>");
-    console.log("Example: arc generate resource product");
-    process.exit(1);
-  }
-  const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
-  const lowerName = name.toLowerCase();
-  const ts = isTypeScriptProject();
-  const ext = ts ? "ts" : "js";
-  const templates = getTemplates(ts);
-  const resourcePath = join(process.cwd(), "src", "resources", lowerName);
-  switch (type) {
-    case "resource":
-    case "r":
-      await generateResource(capitalizedName, lowerName, resourcePath, templates, ext);
-      break;
-    case "controller":
-    case "c":
-      await generateFile(capitalizedName, lowerName, resourcePath, "controller", templates.controller, ext);
-      break;
-    case "model":
-    case "m":
-      await generateFile(capitalizedName, lowerName, resourcePath, "model", templates.model, ext);
-      break;
-    case "repository":
-    case "repo":
-      await generateFile(capitalizedName, lowerName, resourcePath, "repository", templates.repository, ext);
-      break;
-    case "schemas":
-    case "s":
-      await generateFile(capitalizedName, lowerName, resourcePath, "schemas", templates.schemas, ext);
-      break;
-    default:
-      console.error(`Unknown type: ${type}`);
-      console.log("Available types: resource, controller, model, repository, schemas");
-      process.exit(1);
-  }
-}
-async function generateResource(name, lowerName, resourcePath, templates, ext) {
-  console.log(`
-📦 Generating resource: ${name}...
-`);
-  if (!existsSync(resourcePath)) {
-    mkdirSync(resourcePath, { recursive: true });
-    console.log(`  📁 Created: src/resources/${lowerName}/`);
-  }
-  const files = {
-    [`${lowerName}.model.${ext}`]: templates.model(name),
-    [`${lowerName}.repository.${ext}`]: templates.repository(name),
-    [`${lowerName}.controller.${ext}`]: templates.controller(name),
-    [`${lowerName}.schemas.${ext}`]: templates.schemas(name),
-    [`${lowerName}.resource.${ext}`]: templates.resource(name)
-  };
-  for (const [filename, content] of Object.entries(files)) {
-    const filepath = join(resourcePath, filename);
-    if (existsSync(filepath)) {
-      console.warn(`  ⚠  Skipped: ${filename} (already exists)`);
-    } else {
-      writeFileSync(filepath, content);
-      console.log(`  ✅ Created: ${filename}`);
-    }
-  }
-  const testsDir = join(process.cwd(), "tests");
-  if (!existsSync(testsDir)) {
-    mkdirSync(testsDir, { recursive: true });
-  }
-  const testPath = join(testsDir, `${lowerName}.test.${ext}`);
-  if (!existsSync(testPath)) {
-    writeFileSync(testPath, templates.test(name));
-    console.log(`  ✅ Created: tests/${lowerName}.test.${ext}`);
-  }
-  console.log(`
-╔═══════════════════════════════════════════════════════════════╗
-║                    ✅ Resource Generated!                     ║
-╚═══════════════════════════════════════════════════════════════╝
-
-Next steps:
-
-1. Register in src/resources/index.${ext}:
-   import ${lowerName}Resource from './${lowerName}/${lowerName}.resource.js';
-
-   export const resources = [
-     // ... existing resources
-     ${lowerName}Resource,
-   ];
-
-2. Customize the model schema in:
-   src/resources/${lowerName}/${lowerName}.model.${ext}
-
-3. Run tests:
-   npm test
-`);
-}
-async function generateFile(name, lowerName, resourcePath, fileType, template, ext) {
-  console.log(`
-📦 Generating ${fileType}: ${name}...
-`);
-  if (!existsSync(resourcePath)) {
-    mkdirSync(resourcePath, { recursive: true });
-    console.log(`  📁 Created: src/resources/${lowerName}/`);
-  }
-  const filename = `${lowerName}.${fileType}.${ext}`;
-  const filepath = join(resourcePath, filename);
-  if (existsSync(filepath)) {
-    console.error(`  ❌ Error: ${filename} already exists`);
-    process.exit(1);
-  }
-  writeFileSync(filepath, template(name));
-  console.log(`  ✅ Created: ${filename}`);
-}
-var generate_default = generate;
-
-export { generate_default as default, generate };

package/dist/cli/commands/introspect.d.ts

@@ -1,8 +0,0 @@
-/**
- * Arc CLI - Introspect Command
- *
- * Shows all registered resources and their configuration
- */
-declare function introspect(args: string[]): Promise<void>;
-
-export { introspect as default, introspect };

package/dist/cli/commands/introspect.js

@@ -1,338 +0,0 @@
-import fp from 'fastify-plugin';
-
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/registry/ResourceRegistry.ts
-var ResourceRegistry, registryKey, globalScope, resourceRegistry;
-var init_ResourceRegistry = __esm({
-  "src/registry/ResourceRegistry.ts"() {
-    ResourceRegistry = class {
-      _resources;
-      _frozen;
-      constructor() {
-        this._resources = /* @__PURE__ */ new Map();
-        this._frozen = false;
-      }
-      /**
-       * Register a resource
-       */
-      register(resource, options = {}) {
-        if (this._frozen) {
-          throw new Error(
-            `Registry frozen. Cannot register '${resource.name}' after startup.`
-          );
-        }
-        if (this._resources.has(resource.name)) {
-          throw new Error(`Resource '${resource.name}' already registered.`);
-        }
-        const entry = {
-          name: resource.name,
-          displayName: resource.displayName,
-          tag: resource.tag,
-          prefix: resource.prefix,
-          module: options.module ?? void 0,
-          adapter: resource.adapter ? {
-            type: resource.adapter.type,
-            name: resource.adapter.name
-          } : null,
-          permissions: resource.permissions,
-          presets: resource._appliedPresets ?? [],
-          routes: [],
-          // Populated later by getIntrospection()
-          additionalRoutes: resource.additionalRoutes.map((r) => ({
-            method: r.method,
-            path: r.path,
-            handler: typeof r.handler === "string" ? r.handler : r.handler.name || "anonymous",
-            summary: r.summary,
-            description: r.description,
-            permissions: r.permissions,
-            wrapHandler: r.wrapHandler,
-            schema: r.schema
-            // Include schema for OpenAPI docs
-          })),
-          events: Object.keys(resource.events ?? {}),
-          registeredAt: (/* @__PURE__ */ new Date()).toISOString(),
-          disableDefaultRoutes: resource.disableDefaultRoutes,
-          openApiSchemas: options.openApiSchemas,
-          plugin: resource.toPlugin()
-          // Store plugin factory
-        };
-        this._resources.set(resource.name, entry);
-        return this;
-      }
-      /**
-       * Get resource by name
-       */
-      get(name) {
-        return this._resources.get(name);
-      }
-      /**
-       * Get all resources
-       */
-      getAll() {
-        return Array.from(this._resources.values());
-      }
-      /**
-       * Get resources by module
-       */
-      getByModule(moduleName) {
-        return this.getAll().filter((r) => r.module === moduleName);
-      }
-      /**
-       * Get resources by preset
-       */
-      getByPreset(presetName) {
-        return this.getAll().filter((r) => r.presets.includes(presetName));
-      }
-      /**
-       * Check if resource exists
-       */
-      has(name) {
-        return this._resources.has(name);
-      }
-      /**
-       * Get registry statistics
-       */
-      getStats() {
-        const resources = this.getAll();
-        const presetCounts = {};
-        for (const r of resources) {
-          for (const preset of r.presets) {
-            presetCounts[preset] = (presetCounts[preset] ?? 0) + 1;
-          }
-        }
-        return {
-          totalResources: resources.length,
-          byModule: this._groupBy(resources, "module"),
-          presetUsage: presetCounts,
-          totalRoutes: resources.reduce((sum, r) => {
-            const defaultRouteCount = r.disableDefaultRoutes ? 0 : 5;
-            return sum + (r.additionalRoutes?.length ?? 0) + defaultRouteCount;
-          }, 0),
-          totalEvents: resources.reduce((sum, r) => sum + (r.events?.length ?? 0), 0)
-        };
-      }
-      /**
-       * Get full introspection data
-       */
-      getIntrospection() {
-        return {
-          resources: this.getAll().map((r) => {
-            const defaultRoutes = r.disableDefaultRoutes ? [] : [
-              { method: "GET", path: r.prefix, operation: "list" },
-              { method: "GET", path: `${r.prefix}/:id`, operation: "get" },
-              { method: "POST", path: r.prefix, operation: "create" },
-              { method: "PATCH", path: `${r.prefix}/:id`, operation: "update" },
-              { method: "DELETE", path: `${r.prefix}/:id`, operation: "delete" }
-            ];
-            return {
-              name: r.name,
-              displayName: r.displayName,
-              prefix: r.prefix,
-              module: r.module,
-              presets: r.presets,
-              permissions: r.permissions,
-              routes: [
-                ...defaultRoutes,
-                ...r.additionalRoutes?.map((ar) => ({
-                  method: ar.method,
-                  path: `${r.prefix}${ar.path}`,
-                  operation: typeof ar.handler === "string" ? ar.handler : "custom",
-                  handler: typeof ar.handler === "string" ? ar.handler : void 0,
-                  summary: ar.summary
-                })) ?? []
-              ],
-              events: r.events
-            };
-          }),
-          stats: this.getStats(),
-          generatedAt: (/* @__PURE__ */ new Date()).toISOString()
-        };
-      }
-      /**
-       * Freeze registry (prevent further registrations)
-       */
-      freeze() {
-        this._frozen = true;
-      }
-      /**
-       * Check if frozen
-       */
-      isFrozen() {
-        return this._frozen;
-      }
-      /**
-       * Unfreeze registry (for testing)
-       */
-      _unfreeze() {
-        this._frozen = false;
-      }
-      /**
-       * Clear all resources (for testing)
-       */
-      _clear() {
-        this._resources.clear();
-        this._frozen = false;
-      }
-      /**
-       * Group by key
-       */
-      _groupBy(arr, key) {
-        const result = {};
-        for (const item of arr) {
-          const k = String(item[key] ?? "uncategorized");
-          result[k] = (result[k] ?? 0) + 1;
-        }
-        return result;
-      }
-    };
-    registryKey = /* @__PURE__ */ Symbol.for("arc.resourceRegistry");
-    globalScope = globalThis;
-    resourceRegistry = globalScope[registryKey] ?? new ResourceRegistry();
-    if (!globalScope[registryKey]) {
-      globalScope[registryKey] = resourceRegistry;
-    }
-  }
-});
-var introspectionPlugin, introspectionPlugin_default;
-var init_introspectionPlugin = __esm({
-  "src/registry/introspectionPlugin.ts"() {
-    init_ResourceRegistry();
-    introspectionPlugin = async (fastify, opts = {}) => {
-      const {
-        prefix = "/_resources",
-        authRoles = ["superadmin"],
-        enabled = process.env.NODE_ENV !== "production" || process.env.ENABLE_INTROSPECTION === "true"
-      } = opts;
-      if (!enabled) {
-        fastify.log?.info?.("Introspection plugin disabled");
-        return;
-      }
-      const typedFastify = fastify;
-      const authMiddleware = authRoles.length > 0 && typedFastify.authenticate ? [
-        typedFastify.authenticate,
-        typedFastify.authorize?.(...authRoles)
-      ].filter(Boolean) : [];
-      await fastify.register(async (instance) => {
-        instance.get(
-          "/",
-          {
-            preHandler: authMiddleware
-          },
-          async (_req, _reply) => {
-            return resourceRegistry.getIntrospection();
-          }
-        );
-        instance.get(
-          "/stats",
-          {
-            preHandler: authMiddleware
-          },
-          async (_req, _reply) => {
-            return resourceRegistry.getStats();
-          }
-        );
-        instance.get(
-          "/:name",
-          {
-            schema: {
-              params: {
-                type: "object",
-                properties: {
-                  name: { type: "string" }
-                },
-                required: ["name"]
-              }
-            },
-            preHandler: authMiddleware
-          },
-          async (req, reply) => {
-            const resource = resourceRegistry.get(req.params.name);
-            if (!resource) {
-              return reply.code(404).send({
-                error: `Resource '${req.params.name}' not found`
-              });
-            }
-            return resource;
-          }
-        );
-      }, { prefix });
-      fastify.log?.info?.(`Introspection API at ${prefix}`);
-    };
-    introspectionPlugin_default = fp(introspectionPlugin, { name: "arc-introspection" });
-  }
-});
-
-// src/registry/index.ts
-var registry_exports = {};
-__export(registry_exports, {
-  ResourceRegistry: () => ResourceRegistry,
-  introspectionPlugin: () => introspectionPlugin_default,
-  introspectionPluginFn: () => introspectionPlugin,
-  resourceRegistry: () => resourceRegistry
-});
-var init_registry = __esm({
-  "src/registry/index.ts"() {
-    init_ResourceRegistry();
-    init_introspectionPlugin();
-  }
-});
-
-// src/cli/commands/introspect.ts
-async function introspect(args) {
-  console.log("Introspecting Arc resources...\n");
-  try {
-    const { resourceRegistry: resourceRegistry2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
-    const resources = resourceRegistry2.getAll();
-    if (resources.length === 0) {
-      console.log("⚠️  No resources registered.");
-      console.log("\nTo introspect resources, you need to load them first:");
-      console.log("  arc introspect --entry ./index.js");
-      console.log("\nWhere index.js imports all your resource definitions.");
-      return;
-    }
-    console.log(`Found ${resources.length} resource(s):
-`);
-    resources.forEach((resource, index) => {
-      console.log(`${index + 1}. ${resource.name}`);
-      console.log(`   Display Name: ${resource.displayName}`);
-      console.log(`   Prefix: ${resource.prefix}`);
-      console.log(`   Module: ${resource.module || "none"}`);
-      if (resource.permissions) {
-        console.log(`   Permissions:`);
-        Object.entries(resource.permissions).forEach(([op, roles]) => {
-          console.log(`     ${op}: [${roles.join(", ")}]`);
-        });
-      }
-      if (resource.presets && resource.presets.length > 0) {
-        console.log(`   Presets: ${resource.presets.join(", ")}`);
-      }
-      if (resource.additionalRoutes && resource.additionalRoutes.length > 0) {
-        console.log(`   Additional Routes: ${resource.additionalRoutes.length}`);
-      }
-      console.log("");
-    });
-    const stats = resourceRegistry2.getStats();
-    console.log("Summary:");
-    console.log(`  Total Resources: ${stats.totalResources}`);
-    console.log(`  With Presets: ${resources.filter((r) => r.presets?.length > 0).length}`);
-    console.log(
-      `  With Custom Routes: ${resources.filter((r) => r.additionalRoutes && r.additionalRoutes.length > 0).length}`
-    );
-  } catch (error) {
-    console.error("Error:", error.message);
-    console.log("\nTip: Run this command after starting your application.");
-    process.exit(1);
-  }
-}
-var introspect_default = introspect;
-
-export { introspect_default as default, introspect };

package/dist/cli/index.d.ts

@@ -1,4 +0,0 @@
-export { default as generate } from './commands/generate.js';
-export { default as init } from './commands/init.js';
-export { default as introspect } from './commands/introspect.js';
-export { exportDocs } from './commands/docs.js';