@devup-api/vite-plugin 0.1.0

package/README.md

@@ -0,0 +1,24 @@
+# @devup-api/vite-plugin
+
+devup API plugin for Vite
+
+## Installation
+
+```bash
+npm install @devup-api/vite-plugin
+```
+
+## Usage
+
+```typescript
+import devupApiVitePlugin from '@devup-api/vite-plugin';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [
+    devupApiVitePlugin({
+      // options
+    }),
+  ],
+});
+```

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/plugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.test.d.ts.map

package/dist/__tests__/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/plugin.test.ts"],"names":[],"mappings":""}

package/dist/index.cjs

@@ -0,0 +1 @@
+var{defineProperty:C,getOwnPropertyNames:H,getOwnPropertyDescriptor:K}=Object,L=Object.prototype.hasOwnProperty;var E=new WeakMap,P=(x)=>{var b=E.get(x),k;if(b)return b;if(b=C({},"__esModule",{value:!0}),x&&typeof x==="object"||typeof x==="function")H(x).map((q)=>!L.call(b,q)&&C(b,q,{get:()=>x[q],enumerable:!(k=K(x,q))||k.enumerable}));return E.set(x,b),b};var Q=(x,b)=>{for(var k in b)C(x,k,{get:b[k],enumerable:!0,configurable:!0,set:(q)=>b[k]=()=>q})};var R={};Q(R,{devupApi:()=>G,default:()=>G});module.exports=P(R);var F=require("node:path"),B=require("@devup-api/generator"),z=require("@devup-api/utils");function G(x){return{name:"devup-api",async configResolved(){let b=await z.createTmpDirAsync(x?.tempDir),k=await z.readOpenapiAsync(x?.openapiFile);await z.writeInterfaceAsync(F.join(b,"api.d.ts"),B.generateInterface(k,x))},async config(){let b=await z.readOpenapiAsync(x?.openapiFile),k=B.createUrlMap(b,x),q={};if(k)q["process.env.DEVUP_API_URL_MAP"]=JSON.stringify(JSON.stringify(k));return{define:q}}}}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './plugin';
+export { devupApi as default } from './plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1 @@
+import{join as B}from"node:path";import{createUrlMap as C,generateInterface as E}from"@devup-api/generator";import{createTmpDirAsync as F,readOpenapiAsync as z,writeInterfaceAsync as G}from"@devup-api/utils";function H(x){return{name:"devup-api",async configResolved(){let k=await F(x?.tempDir),b=await z(x?.openapiFile);await G(B(k,"api.d.ts"),E(b,x))},async config(){let k=await z(x?.openapiFile),b=C(k,x),q={};if(b)q["process.env.DEVUP_API_URL_MAP"]=JSON.stringify(JSON.stringify(b));return{define:q}}}}export{H as devupApi,H as default};

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { DevupApiOptions } from '@devup-api/core';
+import type { Plugin } from 'vite';
+export declare function devupApi(options?: DevupApiOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAOtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CA2B1D"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@devup-api/vite-plugin",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc && bun build --target node --outfile=dist/index.js src/index.ts --production --packages=external && bun build --target node --outfile=dist/index.cjs --format=cjs src/index.ts --production --packages=external"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@devup-api/utils": "0.1.0",
+    "@devup-api/core": "0.1.0",
+    "@devup-api/generator": "0.1.0"
+  },
+  "peerDependencies": {
+    "vite": "*",
+    "@devup-api/core": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10",
+    "typescript": "^5.9"
+  }
+}

package/src/__tests__/index.test.ts

@@ -0,0 +1,9 @@
+import { expect, test } from 'bun:test'
+import * as indexModule from '../index'
+
+test('index.ts exports', () => {
+  expect({ ...indexModule }).toEqual({
+    devupApi: expect.any(Function),
+    default: expect.any(Function),
+  })
+})

package/src/__tests__/plugin.test.ts

@@ -0,0 +1,170 @@
+import { beforeEach, expect, spyOn, test } from 'bun:test'
+import { join } from 'node:path'
+import type { DevupApiOptions } from '@devup-api/core'
+import * as generator from '@devup-api/generator'
+import * as utils from '@devup-api/utils'
+import { devupApi } from '../plugin'
+
+let mockCreateTmpDirAsync: ReturnType<typeof spyOn>
+let mockReadOpenapiAsync: ReturnType<typeof spyOn>
+let mockWriteInterfaceAsync: ReturnType<typeof spyOn>
+let mockCreateUrlMap: ReturnType<typeof spyOn>
+let mockGenerateInterface: ReturnType<typeof spyOn>
+
+const mockSchema = {
+  openapi: '3.1.0',
+  paths: {
+    '/users': {
+      get: {
+        operationId: 'getUsers',
+        responses: {
+          '200': {
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'array',
+                  items: { type: 'string' },
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+} as const
+
+const mockUrlMap = {
+  getUsers: {
+    method: 'GET' as const,
+    url: '/users',
+  },
+  '/users': {
+    method: 'GET' as const,
+    url: '/users',
+  },
+}
+
+const mockInterfaceContent = 'export interface Test {}'
+
+beforeEach(() => {
+  mockCreateTmpDirAsync = spyOn(utils, 'createTmpDirAsync').mockResolvedValue(
+    'df',
+  )
+  mockReadOpenapiAsync = spyOn(utils, 'readOpenapiAsync').mockResolvedValue(
+    mockSchema as never,
+  )
+  mockWriteInterfaceAsync = spyOn(
+    utils,
+    'writeInterfaceAsync',
+  ).mockResolvedValue(undefined)
+  mockCreateUrlMap = spyOn(generator, 'createUrlMap').mockReturnValue(
+    mockUrlMap as never,
+  )
+  mockGenerateInterface = spyOn(generator, 'generateInterface').mockReturnValue(
+    mockInterfaceContent,
+  )
+})
+
+test('devupApi returns plugin with correct name', () => {
+  const plugin = devupApi()
+  expect(plugin.name).toBe('devup-api')
+})
+
+test.each([
+  [undefined],
+  [{ tempDir: 'custom-dir' }],
+  [{ openapiFile: 'custom-openapi.json' }],
+  [
+    {
+      tempDir: 'custom-dir',
+      openapiFile: 'custom-openapi.json',
+      convertCase: 'snake' as const,
+    },
+  ],
+] as const)('devupApi returns plugin with config hook: %s', async (options:
+  | DevupApiOptions
+  | undefined) => {
+  const plugin = devupApi(options)
+  expect(plugin.config).toBeDefined()
+  expect(typeof plugin.config).toBe('function')
+
+  const result = await (
+    plugin as unknown as {
+      config?: () => Promise<{ define: Record<string, string> }>
+    }
+  ).config?.()
+  expect(mockReadOpenapiAsync).toHaveBeenCalledWith(options?.openapiFile)
+  expect(mockCreateUrlMap).toHaveBeenCalledWith(mockSchema, options)
+  expect(result).toEqual({
+    define: {
+      'process.env.DEVUP_API_URL_MAP': JSON.stringify(
+        JSON.stringify(mockUrlMap),
+      ),
+    },
+  })
+})
+
+test('devupApi config hook returns empty define when urlMap is null', async () => {
+  mockCreateUrlMap.mockReturnValue(null as never)
+  const plugin = devupApi()
+  const result = await (
+    plugin as unknown as {
+      config?: () => Promise<{ define: Record<string, string> }>
+    }
+  ).config?.()
+  expect(result).toEqual({
+    define: {},
+  })
+})
+
+test('devupApi config hook returns empty define when urlMap is undefined', async () => {
+  mockCreateUrlMap.mockReturnValue(undefined as never)
+  const plugin = devupApi()
+  const result = await (
+    plugin as unknown as {
+      config?: () => Promise<{ define: Record<string, string> }>
+    }
+  ).config?.()
+  expect(result).toEqual({
+    define: {},
+  })
+})
+
+test.each([
+  [undefined],
+  [{ tempDir: 'custom-dir' }],
+  [{ openapiFile: 'custom-openapi.json' }],
+  [
+    {
+      tempDir: 'custom-dir',
+      openapiFile: 'custom-openapi.json',
+      convertCase: 'pascal' as const,
+    },
+  ],
+] as const)('devupApi returns plugin with configResolved hook: %s', async (options:
+  | DevupApiOptions
+  | undefined) => {
+  const plugin = devupApi(options)
+  expect(plugin.configResolved).toBeDefined()
+  expect(typeof plugin.configResolved).toBe('function')
+
+  await (
+    plugin as unknown as { configResolved?: () => Promise<void> }
+  ).configResolved?.()
+  expect(mockCreateTmpDirAsync).toHaveBeenCalledWith(options?.tempDir)
+  expect(mockReadOpenapiAsync).toHaveBeenCalledWith(options?.openapiFile)
+  expect(mockGenerateInterface).toHaveBeenCalledWith(mockSchema, options)
+  expect(mockWriteInterfaceAsync).toHaveBeenCalledWith(
+    join('df', 'api.d.ts'),
+    mockInterfaceContent,
+  )
+})
+
+test('devupApi plugin has both config and configResolved hooks', () => {
+  const plugin = devupApi()
+  expect(plugin.config).toBeDefined()
+  expect(plugin.configResolved).toBeDefined()
+  expect(typeof plugin.config).toBe('function')
+  expect(typeof plugin.configResolved).toBe('function')
+})

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './plugin'
+export { devupApi as default } from './plugin'

package/src/plugin.ts

@@ -0,0 +1,38 @@
+import { join } from 'node:path'
+import type { DevupApiOptions } from '@devup-api/core'
+import { createUrlMap, generateInterface } from '@devup-api/generator'
+import {
+  createTmpDirAsync,
+  readOpenapiAsync,
+  writeInterfaceAsync,
+} from '@devup-api/utils'
+import type { Plugin } from 'vite'
+
+export function devupApi(options?: DevupApiOptions): Plugin {
+  return {
+    name: 'devup-api',
+    // Vite plugin implementation
+    async configResolved() {
+      const tempDir = await createTmpDirAsync(options?.tempDir)
+      const schema = await readOpenapiAsync(options?.openapiFile)
+      await writeInterfaceAsync(
+        join(tempDir, 'api.d.ts'),
+        generateInterface(schema, options),
+      )
+    },
+    async config() {
+      const schema = await readOpenapiAsync(options?.openapiFile)
+      const urlMap = createUrlMap(schema, options)
+      const define: Record<string, string> = {}
+      if (urlMap) {
+        // json stringify twice to avoid JSON.parse error
+        define['process.env.DEVUP_API_URL_MAP'] = JSON.stringify(
+          JSON.stringify(urlMap),
+        )
+      }
+      return {
+        define,
+      }
+    },
+  }
+}

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "verbatimModuleSyntax": true,
+    "emitDeclarationOnly": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["dist", "node_modules"]
+}