create-windy 0.3.4 → 0.3.5

package/template/packages/database/drizzle/meta/_journal.json

@@ -295,6 +295,13 @@
       "when": 1785102272102,
       "tag": "0041_yummy_prowler",
       "breakpoints": true
+    },
+    {
+      "idx": 42,
+      "version": "7",
+      "when": 1785151819729,
+      "tag": "0042_puzzling_rumiko_fujikawa",
+      "breakpoints": true
     }
   ]
 }

package/template/packages/database/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/database",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/database/src/schema/durable-jobs.ts

@@ -205,6 +205,7 @@ export const durableJobArtifacts = pgTable(
     byteSize: integer("byte_size").notNull(),
     sha256: varchar("sha256", { length: 64 }).notNull(),
     ownerId: varchar("owner_id", { length: 64 }).notNull(),
+    metadata: jsonb("metadata").$type<Record<string, unknown>>(),
     expiresAt: timestamp("expires_at", { withTimezone: true }),
     createdAt: timestamp("created_at", { withTimezone: true })
       .notNull()

package/template/packages/database/src/schema/governed-exports.ts

@@ -17,6 +17,18 @@ export interface GovernedExportQuerySnapshot {
   readonly [key: string]: JsonValue | undefined;
 }
 
+export interface GovernedExportRendererSnapshot {
+  formatKey: string;
+  templateKey: string;
+  templateVersion: string;
+  inputSchemaKey: string;
+  contentType: string;
+  filenameExtension: string;
+  maxRecords: number;
+  maxOutputBytes: number;
+  timeoutSeconds: number;
+}
+
 export const governedExportRequests = pgTable(
   "governed_export_requests",
   {
@@ -39,6 +51,9 @@ export const governedExportRequests = pgTable(
     querySnapshot: jsonb("query_snapshot")
       .$type<GovernedExportQuerySnapshot>()
       .notNull(),
+    renderer: jsonb("renderer")
+      .$type<GovernedExportRendererSnapshot>()
+      .notNull(),
     status: varchar("status", { length: 32 }).notNull(),
     approvalRequired: boolean("approval_required").notNull(),
     approvalId: varchar("approval_id", { length: 64 }),

package/template/packages/database/src/schema-governed-exports.test.ts

@@ -1,6 +1,9 @@
 import { describe, expect, test } from "bun:test";
 import { getTableConfig } from "drizzle-orm/pg-core";
-import { governedExportRequests } from "./schema/index.js";
+import {
+  durableJobArtifacts,
+  governedExportRequests,
+} from "./schema/index.js";
 
 describe("governed export schema", () => {
   test("申请以 owner/resource/idempotency 唯一并受 Durable Job 外键约束", async () => {
@@ -9,6 +12,7 @@ describe("governed export schema", () => {
     expect(config.name).toBe("governed_export_requests");
     expect(governedExportRequests.scopeSnapshot.notNull).toBe(true);
     expect(governedExportRequests.requestFingerprint.notNull).toBe(true);
+    expect(governedExportRequests.renderer.notNull).toBe(true);
     expect(governedExportRequests.durableJobId.notNull).toBe(false);
     expect(config.foreignKeys[0]?.onDelete).toBe("restrict");
     expect(
@@ -45,5 +49,21 @@ describe("governed export schema", () => {
     expect(constraintMigration).toContain(
       'VALIDATE CONSTRAINT "ck_governed_exports_approval_job_state"',
     );
+    const rendererMigration = await Bun.file(
+      new URL(
+        "../drizzle/0042_puzzling_rumiko_fujikawa.sql",
+        import.meta.url,
+      ),
+    ).text();
+    expect(rendererMigration).toContain(
+      'UPDATE "governed_export_requests"',
+    );
+    expect(rendererMigration).toContain(
+      'ALTER COLUMN "renderer" SET NOT NULL',
+    );
+    expect(rendererMigration).toContain(
+      'UPDATE "durable_job_artifacts" AS artifact',
+    );
+    expect(durableJobArtifacts.metadata.notNull).toBe(false);
   });
 });

package/template/packages/jobs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/jobs",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/jobs/src/handlers.ts

@@ -25,6 +25,7 @@ export interface DurableHandlerContext {
     sha256: string;
     ownerId: string;
     expiresAt?: string;
+    metadata?: Record<string, unknown>;
   }): Promise<void>;
 }
 

package/template/packages/jobs/src/types.ts

@@ -110,6 +110,7 @@ export interface DurableJobArtifact {
   sha256: string;
   ownerId: string;
   expiresAt?: string;
+  metadata?: Record<string, unknown>;
   createdAt: string;
 }
 

package/template/packages/modules/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/modules",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/server-sdk/index.ts

@@ -23,20 +23,31 @@ export type {
   ModuleAuditTarget,
 } from "./src/audit-port.js";
 export type {
+  ModuleJobCancelInput,
+  ModuleJobControlErrorCode,
+  ModuleJobPort,
+  ModuleJobProgressView,
+  ModuleJobRecoverInput,
+  ModuleJobStatus,
   ModuleJobSubmitter,
   ModuleJobSubmitInput,
   ModuleJobSubmitResult,
+  ModuleJobView,
 } from "./src/jobs-port.js";
+export { ModuleJobControlError } from "./src/jobs-port.js";
 export type {
   ModuleDurableHandlerContext,
   ModuleDurableHandlerDefinition,
   ModuleDurableStoragePort,
 } from "./src/durable-handler.js";
 export type {
+  GovernedExportRenderedArtifact,
+  GovernedExportWatermarkContext,
   ModuleGovernedExportPage,
   ModuleGovernedExportPageInput,
   ModuleGovernedExportQuery,
   ModuleGovernedExportRegistration,
+  ModuleGovernedExportRendererRegistration,
   ModuleGovernedRecord,
   ModuleGovernedResourceContext,
   ModuleGovernedResourceRegistration,

package/template/packages/server-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/server-sdk",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/template/packages/server-sdk/src/data-governance-registration.ts

@@ -30,6 +30,47 @@ export interface ModuleGovernedExportPage {
   readonly nextCursor?: string;
 }
 
+export interface GovernedExportWatermarkContext {
+  readonly actorId: string;
+  readonly generatedAt: string;
+  readonly scopeHash: string;
+  readonly jobId: string;
+  readonly requestId: string;
+}
+
+export interface GovernedExportRenderedArtifact {
+  readonly body: ReadableStream<Uint8Array>;
+  /** 不得包含记录原文或敏感字段，仅用于受控 artifact 元数据与审计。 */
+  readonly contentMetadata?: Readonly<Record<string, JsonValue>>;
+}
+
+export interface ModuleGovernedExportRendererRegistration {
+  readonly formatKey: string;
+  readonly templateKey: string;
+  readonly templateVersion: string;
+  readonly inputSchemaKey: string;
+  readonly contentType: string;
+  /** 不含点号，例如 pdf、docx、xlsx。 */
+  readonly filenameExtension: string;
+  readonly limits: {
+    readonly maxRecords: number;
+    readonly maxOutputBytes: number;
+    readonly timeoutSeconds: number;
+  };
+  render(
+    input: {
+      readonly records: AsyncIterable<Readonly<Record<string, JsonValue>>>;
+      readonly watermark: GovernedExportWatermarkContext;
+    },
+    context: {
+      readonly signal: AbortSignal;
+      readonly heartbeat: () => Promise<void>;
+    },
+  ):
+    | Promise<GovernedExportRenderedArtifact>
+    | GovernedExportRenderedArtifact;
+}
+
 export interface ModuleGovernedExportRegistration {
   /** 四个导出端点的基路径，例如 /api/people/persons/exports。 */
   readonly basePath: string;
@@ -37,6 +78,11 @@ export interface ModuleGovernedExportRegistration {
   readonly approvalRequired?: boolean;
   /** 产物保留时间；宿主还会施加平台上限。 */
   readonly retentionSeconds?: number;
+  /**
+   * 服务端受治理 Renderer。声明后请求必须显式选择已注册 formatKey；
+   * 未声明时保持既有 NDJSON 行为。
+   */
+  readonly renderers?: readonly ModuleGovernedExportRendererRegistration[];
   validateQuery(query: unknown): ModuleGovernedExportQuery;
   readPage(
     input: ModuleGovernedExportPageInput,

package/template/packages/server-sdk/src/jobs-port.ts

@@ -22,3 +22,72 @@ export interface ModuleJobSubmitResult {
 export interface ModuleJobSubmitter {
   submit(input: ModuleJobSubmitInput): Promise<ModuleJobSubmitResult>;
 }
+
+export type ModuleJobStatus =
+  | "queued"
+  | "running"
+  | "succeeded"
+  | "failed"
+  | "cancelled";
+
+export interface ModuleJobProgressView {
+  readonly completedUnits: number;
+  readonly totalUnits?: number;
+}
+
+export interface ModuleJobView {
+  readonly jobId: string;
+  readonly handlerKey: string;
+  readonly status: ModuleJobStatus;
+  readonly progress?: ModuleJobProgressView;
+  readonly attempt: number;
+  readonly maxAttempts: number;
+  readonly createdAt: string;
+  readonly startedAt?: string;
+  readonly finishedAt?: string;
+  readonly failureCode?: string;
+  readonly canCancel: boolean;
+  readonly canRecover: boolean;
+  /** 当前持久化版本；控制操作必须回传该值以执行 CAS。 */
+  readonly version: string;
+}
+
+export interface ModuleJobCancelInput {
+  readonly jobId: string;
+  readonly reason: string;
+  readonly expectedStatus?: ModuleJobStatus;
+  readonly expectedVersion?: string;
+}
+
+export interface ModuleJobRecoverInput {
+  readonly jobId: string;
+  readonly reason: string;
+  readonly expectedAttempt: number;
+  readonly expectedStatus: ModuleJobStatus;
+  readonly expectedVersion: string;
+}
+
+export type ModuleJobControlErrorCode =
+  | "JOB_NOT_AVAILABLE"
+  | "JOB_STATE_CONFLICT"
+  | "JOB_CONTROL_UNAVAILABLE"
+  | "JOB_REASON_INVALID";
+
+export class ModuleJobControlError extends Error {
+  constructor(
+    readonly code: ModuleJobControlErrorCode,
+    message: string,
+  ) {
+    super(message);
+    this.name = "ModuleJobControlError";
+  }
+}
+
+/**
+ * 宿主绑定 Module、Queue、Actor 与授权范围的 Durable Job 受限控制 Port。
+ */
+export interface ModuleJobPort extends ModuleJobSubmitter {
+  get(jobId: string): Promise<ModuleJobView | undefined>;
+  cancel(input: ModuleJobCancelInput): Promise<ModuleJobView>;
+  recover(input: ModuleJobRecoverInput): Promise<ModuleJobView>;
+}

package/template/packages/server-sdk/src/request-context.ts

@@ -2,7 +2,7 @@ import type { ModuleActor } from "./actor.js";
 import type { ModuleAuditEmitter } from "./audit-port.js";
 import type { ModuleAiArtifactPort } from "./ai-artifact-port.js";
 import type { ModuleAiOperationPort } from "./ai-operation-port.js";
-import type { ModuleJobSubmitter } from "./jobs-port.js";
+import type { ModuleJobPort } from "./jobs-port.js";
 import type { ModuleStoragePort } from "./storage-port.js";
 import type { ModuleUserDirectoryPort } from "./user-directory-port.js";
 
@@ -21,7 +21,7 @@ export interface ModuleRequestContext {
   readonly audit: ModuleAuditEmitter;
   readonly aiArtifacts: ModuleAiArtifactPort;
   readonly aiOperations: ModuleAiOperationPort;
-  readonly jobs: ModuleJobSubmitter;
+  readonly jobs: ModuleJobPort;
   readonly storage: ModuleStoragePort;
   readonly userDirectory: ModuleUserDirectoryPort;
 }

package/template/packages/shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/shared",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {