swallowkit 1.0.0-beta.8 → 1.0.0

package/README.md

@@ -2,108 +2,115 @@
 
 [![npm version](https://img.shields.io/npm/v/swallowkit.svg)](https://www.npmjs.com/package/swallowkit)
 [![npm downloads](https://img.shields.io/npm/dm/swallowkit.svg)](https://www.npmjs.com/package/swallowkit)
+[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/himanago.swallowkit-vscode?label=VS%20Code%20Extension)](https://marketplace.visualstudio.com/items?itemName=himanago.swallowkit-vscode)
 [![license](https://img.shields.io/npm/l/swallowkit.svg)](./LICENSE)
 
 English | [日本語](./README.ja.md)
 
-**Type-safe schema-driven development toolkit for Next.js applications on Azure**
+Schema-driven application scaffolding for Next.js and Azure.
 
-SwallowKit enables developers to build full-stack Next.js applications with external Azure Functions backends while maintaining end-to-end type safety through shared Zod schemas.
+SwallowKit helps you build maintainable full-stack applications on Azure by using shared Zod schemas as the source of truth. From one schema definition, it can generate frontend forms, BFF routes, Azure Functions backends, OpenAPI contracts, infrastructure templates, and AI-agent-friendly project metadata.
 
-Deploy your Next.js app to Azure Static Web Apps using standalone mode, and connect to independent Azure Functions for backend operations.
+It is designed for developers who want to build Next.js applications on Azure without letting the frontend, backend, database model, validation rules, and deployment configuration drift apart.
 
-Next.js API routes are restricted to use only as BFF (Backend For Frontend), offloading business logic to Azure Functions to provide clear separation between client and server.
+## 🎯 Why SwallowKit?
 
-Featuring Scaffold functionality to automatically generate CRUD operations from Zod schemas, achieving type-safe integration with Cosmos DB and consistent type definitions and validation.
+AI can generate application code quickly. Frameworks can hide complexity nicely. But production applications still need explicit architecture.
 
-> **Note**: This project is in active development. APIs may change in future versions.
+In a typical full-stack application, the same domain model is repeated across many places:
 
-## ✨ Key Features
+- frontend form types
+- client-side validation
+- BFF request and response models
+- backend DTOs
+- API contracts
+- database entities
+- seed data
+- infrastructure and deployment configuration
 
-- **🔄 Zod Schema Sharing** - Keep Zod as the source of truth across frontend, BFF, Azure Functions, and Cosmos DB
-- **⚡ CRUD Code Generation** - Auto-generate Azure Functions + Next.js code with `swallowkit scaffold`
-- **🌐 Multi-language Functions Backends** - Choose TypeScript, C#, or Python for Azure Functions during `init`
-- **🧬 OpenAPI Schema Bridge** - For C#/Python backends, `scaffold` exports OpenAPI from Zod and generates backend schema assets
-- **🛡️ Contract Safety** - Keep frontend/BFF contracts aligned with backend implementations through shared Zod or generated OpenAPI-derived models
-- **🎯 BFF Pattern** - Next.js API Routes as BFF layer with auto-validation and resource inference
-- **☁️ Azure Optimized** - Minimal-cost architecture with Static Web Apps + Functions + Cosmos DB
-- **🚀 Easy Deployment** - Auto-generated Bicep IaC + CI/CD workflows
-- **🤖 AI-Friendly** - Auto-generated instruction files (`AGENTS.md`, `CLAUDE.md`, `.github/copilot-instructions.md`) and layer-specific rules help GitHub Copilot, Claude Code, and OpenAI Codex follow project conventions
+As the application grows, these layers often drift apart. SwallowKit reduces that drift by making the schema explicit and using it to generate the surrounding application structure.
 
-## 📚 Documentation
+**SwallowKit is not a full-stack framework that hides everything behind magic. It is a scaffolding toolkit that generates readable, editable, and replaceable code.**
 
-Visit the **[SwallowKit Documentation](https://himanago.github.io/swallowkit/)** for the full docs (also available in [日本語](https://himanago.github.io/swallowkit/ja/)).
+## ✨ What it gives you
 
-- **[CLI Reference](https://himanago.github.io/swallowkit/en/cli-reference)** - All commands in detail
-- **[Scaffold Guide](https://himanago.github.io/swallowkit/en/scaffold-guide)** - CRUD code generation
-- **[Zod Schema Sharing Guide](https://himanago.github.io/swallowkit/en/zod-schema-sharing-guide)** - Schema design
-- **[Deployment Guide](https://himanago.github.io/swallowkit/en/deployment-guide)** - Deploy to Azure
+- **Shared Zod schemas** as the source of truth
+- **CRUD scaffolding** for Next.js, BFF routes, Azure Functions, and UI components
+- **Azure-ready infrastructure** using Bicep
+- **Multi-language Azure Functions** backends (TypeScript, C#, Python)
+- **Local development helpers** and seed data
+- **AI/MCP-friendly** project metadata and commands
+- **VS Code extension** support
 
-## 🚀 Quick Start
+## 🏗️ Typical architecture
 
-### 1. Create Project
+SwallowKit is optimized for applications built with:
 
-```bash
-npx swallowkit init my-app
-# or
-pnpm dlx swallowkit init my-app
-cd my-app
-```
+- Next.js
+- Azure Static Web Apps
+- Azure Functions
+- Azure Cosmos DB
+- Azure Bicep
+- GitHub Actions or Azure Pipelines
 
-The interactive prompts ask for CI/CD provider, Azure Functions backend language, Cosmos DB mode, and network settings. You can also specify them as flags to skip prompts entirely:
+The default architecture follows a BFF pattern:
 
-```bash
-# Non-interactive mode (useful for VS Code extensions or automation)
-npx swallowkit init my-app --cicd github --backend-language python --cosmos-db-mode serverless --vnet outbound
 ```
+Browser
+  |
+Next.js frontend
+  |
+Next.js BFF routes
+  |
+Azure Functions API
+  |
+Azure Cosmos DB
+```
+
+The BFF layer keeps frontend code simple while allowing backend services, authentication, authorization, and cloud resources to evolve independently.
 
-| Flag | Values | Description |
-|------|--------|-------------|
-| `--cicd <provider>` | `github`, `azure`, `skip` | CI/CD provider |
-| `--backend-language <language>` | `typescript`, `csharp`, `python` | Azure Functions backend language |
-| `--cosmos-db-mode <mode>` | `freetier`, `serverless` | Cosmos DB pricing mode |
-| `--vnet <option>` | `outbound`, `none` | Network security |
+> **Note**: This project is in active development. APIs may change in future versions.
+
+## 📚 Documentation
 
-Omit any flag to be prompted for that value interactively.
+Visit the **[SwallowKit Documentation](https://himanago.github.io/swallowkit/)** for the full docs (also available in [日本語](https://himanago.github.io/swallowkit/ja/)).
+
+- **[Getting Started](https://himanago.github.io/swallowkit/en/getting-started)** - First project setup
+- **[Core Concepts](https://himanago.github.io/swallowkit/en/concepts)** - Schema-centric architecture
+- **[Scaffold Guide](https://himanago.github.io/swallowkit/en/scaffold-guide)** - CRUD code generation
+- **[Local Development](https://himanago.github.io/swallowkit/en/dev-guide)** - Dev server, seeds, mock connectors
+- **[Deployment Guide](https://himanago.github.io/swallowkit/en/deployment-guide)** - Deploy to Azure
+- **[AI / MCP Guide](https://himanago.github.io/swallowkit/en/ai-mcp-guide)** - AI-agent integration
+- **[Coding Agent Guide](https://himanago.github.io/swallowkit/en/coding-agent-guide)** - Lifecycle integration, ownership, and external process composition
+- **[Authentication](https://himanago.github.io/swallowkit/en/auth-guide)** - Auth and authorization
+- **[Connectors](https://himanago.github.io/swallowkit/en/connector-guide)** - External data sources
 
-### 2. Create Models
+## 🚀 Quick start
 
-You can create multiple models at once:
+Create a new project:
 
 ```bash
-npx swallowkit create-model category todo
-# or
-pnpm dlx swallowkit create-model category todo
+npx swallowkit init my-app
+cd my-app
 ```
 
-This generates `shared/models/category.ts` and `shared/models/todo.ts`. Customize them by adding your required fields:
+For pnpm 11/12: bootstrap with `pnpm dlx swallowkit init my-app`, then use `pnpm exec swallowkit …` inside the project. `npx` selects npm; `--package-manager npm|pnpm` overrides detection. Node.js 22.14+ is required. MCP intentionally uses `latest` with the selected package manager. See [commands, workspace setup, and security troubleshooting](docs/en/package-managers.md).
 
-```typescript
-// shared/models/category.ts
-import { z } from 'zod';
 
-export const category = z.object({
-  id: z.string(),
-  name: z.string().min(1).max(50),
-  createdAt: z.string().optional(),
-  updatedAt: z.string().optional(),
-});
+Create a model and customize the schema:
 
-export type Category = z.infer<typeof category>;
+```bash
+npx swallowkit create-model todo
 ```
 
-For parent-child relationships, use **nested schemas** instead of ID references:
-
 ```typescript
 // shared/models/todo.ts
 import { z } from 'zod';
-import { category } from './category';
 
 export const todo = z.object({
   id: z.string(),
   text: z.string().min(1).max(200),
   completed: z.boolean().default(false),
-  category: category.optional(),       // Nested object (not categoryId)
   createdAt: z.string().optional(),
   updatedAt: z.string().optional(),
 });
@@ -111,198 +118,40 @@ export const todo = z.object({
 export type Todo = z.infer<typeof todo>;
 ```
 
-> **Tip**: Nesting preserves type safety and stores related data together in the document, which is natural for Cosmos DB's document model.
-
-### 3. Generate CRUD Code
-
-```bash
-npx swallowkit scaffold shared/models/todo.ts
-# or
-pnpm dlx swallowkit scaffold shared/models/todo.ts
-```
-
-This auto-generates:
-- ✅ Azure Functions (CRUD endpoints + Cosmos DB bindings)
-- ✅ Next.js BFF API Routes (auto-validation + resource inference)
-- ✅ React Components (type-safe forms)
-
-If you selected `csharp` or `python` at `init` time, `swallowkit scaffold` also writes an OpenAPI document under `functions/openapi/` and generates backend schema assets under `functions/generated/`.
-
-### 4. Start Development Server
+Generate CRUD code and start the dev server:
 
 ```bash
+npx swallowkit scaffold todo
 npx swallowkit dev
-# or
-pnpm dlx swallowkit dev
-```
-
-- Next.js: http://localhost:3000
-- Azure Functions: http://localhost:7071
-
-If you want to replace Cosmos DB Emulator data before startup, generate an environment template and then launch `dev` with that environment:
-
-```bash
-npx swallowkit create-dev-seeds local
-# edit dev-seeds/local/*.json
-npx swallowkit dev --seed-env local
-```
-
-This workflow is designed for local debugging against the Cosmos DB Emulator:
-
-- `create-dev-seeds <environment>` generates one JSON template per schema under `dev-seeds/<environment>/`
-- each file name maps to a schema/container, for example `shared/models/todo.ts` -> `dev-seeds/local/todo.json` -> `Todos`
-- when you start `dev --seed-env <environment>`, SwallowKit replaces the existing data for each matching container with the JSON documents from that environment
-- containers without a matching JSON file are left untouched
-- if `--seed-env` is omitted, or `dev-seeds/<environment>/` does not exist, current emulator data is preserved
-
-Example file layout:
-
-```text
-dev-seeds/
-  local/
-    todo.json
-    category.json
-  staging-debug/
-    todo.json
-```
-
-Each `{schema}.json` file can contain either a single JSON object or an array of JSON objects. Every document must include an `id`:
-
-```json
-[
-  {
-    "id": "seed-todo-001",
-    "name": "Seed todo one",
-    "createdAt": "2026-03-21T00:00:00.000Z",
-    "updatedAt": "2026-03-21T00:00:00.000Z"
-  },
-  {
-    "id": "seed-todo-002",
-    "name": "Seed todo two",
-    "createdAt": "2026-03-21T00:00:01.000Z",
-    "updatedAt": "2026-03-21T00:00:01.000Z"
-  }
-]
-```
-
-Recommended workflow:
-
-```bash
-npx swallowkit create-model todo
-npx swallowkit scaffold shared/models/todo.ts
-npx swallowkit create-dev-seeds local
-# edit dev-seeds/local/todo.json
-npx swallowkit dev --seed-env local
-```
-
-### 5. Use from Frontend
-
-```typescript
-import { api } from '@/lib/api/backend';
-import type { Todo } from '@/shared/models/todo';
-
-// Get all - call BFF endpoint
-const todos = await api.get<Todo[]>('/api/todos');
-
-// Create - validated by backend
-const created = await api.post<Todo>('/api/todos', {
-  text: 'Buy milk',
-  completed: false
-});
-
-// Update - validated by backend
-const updated = await api.put<Todo>('/api/todos/123', { completed: true });
-
-// Delete
-await api.delete('/api/todos/123');
-```
-
-## 🏗️ Architecture
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  Frontend (React)                                            │
-│  - Client Components                                         │
-│  - Server Components (SSR)                                   │
-└──────────────────────────┬───────────────────────────────────┘
-                           │ api.post('/api/todos', data)
-                           ▼
-┌─────────────────────────────────────────────────────────────┐
-│  BFF Layer (Next.js API Routes)                              │
-│  - Auto Schema Validation (Zod)                              │
-│  - Error Handling                                            │
-└──────────────────────────┬───────────────────────────────────┘
-                           │ HTTP Request
-                           ▼
-┌─────────────────────────────────────────────────────────────┐
-│  Azure Functions (Backend)                                   │
-│  - HTTP Triggers (CRUD)                                      │
-│  - Zod Validation (Re-check)                                 │
-│  - Business Logic                                            │
-│  - Cosmos DB Bindings                                        │
-└──────────────────────────┬───────────────────────────────────┘
-                           │
-                           ▼
-┌─────────────────────────────────────────────────────────────┐
-│  Azure Cosmos DB                                             │
-│  - NoSQL Database                                            │
-│  - Zod Schema Validation                                     │
-└─────────────────────────────────────────────────────────────┘
 ```
 
-**Key Patterns:**
-- **BFF (Backend For Frontend)**: Next.js API Routes proxy to Azure Functions
-- **Shared Schemas**: Zod schemas stay in `shared/models/` as the source of truth
-- **OpenAPI Bridge for C#/Python**: Non-TypeScript Functions consume generated assets under `functions/generated/`
-- **Contract Safety**: BFF and backend stay aligned through shared Zod or generated backend models
-- **Managed Identity**: Secure service connections (no connection strings)
+This generates Azure Functions, Next.js BFF routes, and React UI components — all typed from the shared schema.
 
-## 📦 Prerequisites
+## 🤖 AI-agent-friendly development
 
-- Node.js 22.x
-- **pnpm** (recommended): `corepack enable` or `npm install -g pnpm`
-  - npm also works — SwallowKit auto-detects the package manager (if pnpm is installed, it is always preferred)
-- Azure Cosmos DB Emulator (local development)
-  - [Official documentation (vNext recommended)](https://learn.microsoft.com/en-us/azure/cosmos-db/emulator-linux)
-    - Windows: [Download](https://aka.ms/cosmosdb-emulator)
-    - Docker: `docker run -p 8081:8081 mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator`
+SwallowKit provides machine-readable project metadata and command interfaces so coding agents can inspect the project structure, generate code through official commands, and validate changes without directly rewriting unrelated files.
 
-## 🚀 Deploy to Azure
+The goal is to make AI-assisted development safer by giving agents explicit architectural boundaries.
 
-Deploy your Next.js app to Azure Static Web Apps using standalone mode, and connect to independent Azure Functions for backend operations.
+## 📦 Generated project structure
 
-**1. Provision resources (Bicep IaC)**
-
-```bash
-npx swallowkit provision --resource-group my-app-rg --location japaneast
-# or
-pnpm dlx swallowkit provision --resource-group my-app-rg --location japaneast
 ```
-
-After provisioning, the required CI/CD secret values are displayed in the terminal. Copy them.
-
-**2. Push code**
-
-```bash
-git push origin main
+.
+├── app/                  # Next.js pages and BFF API routes
+├── shared/
+│   └── models/           # Shared Zod schemas (source of truth)
+├── functions/            # Azure Functions backend
+├── infra/                # Bicep templates
+├── lib/                  # BFF helpers and scaffold config
+└── .swallowkit/          # SwallowKit project metadata
 ```
 
-**3. Cancel the auto-triggered CI/CD run** — it will fail because secrets are not registered yet.
-
-**4. Register the displayed secret values** in GitHub (Settings → Secrets) or Azure DevOps (Pipelines → Library).
+## 🔗 Status
 
-**5. Manually re-run the CI/CD workflow.**
+SwallowKit is under active development. The API, project structure, and generated output may change.
 
-See **[Deployment Guide](https://himanago.github.io/swallowkit/en/deployment-guide)** for details.
+Feedback, issues, and small example use cases are welcome.
 
-##  License
+## 📄 License
 
 MIT
-
-## 🔗 Related Links
-
-- [Azure Static Web Apps](https://learn.microsoft.com/en-us/azure/static-web-apps/)
-- [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/)
-- [Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/cosmos-db/)
-- [Next.js](https://nextjs.org/)
-- [Zod](https://zod.dev/)

package/dist/__tests__/fixtures.d.ts

@@ -3,10 +3,22 @@ import { ModelInfo } from "../core/scaffold/model-parser";
  * テスト用の基本的な ModelInfo フィクスチャ
  */
 export declare function createBasicModelInfo(overrides?: Partial<ModelInfo>): ModelInfo;
+/**
+ * RDB コネクタ (read-only) 付きの ModelInfo フィクスチャ
+ */
+export declare function createRdbConnectorModelInfo(overrides?: Partial<ModelInfo>): ModelInfo;
+/**
+ * API コネクタ (read-write) 付きの ModelInfo フィクスチャ
+ */
+export declare function createApiConnectorModelInfo(overrides?: Partial<ModelInfo>): ModelInfo;
 /**
  * 外部キーを含む ModelInfo フィクスチャ
  */
 export declare function createModelInfoWithForeignKey(): ModelInfo;
+/**
+ * 必須・optional・nullable の外部キーを含む ModelInfo フィクスチャ
+ */
+export declare function createModelInfoWithNullableForeignKeys(): ModelInfo;
 /**
  * enum フィールドを含む ModelInfo フィクスチャ
  */

package/dist/__tests__/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/__tests__/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAoB9E;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,SAAS,CAqBzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,CA0BnD"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/__tests__/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAqB9E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAuBrF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CA2BrF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,SAAS,CAqBzD;AAED;;GAEG;AACH,wBAAgB,sCAAsC,IAAI,SAAS,CAmClE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,CA0BnD"}

package/dist/__tests__/fixtures.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBasicModelInfo = createBasicModelInfo;
+exports.createRdbConnectorModelInfo = createRdbConnectorModelInfo;
+exports.createApiConnectorModelInfo = createApiConnectorModelInfo;
 exports.createModelInfoWithForeignKey = createModelInfoWithForeignKey;
+exports.createModelInfoWithNullableForeignKeys = createModelInfoWithNullableForeignKeys;
 exports.createModelInfoWithEnum = createModelInfoWithEnum;
 /**
  * テスト用の基本的な ModelInfo フィクスチャ
@@ -24,9 +27,68 @@ function createBasicModelInfo(overrides) {
         hasCreatedAt: true,
         hasUpdatedAt: true,
         nestedSchemaRefs: [],
+        partitionKey: '/id',
         ...overrides,
     };
 }
+/**
+ * RDB コネクタ (read-only) 付きの ModelInfo フィクスチャ
+ */
+function createRdbConnectorModelInfo(overrides) {
+    return createBasicModelInfo({
+        name: "User",
+        displayName: "User",
+        schemaName: "userSchema",
+        filePath: "/models/user.ts",
+        fields: [
+            { name: "id", type: "string", isOptional: false, isArray: false },
+            { name: "employeeCode", type: "string", isOptional: false, isArray: false },
+            { name: "name", type: "string", isOptional: false, isArray: false },
+            { name: "email", type: "string", isOptional: false, isArray: false },
+            { name: "department", type: "string", isOptional: true, isArray: false },
+            { name: "createdAt", type: "string", isOptional: true, isArray: false },
+            { name: "updatedAt", type: "string", isOptional: true, isArray: false },
+        ],
+        connectorConfig: {
+            connector: "mysql",
+            operations: ["getAll", "getById"],
+            table: "users",
+            idColumn: "id",
+        },
+        ...overrides,
+    });
+}
+/**
+ * API コネクタ (read-write) 付きの ModelInfo フィクスチャ
+ */
+function createApiConnectorModelInfo(overrides) {
+    return createBasicModelInfo({
+        name: "BacklogIssue",
+        displayName: "BacklogIssue",
+        schemaName: "backlogIssueSchema",
+        filePath: "/models/backlog-issue.ts",
+        fields: [
+            { name: "id", type: "string", isOptional: false, isArray: false },
+            { name: "projectId", type: "string", isOptional: false, isArray: false },
+            { name: "issueKey", type: "string", isOptional: false, isArray: false },
+            { name: "summary", type: "string", isOptional: false, isArray: false },
+            { name: "description", type: "string", isOptional: true, isArray: false },
+            { name: "createdAt", type: "string", isOptional: true, isArray: false },
+            { name: "updatedAt", type: "string", isOptional: true, isArray: false },
+        ],
+        connectorConfig: {
+            connector: "backlog",
+            operations: ["getAll", "getById", "create", "update"],
+            endpoints: {
+                getAll: "GET /issues",
+                getById: "GET /issues/{id}",
+                create: "POST /issues",
+                update: "PATCH /issues/{id}",
+            },
+        },
+        ...overrides,
+    });
+}
 /**
  * 外部キーを含む ModelInfo フィクスチャ
  */
@@ -52,6 +114,45 @@ function createModelInfoWithForeignKey() {
         ],
     });
 }
+/**
+ * 必須・optional・nullable の外部キーを含む ModelInfo フィクスチャ
+ */
+function createModelInfoWithNullableForeignKeys() {
+    return createBasicModelInfo({
+        name: "Coupon",
+        displayName: "Coupon",
+        schemaName: "couponSchema",
+        filePath: "/models/coupon.ts",
+        fields: [
+            { name: "id", type: "string", isOptional: false, isArray: false },
+            {
+                name: "requiredUserId",
+                type: "string",
+                isOptional: false,
+                isArray: false,
+                isForeignKey: true,
+                referencedModel: "RequiredUser",
+            },
+            {
+                name: "optionalUserId",
+                type: "string",
+                isOptional: true,
+                isArray: false,
+                isForeignKey: true,
+                referencedModel: "OptionalUser",
+            },
+            {
+                name: "nullableUserId",
+                type: "string",
+                isOptional: false,
+                isNullable: true,
+                isArray: false,
+                isForeignKey: true,
+                referencedModel: "NullableUser",
+            },
+        ],
+    });
+}
 /**
  * enum フィールドを含む ModelInfo フィクスチャ
  */

package/dist/__tests__/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/__tests__/fixtures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/__tests__/fixtures.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/add-auth.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SwallowKit Add-Auth コマンド
+ * 認証認可基盤ファイルを生成する
+ */
+interface AddAuthOptions {
+    provider?: string;
+    scheme?: string;
+    /** SWA の許可する identity provider (例: ['github'])。未指定時は ['aad']。 */
+    allowedProviders?: string[];
+}
+export declare function generateSwaAuthContext(allowedProviders?: string[]): string;
+export declare function addAuthProviderToRootLayout(layout: string): string;
+export declare function addAuthCommand(options: AddAuthOptions): Promise<void>;
+export {};
+//# sourceMappingURL=add-auth.d.ts.map

package/dist/cli/commands/add-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-auth.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+CH,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AA8HD,wBAAgB,sBAAsB,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA0C1E;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAclE;AAwBD,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,iBAoJ3D"}