swallowkit 1.0.0-beta.6 → 1.0.0-beta.60

package/src/__tests__/file-session.test.ts

@@ -0,0 +1,98 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import {
+  FileOperationSession,
+  hashContent,
+  runWithFileSession,
+  getActiveFileSession,
+} from "../core/operations/file-session";
+
+describe("FileOperationSession", () => {
+  let tempDir: string;
+
+  beforeEach(() => {
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "swallowkit-session-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it("writes files to disk in commit mode and records create operations", () => {
+    const session = new FileOperationSession("commit", tempDir);
+    const target = path.join(tempDir, "nested", "dir", "file.ts");
+
+    const op = session.writeFile(target, "export const a = 1;\n", {
+      ownership: "managed",
+      generator: "scaffold",
+      sourceModel: "Todo",
+    });
+
+    expect(fs.readFileSync(target, "utf-8")).toBe("export const a = 1;\n");
+    expect(op.action).toBe("create");
+    expect(op.path).toBe("nested/dir/file.ts");
+    expect(op.previousHash).toBeNull();
+    expect(op.newHash).toBe(hashContent("export const a = 1;\n"));
+  });
+
+  it("does not touch the disk in collect mode", () => {
+    const session = new FileOperationSession("collect", tempDir);
+    const target = path.join(tempDir, "virtual.ts");
+
+    session.writeFile(target, "content", { ownership: "managed", generator: "scaffold" });
+
+    expect(fs.existsSync(target)).toBe(false);
+    expect(session.operations).toHaveLength(1);
+    expect(session.operations[0].action).toBe("create");
+    // overlay read-back
+    expect(session.readFile(target)).toBe("content");
+    expect(session.fileExists(target)).toBe(true);
+  });
+
+  it("records skip when content is unchanged", () => {
+    const target = path.join(tempDir, "same.ts");
+    fs.writeFileSync(target, "unchanged\n", "utf-8");
+
+    const session = new FileOperationSession("commit", tempDir);
+    const op = session.writeFile(target, "unchanged\n", { ownership: "managed", generator: "scaffold" });
+
+    expect(op.action).toBe("skip");
+  });
+
+  it("records append for extension-point modifications and modify for managed", () => {
+    const extensionTarget = path.join(tempDir, "ext.ts");
+    const managedTarget = path.join(tempDir, "managed.ts");
+    fs.writeFileSync(extensionTarget, "base\n", "utf-8");
+    fs.writeFileSync(managedTarget, "base\n", "utf-8");
+
+    const session = new FileOperationSession("commit", tempDir);
+    const appendOp = session.writeFile(extensionTarget, "base\nmore\n", {
+      ownership: "extension-point",
+      generator: "scaffold",
+    });
+    const modifyOp = session.writeFile(managedTarget, "regenerated\n", {
+      ownership: "managed",
+      generator: "scaffold",
+    });
+
+    expect(appendOp.action).toBe("append");
+    expect(modifyOp.action).toBe("modify");
+    expect(modifyOp.previousHash).toBe(hashContent("base\n"));
+  });
+
+  it("normalizes CRLF for hashing", () => {
+    expect(hashContent("a\r\nb\r\n")).toBe(hashContent("a\nb\n"));
+  });
+
+  it("scopes the active session with runWithFileSession", async () => {
+    expect(getActiveFileSession()).toBeNull();
+    const session = new FileOperationSession("collect", tempDir);
+
+    await runWithFileSession(session, async () => {
+      expect(getActiveFileSession()).toBe(session);
+    });
+
+    expect(getActiveFileSession()).toBeNull();
+  });
+});

package/src/__tests__/fixtures.ts

@@ -0,0 +1,184 @@
+import { ModelInfo } from "../core/scaffold/model-parser";
+
+/**
+ * テスト用の基本的な ModelInfo フィクスチャ
+ */
+export function createBasicModelInfo(overrides?: Partial<ModelInfo>): ModelInfo {
+  return {
+    name: "Todo",
+    displayName: "Todo",
+    schemaName: "todoSchema",
+    filePath: "/models/todo.ts",
+    fields: [
+      { name: "id", type: "string", isOptional: false, isArray: false },
+      { name: "title", type: "string", isOptional: false, isArray: false },
+      { name: "description", type: "string", isOptional: true, isArray: false },
+      { name: "completed", type: "boolean", isOptional: false, isArray: false },
+      { name: "createdAt", type: "string", isOptional: false, isArray: false },
+      { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+    ],
+    hasId: true,
+    hasCreatedAt: true,
+    hasUpdatedAt: true,
+    nestedSchemaRefs: [],
+    partitionKey: '/id',
+    ...overrides,
+  };
+}
+
+/**
+ * RDB コネクタ (read-only) 付きの ModelInfo フィクスチャ
+ */
+export function createRdbConnectorModelInfo(overrides?: Partial<ModelInfo>): ModelInfo {
+  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 フィクスチャ
+ */
+export function createApiConnectorModelInfo(overrides?: Partial<ModelInfo>): ModelInfo {
+  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 フィクスチャ
+ */
+export function createModelInfoWithForeignKey(): ModelInfo {
+  return createBasicModelInfo({
+    name: "Task",
+    displayName: "Task",
+    schemaName: "taskSchema",
+    filePath: "/models/task.ts",
+    fields: [
+      { name: "id", type: "string", isOptional: false, isArray: false },
+      { name: "title", type: "string", isOptional: false, isArray: false },
+      {
+        name: "categoryId",
+        type: "string",
+        isOptional: false,
+        isArray: false,
+        isForeignKey: true,
+        referencedModel: "Category",
+      },
+      { name: "createdAt", type: "string", isOptional: false, isArray: false },
+      { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+    ],
+  });
+}
+
+/**
+ * 必須・optional・nullable の外部キーを含む ModelInfo フィクスチャ
+ */
+export function createModelInfoWithNullableForeignKeys(): ModelInfo {
+  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 フィクスチャ
+ */
+export function createModelInfoWithEnum(): ModelInfo {
+  return createBasicModelInfo({
+    name: "Issue",
+    displayName: "Issue",
+    schemaName: "issueSchema",
+    filePath: "/models/issue.ts",
+    fields: [
+      { name: "id", type: "string", isOptional: false, isArray: false },
+      { name: "title", type: "string", isOptional: false, isArray: false },
+      {
+        name: "status",
+        type: "string",
+        isOptional: false,
+        isArray: false,
+        enumValues: ["open", "in_progress", "closed"],
+      },
+      {
+        name: "priority",
+        type: "number",
+        isOptional: true,
+        isArray: false,
+      },
+      { name: "createdAt", type: "string", isOptional: false, isArray: false },
+      { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+    ],
+  });
+}

package/src/__tests__/functions-generator.test.ts

@@ -0,0 +1,237 @@
+import {
+  generateCSharpAzureFunctionsCRUD,
+  generateCompactAzureFunctionsCRUD,
+  generatePythonAzureFunctionsCRUD,
+} from "../core/scaffold/functions-generator";
+import { createBasicModelInfo, createModelInfoWithEnum } from "./fixtures";
+
+describe("generateCompactAzureFunctionsCRUD", () => {
+  it("generates correct CRUD code for a basic model", () => {
+    const model = createBasicModelInfo();
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toMatchSnapshot();
+  });
+
+  it("generates correct CRUD code for a model with enum fields", () => {
+    const model = createModelInfoWithEnum();
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toMatchSnapshot();
+  });
+
+  it("imports the correct schema from shared package", () => {
+    const model = createBasicModelInfo();
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toContain("import { todoSchema } from '@myapp/shared'");
+  });
+
+  it("uses correct container name (PascalCase + s)", () => {
+    const model = createBasicModelInfo();
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toContain("const containerName = 'Todos'");
+  });
+
+  it("registers correct route names (camelCase)", () => {
+    const model = createBasicModelInfo();
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toContain("'todo-get-all'");
+    expect(code).toContain("'todo-get-by-id'");
+    expect(code).toContain("'todo-create'");
+    expect(code).toContain("'todo-update'");
+    expect(code).toContain("'todo-delete'");
+  });
+
+  it("generates all CRUD HTTP methods", () => {
+    const model = createBasicModelInfo();
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toContain("methods: ['GET']");
+    expect(code).toContain("methods: ['POST']");
+    expect(code).toContain("methods: ['PUT']");
+    expect(code).toContain("methods: ['DELETE']");
+  });
+
+  it("uses correct route patterns", () => {
+    const model = createBasicModelInfo();
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toContain("route: 'todo'");
+    expect(code).toContain("route: 'todo/{id}'");
+  });
+
+  it("handles multi-word model names correctly", () => {
+    const model = createBasicModelInfo({
+      name: "TodoItem",
+      schemaName: "todoItemSchema",
+    });
+    const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+    expect(code).toContain("const containerName = 'TodoItems'");
+    expect(code).toContain("route: 'todoItem'");
+    expect(code).toContain("'todoItem-get-all'");
+  });
+
+  it("generates C# Cosmos-backed CRUD handlers", () => {
+    const model = createBasicModelInfo();
+    const code = generateCSharpAzureFunctionsCRUD(model);
+    expect(code).toContain("public sealed class TodoCrudFunctions");
+    expect(code).toContain('[Function("todoGetAll")]');
+    expect(code).toContain('Route = "todo/{id}"');
+    expect(code).toContain("CreateCosmosClient()");
+    expect(code).toContain('new CosmosClientOptions { ConnectionMode = ConnectionMode.Gateway }');
+    expect(code).toContain('endpoint.Contains("localhost:8081", StringComparison.OrdinalIgnoreCase)');
+    expect(code).toContain("container.ReadItemStreamAsync");
+    expect(code).toContain("JsonNode.Parse(document.RootElement.GetRawText())?.AsObject()");
+    expect(code).toContain("container.CreateItemStreamAsync");
+    expect(code).toContain("container.ReplaceItemStreamAsync");
+    expect(code).toContain("payload.ToJsonString()");
+    expect(code).toContain("container.DeleteItemAsync<JsonObject>");
+  });
+
+  it("generates Python Cosmos-backed CRUD handlers", () => {
+    const model = createBasicModelInfo();
+    const generated = generatePythonAzureFunctionsCRUD(model);
+    expect(generated.registration).toContain("from blueprints.todo import bp as todo_bp");
+    expect(generated.registration).toContain("app.register_blueprint(todo_bp)");
+    expect(generated.blueprint).toContain('@bp.route(route="todo", methods=["GET"])');
+    expect(generated.blueprint).toContain("def todo_create");
+    expect(generated.blueprint).toContain("from azure.cosmos import CosmosClient, exceptions");
+    expect(generated.blueprint).toContain("container.query_items");
+    expect(generated.blueprint).toContain("container.read_item");
+    expect(generated.blueprint).toContain("container.create_item");
+    expect(generated.blueprint).toContain("container.replace_item");
+    expect(generated.blueprint).toContain("container.delete_item");
+  });
+
+  // --- Custom Partition Key Tests ---
+
+  describe("custom partition key (TS)", () => {
+    it("uses input binding when partitionKey is /id (default)", () => {
+      const model = createBasicModelInfo({ partitionKey: "/id" });
+      const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+      expect(code).toContain("partitionKey: '{id}'");
+      expect(code).toContain("container.item(id, id).delete()");
+    });
+
+    it("uses SDK direct call when partitionKey is not /id", () => {
+      const model = createBasicModelInfo({
+        partitionKey: "/tenantId",
+        fields: [
+          { name: "id", type: "string", isOptional: false, isArray: false },
+          { name: "tenantId", type: "string", isOptional: false, isArray: false },
+          { name: "title", type: "string", isOptional: false, isArray: false },
+          { name: "createdAt", type: "string", isOptional: false, isArray: false },
+          { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+        ],
+      });
+      const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+
+      // Should NOT have input binding with partitionKey
+      expect(code).not.toContain("partitionKey: '{id}'");
+      // getById should use SDK query
+      expect(code).toContain("custom partition key");
+      expect(code).toContain("SELECT * FROM c WHERE c.id = @id");
+      // delete should read doc first to get PK value
+      expect(code).toContain("resources[0].tenantId");
+      expect(code).toContain("container.item(id, pkValue).delete()");
+    });
+
+    it("generates snapshot for custom partition key TS", () => {
+      const model = createBasicModelInfo({
+        partitionKey: "/tenantId",
+        fields: [
+          { name: "id", type: "string", isOptional: false, isArray: false },
+          { name: "tenantId", type: "string", isOptional: false, isArray: false },
+          { name: "title", type: "string", isOptional: false, isArray: false },
+          { name: "createdAt", type: "string", isOptional: false, isArray: false },
+          { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+        ],
+      });
+      const code = generateCompactAzureFunctionsCRUD(model, "@myapp/shared");
+      expect(code).toMatchSnapshot();
+    });
+  });
+
+  describe("custom partition key (C#)", () => {
+    it("uses ReadItemStreamAsync when partitionKey is /id", () => {
+      const model = createBasicModelInfo({ partitionKey: "/id" });
+      const code = generateCSharpAzureFunctionsCRUD(model);
+      expect(code).toContain("ReadItemStreamAsync(id, new PartitionKey(id))");
+      expect(code).toContain("DeleteItemAsync<JsonObject>(id, new PartitionKey(id))");
+    });
+
+    it("uses query when partitionKey is not /id", () => {
+      const model = createBasicModelInfo({
+        partitionKey: "/tenantId",
+        fields: [
+          { name: "id", type: "string", isOptional: false, isArray: false },
+          { name: "tenantId", type: "string", isOptional: false, isArray: false },
+          { name: "title", type: "string", isOptional: false, isArray: false },
+          { name: "createdAt", type: "string", isOptional: false, isArray: false },
+          { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+        ],
+      });
+      const code = generateCSharpAzureFunctionsCRUD(model);
+      // ReadCosmosItemAsync should use query instead of point read
+      expect(code).toContain("GetItemQueryStreamIterator(query)");
+      expect(code).not.toContain("ReadItemStreamAsync(id, new PartitionKey(id))");
+      // Delete should read doc first for PK value
+      expect(code).toContain('existing["tenantId"]');
+    });
+
+    it("generates snapshot for custom partition key C#", () => {
+      const model = createBasicModelInfo({
+        partitionKey: "/tenantId",
+        fields: [
+          { name: "id", type: "string", isOptional: false, isArray: false },
+          { name: "tenantId", type: "string", isOptional: false, isArray: false },
+          { name: "title", type: "string", isOptional: false, isArray: false },
+          { name: "createdAt", type: "string", isOptional: false, isArray: false },
+          { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+        ],
+      });
+      const code = generateCSharpAzureFunctionsCRUD(model);
+      expect(code).toMatchSnapshot();
+    });
+  });
+
+  describe("custom partition key (Python)", () => {
+    it("uses read_item with partition_key=item_id when partitionKey is /id", () => {
+      const model = createBasicModelInfo({ partitionKey: "/id" });
+      const generated = generatePythonAzureFunctionsCRUD(model);
+      expect(generated.blueprint).toContain("partition_key=item_id");
+    });
+
+    it("uses cross-partition query when partitionKey is not /id", () => {
+      const model = createBasicModelInfo({
+        partitionKey: "/tenantId",
+        fields: [
+          { name: "id", type: "string", isOptional: false, isArray: false },
+          { name: "tenantId", type: "string", isOptional: false, isArray: false },
+          { name: "title", type: "string", isOptional: false, isArray: false },
+          { name: "createdAt", type: "string", isOptional: false, isArray: false },
+          { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+        ],
+      });
+      const generated = generatePythonAzureFunctionsCRUD(model);
+      // Should not use direct read_item with partition_key=item_id
+      expect(generated.blueprint).not.toContain("partition_key=item_id");
+      // Should use cross-partition query
+      expect(generated.blueprint).toContain("enable_cross_partition_query=True");
+      expect(generated.blueprint).toContain('SELECT * FROM c WHERE c.id = @id');
+      // Delete should get PK value from document
+      expect(generated.blueprint).toContain('.get("tenantId")');
+    });
+
+    it("generates snapshot for custom partition key Python", () => {
+      const model = createBasicModelInfo({
+        partitionKey: "/tenantId",
+        fields: [
+          { name: "id", type: "string", isOptional: false, isArray: false },
+          { name: "tenantId", type: "string", isOptional: false, isArray: false },
+          { name: "title", type: "string", isOptional: false, isArray: false },
+          { name: "createdAt", type: "string", isOptional: false, isArray: false },
+          { name: "updatedAt", type: "string", isOptional: false, isArray: false },
+        ],
+      });
+      const generated = generatePythonAzureFunctionsCRUD(model);
+      expect(generated.blueprint).toMatchSnapshot();
+    });
+  });
+});