import { resource } from "@emelon/openapi-nano";

const ShinobiSelectSchema = {
  type: "object" as const,
  properties: {
    id: { type: "string" },
    name: { type: "string" },
    clan: { type: "string" },
  },
  required: ["id", "name"],
};

const ShinobiInsertSchema = {
  type: "object" as const,
  properties: {
    name: { type: "string" },
    clan: { type: "string" },
  },
  required: ["name"],
};

export const shinobiResource = resource({
  select: ShinobiSelectSchema,
  insert: ShinobiInsertSchema,
});

import { route, response, errors } from "@emelon/openapi-nano";
import type { OpenApiReference } from "@emelon/openapi-nano";

// Use standard type-safe pointers to reference shared components
const SHINOBI_REF: OpenApiReference = { $ref: "#/components/schemas/Shinobi" };
const SHINOBI_INSERT_REF: OpenApiReference = {
  $ref: "#/components/schemas/ShinobiInsert",
};

export const getShinobiDoc = route({
  method: "get",
  path: "/shinobi/{id}",
  summary: "Get shinobi character details",
  tag: "Shinobi v1",
  parameters: [
    {
      name: "id",
      in: "path",
      required: true,
      description: "The unique registration ID of the character",
      schema: { type: "string" },
    },
  ],
  responses: {
    ...response(200, SHINOBI_REF, "Character profile found safely"),
    ...errors(401, 404),
  },
});

export const createShinobiDoc = route({
  method: "post",
  path: "/shinobi",
  summary: "Register a new shinobi character",
  tag: "Shinobi v1",
  requestBody: {
    content: {
      "application/json": {
        schema: SHINOBI_INSERT_REF,
      },
    },
  },
  responses: {
    ...response(201, SHINOBI_REF, "Character registration complete"),
    ...errors(400, 401),
  },
});

export const shinobiDocSuite = [getShinobiDoc, createShinobiDoc];

import { generateOpenApiSpec } from "@emelon/openapi-nano";
import { shinobiDocSuite } from "./shinobi.docs.js";
import { shinobiResource } from "./shinobi.types.js";

export const standardSpecification = generateOpenApiSpec({
  title: "Hidden Leaf Village API Docs",
  version: "1.0.0",
  description: "Enterprise domain-driven data presentation schemas.",
  components: {
    schemas: {
      // Registering here assigns pointers used by your paths automatically
      Shinobi: shinobiResource.select,
      ShinobiInsert: shinobiResource.insert,
    },
  },
  routes: [...shinobiDocSuite],
});

import { generateOpenApiSpec } from "@emelon/openapi-nano";
import { compileJsonApiSchemas } from "@emelon/openapi-nano/jsonapi";
import { shinobiDocSuite } from "./shinobi.docs.js";
import { shinobiResource } from "./shinobi.types.js";

// Compiles fully wrapped resource, singleResponse, and collectionResponse documentation schemas
const shinobiJsonApiSuite = compileJsonApiSchemas({
  type: "shinobi",
  pascalName: "Shinobi",
  schema: shinobiResource.select,
});

export const jsonApiSpecification = generateOpenApiSpec({
  title: "Hidden Leaf Village API Docs (JSON:API Compliant)",
  version: "1.0.0",
  components: {
    schemas: {
      ShinobiInsert: shinobiResource.insert,
      ShinobiObject: shinobiJsonApiSuite.resourceSchema,
      ShinobiSingleResponse: shinobiJsonApiSuite.singleResponseSchema,
      ShinobiCollectionResponse: shinobiJsonApiSuite.collectionResponseSchema,
    },
  },
  routes: shinobiDocSuite,
});