@h-ai/storage 0.1.0-alpha.13 → 0.1.0-alpha.16

package/README.md

@@ -51,43 +51,16 @@ await uploadWithPresignedUrl(uploadUrl, file)
 
 > 注意：`@h-ai/storage` 不内置 HTTP 路由；请在应用层自行实现签名 URL API。
 
-## API 契约（`@h-ai/storage/api`）
+## HTTP API 契约
 
-独立子路径 `@h-ai/storage/api` 导出所有存储端点的 Zod Schema 和端点契约定义，客户端和服务端共享同一份类型定义，编译时保证 I/O 一致性。
+公共 HTTP API 统一由 `@h-ai/api-contract` 提供，并由 `@h-ai/serv` 的 `createStorageProcedures({ storage })` 绑定到本模块能力。
 
 ```ts
-import { PresignPutInputSchema, storageEndpoints } from '@h-ai/storage/api'
+import { apiClient } from '@h-ai/api-client'
 
-// 端点契约包含 6 个端点：
-// presignDownload / presignUpload / fileInfo / listFiles / deleteFile / deleteFiles
-
-// 客户端调用
-const { url } = await api.call(storageEndpoints.presignUpload, { key: 'avatar.png' })
-
-// 服务端路由
-export const POST = kit.fromContract(storageEndpoints.presignUpload, async (input) => {
-  const result = await storage.presign.putUrl(input.key, input)
-  return result.success ? result.data : kit.response.internalError(result.error.message)
-})
-
-// 独立使用 Schema 做校验
-const parsed = PresignPutInputSchema.safeParse(requestBody)
-if (!parsed.success) { /* 校验失败 */ }
+const result = await apiClient.storage.presignedUrls.createUpload({ key: 'avatar.png' })
 ```
 
-**导出的 Schema：**
-
-- `FileMetadataSchema` — 文件元数据
-- `PresignGetInputSchema` / `PresignPutInputSchema` — 签名 URL 入参
-- `PresignUrlOutputSchema` — 签名 URL 出参
-- `ListFilesOutputSchema` — 文件列表出参
-- `DeleteFileInputSchema` / `DeleteFilesInputSchema` — 删除入参
-- `FileInfoInputSchema` — 文件信息入参
-
-**导出的类型（从 Schema 推导）：**
-
-`PresignGetInput` / `PresignPutInput` / `PresignUrlOutput` / `ListFilesOutput` / `DeleteFileInput` / `DeleteFilesInput` / `FileInfoInput`
-
 ## API 概览
 
 - `storage.file`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/storage",
   "type": "module",
-  "version": "0.1.0-alpha.13",
+  "version": "0.1.0-alpha.16",
   "description": "Hai Framework object storage module for S3-compatible and local backends.",
   "license": "Apache-2.0",
   "exports": {
@@ -14,10 +14,6 @@
     "./client": {
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.js"
-    },
-    "./api": {
-      "types": "./dist/api/index.d.ts",
-      "import": "./dist/api/index.js"
     }
   },
   "main": "./dist/node.js",
@@ -33,7 +29,7 @@
     "@aws-sdk/client-s3": "^3.723.0",
     "@aws-sdk/s3-request-presigner": "^3.723.0",
     "zod": "^4.3.6",
-    "@h-ai/core": "0.1.0-alpha.13"
+    "@h-ai/core": "0.1.0-alpha.16"
   },
   "devDependencies": {
     "@types/node": "^25.1.0",

package/dist/api/index.d.ts

@@ -1,167 +0,0 @@
-import { z } from 'zod';
-
-/**
- * @h-ai/storage/api — 存储 API 端点契约定义
- *
- * 所有 storage 模块的 API 端点（path + method + schema），
- * 客户端和服务端都从此处引用，编译时保证一致性。
- * @module storage-api-contract
- */
-
-interface EndpointDef<TInput = unknown, TOutput = unknown> {
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-    path: string;
-    input: z.ZodType<TInput>;
-    output: z.ZodType<TOutput>;
-    requireAuth?: boolean;
-    meta?: {
-        summary?: string;
-        tags?: string[];
-    };
-}
-/**
- * storage 所有 API 端点
- *
- * @example
- * ```ts
- * // 客户端
- * import { storageEndpoints } from '@h-ai/storage/api'
- * const { url } = await api.call(storageEndpoints.presignUpload, { key: 'avatar.png' })
- *
- * // 服务端
- * export const POST = kit.fromContract(storageEndpoints.presignUpload, async (input) => {
- *   const result = await storage.presign.putUrl(input.key, input)
- *   return result.success ? result.data : kit.response.internalError(result.error.message)
- * })
- * ```
- */
-declare const storageEndpoints: {
-    /** 获取下载签名 URL */
-    readonly presignDownload: EndpointDef<{
-        key: string;
-        expiresIn?: number | undefined;
-    }, {
-        url: string;
-        key: string;
-        expiresAt?: Date | undefined;
-    }>;
-    /** 获取上传签名 URL */
-    readonly presignUpload: EndpointDef<{
-        key: string;
-        contentType?: string | undefined;
-        contentLength?: number | undefined;
-        expiresIn?: number | undefined;
-    }, {
-        url: string;
-        key: string;
-        expiresAt?: Date | undefined;
-    }>;
-    /** 获取文件元数据 */
-    readonly fileInfo: EndpointDef<{
-        key: string;
-    }, {
-        key: string;
-        size: number;
-        contentType: string;
-        lastModified: Date;
-        etag?: string | undefined;
-        metadata?: Record<string, string> | undefined;
-    }>;
-    /** 列出文件 */
-    readonly listFiles: EndpointDef<{
-        prefix?: string | undefined;
-        maxKeys?: number | undefined;
-        continuationToken?: string | undefined;
-        delimiter?: string | undefined;
-    }, {
-        files: {
-            key: string;
-            size: number;
-            contentType: string;
-            lastModified: Date;
-            etag?: string | undefined;
-            metadata?: Record<string, string> | undefined;
-        }[];
-        commonPrefixes: string[];
-        isTruncated: boolean;
-        nextContinuationToken?: string | undefined;
-    }>;
-    /** 删除单个文件 */
-    readonly deleteFile: EndpointDef<{
-        key: string;
-    }, void>;
-    /** 批量删除文件 */
-    readonly deleteFiles: EndpointDef<{
-        keys: string[];
-    }, void>;
-};
-
-/**
- * @h-ai/storage/api — 存储 API 契约 Schema
- *
- * 入参/出参 Schema，客户端和服务端共享的唯一真相源。
- * @module storage-api-schemas
- */
-
-/** 文件元数据 Schema */
-declare const FileMetadataSchema: z.ZodObject<{
-    key: z.ZodString;
-    size: z.ZodNumber;
-    contentType: z.ZodString;
-    lastModified: z.ZodCoercedDate<unknown>;
-    etag: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strip>;
-/** 获取下载签名 URL 入参 */
-declare const PresignGetInputSchema: z.ZodObject<{
-    key: z.ZodString;
-    expiresIn: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-/** 获取上传签名 URL 入参 */
-declare const PresignPutInputSchema: z.ZodObject<{
-    key: z.ZodString;
-    contentType: z.ZodOptional<z.ZodString>;
-    contentLength: z.ZodOptional<z.ZodNumber>;
-    expiresIn: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-/** 签名 URL 出参 */
-declare const PresignUrlOutputSchema: z.ZodObject<{
-    url: z.ZodString;
-    key: z.ZodString;
-    expiresAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-}, z.core.$strip>;
-/** 文件列表出参 */
-declare const ListFilesOutputSchema: z.ZodObject<{
-    files: z.ZodArray<z.ZodObject<{
-        key: z.ZodString;
-        size: z.ZodNumber;
-        contentType: z.ZodString;
-        lastModified: z.ZodCoercedDate<unknown>;
-        etag: z.ZodOptional<z.ZodString>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, z.core.$strip>>;
-    commonPrefixes: z.ZodArray<z.ZodString>;
-    nextContinuationToken: z.ZodOptional<z.ZodString>;
-    isTruncated: z.ZodBoolean;
-}, z.core.$strip>;
-/** 删除文件入参 */
-declare const DeleteFileInputSchema: z.ZodObject<{
-    key: z.ZodString;
-}, z.core.$strip>;
-/** 批量删除文件入参 */
-declare const DeleteFilesInputSchema: z.ZodObject<{
-    keys: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-/** 获取文件信息入参 */
-declare const FileInfoInputSchema: z.ZodObject<{
-    key: z.ZodString;
-}, z.core.$strip>;
-type PresignGetInput = z.infer<typeof PresignGetInputSchema>;
-type PresignPutInput = z.infer<typeof PresignPutInputSchema>;
-type PresignUrlOutput = z.infer<typeof PresignUrlOutputSchema>;
-type ListFilesOutput = z.infer<typeof ListFilesOutputSchema>;
-type DeleteFileInput = z.infer<typeof DeleteFileInputSchema>;
-type DeleteFilesInput = z.infer<typeof DeleteFilesInputSchema>;
-type FileInfoInput = z.infer<typeof FileInfoInputSchema>;
-
-export { type DeleteFileInput, DeleteFileInputSchema, type DeleteFilesInput, DeleteFilesInputSchema, type FileInfoInput, FileInfoInputSchema, FileMetadataSchema, type ListFilesOutput, ListFilesOutputSchema, type PresignGetInput, PresignGetInputSchema, type PresignPutInput, PresignPutInputSchema, type PresignUrlOutput, PresignUrlOutputSchema, storageEndpoints };

package/dist/api/index.js

@@ -1,105 +0,0 @@
-import { z } from 'zod';
-
-// src/api/storage-api-contract.ts
-var FileMetadataSchema = z.object({
-  key: z.string(),
-  size: z.number(),
-  contentType: z.string(),
-  lastModified: z.coerce.date(),
-  etag: z.string().optional(),
-  metadata: z.record(z.string(), z.string()).optional()
-});
-var PresignGetInputSchema = z.object({
-  key: z.string().min(1),
-  expiresIn: z.number().int().min(1).optional()
-});
-var PresignPutInputSchema = z.object({
-  key: z.string().min(1),
-  contentType: z.string().optional(),
-  contentLength: z.number().int().min(1).optional(),
-  expiresIn: z.number().int().min(1).optional()
-});
-var PresignUrlOutputSchema = z.object({
-  url: z.string(),
-  key: z.string(),
-  expiresAt: z.coerce.date().optional()
-});
-var ListFilesOutputSchema = z.object({
-  files: z.array(FileMetadataSchema),
-  commonPrefixes: z.array(z.string()),
-  nextContinuationToken: z.string().optional(),
-  isTruncated: z.boolean()
-});
-var DeleteFileInputSchema = z.object({
-  key: z.string().min(1)
-});
-var DeleteFilesInputSchema = z.object({
-  keys: z.array(z.string().min(1)).min(1)
-});
-var FileInfoInputSchema = z.object({
-  key: z.string().min(1)
-});
-
-// src/api/storage-api-contract.ts
-function defineEndpoint(def) {
-  return def;
-}
-var storageEndpoints = {
-  /** 获取下载签名 URL */
-  presignDownload: defineEndpoint({
-    method: "POST",
-    path: "/storage/presign/download",
-    input: PresignGetInputSchema,
-    output: PresignUrlOutputSchema,
-    meta: { summary: "Get presigned download URL", tags: ["storage"] }
-  }),
-  /** 获取上传签名 URL */
-  presignUpload: defineEndpoint({
-    method: "POST",
-    path: "/storage/presign/upload",
-    input: PresignPutInputSchema,
-    output: PresignUrlOutputSchema,
-    meta: { summary: "Get presigned upload URL", tags: ["storage"] }
-  }),
-  /** 获取文件元数据 */
-  fileInfo: defineEndpoint({
-    method: "POST",
-    path: "/storage/file/info",
-    input: FileInfoInputSchema,
-    output: FileMetadataSchema,
-    meta: { summary: "Get file metadata", tags: ["storage"] }
-  }),
-  /** 列出文件 */
-  listFiles: defineEndpoint({
-    method: "GET",
-    path: "/storage/files",
-    input: z.object({
-      prefix: z.string().optional(),
-      maxKeys: z.coerce.number().int().min(1).max(1e3).optional(),
-      continuationToken: z.string().optional(),
-      delimiter: z.string().optional()
-    }),
-    output: ListFilesOutputSchema,
-    meta: { summary: "List files by prefix", tags: ["storage"] }
-  }),
-  /** 删除单个文件 */
-  deleteFile: defineEndpoint({
-    method: "POST",
-    path: "/storage/file/delete",
-    input: DeleteFileInputSchema,
-    output: z.void(),
-    meta: { summary: "Delete a file", tags: ["storage"] }
-  }),
-  /** 批量删除文件 */
-  deleteFiles: defineEndpoint({
-    method: "POST",
-    path: "/storage/files/delete",
-    input: DeleteFilesInputSchema,
-    output: z.void(),
-    meta: { summary: "Delete multiple files", tags: ["storage"] }
-  })
-};
-
-export { DeleteFileInputSchema, DeleteFilesInputSchema, FileInfoInputSchema, FileMetadataSchema, ListFilesOutputSchema, PresignGetInputSchema, PresignPutInputSchema, PresignUrlOutputSchema, storageEndpoints };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/api/storage-api-schemas.ts","../../src/api/storage-api-contract.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @h-ai/storage/api — 存储 API 契约 Schema\n *\n * 入参/出参 Schema，客户端和服务端共享的唯一真相源。\n * @module storage-api-schemas\n */\n\nimport { z } from 'zod'\n\n// ─── 文件元数据 ───\n\n/** 文件元数据 Schema */\nexport const FileMetadataSchema = z.object({\n  key: z.string(),\n  size: z.number(),\n  contentType: z.string(),\n  lastModified: z.coerce.date(),\n  etag: z.string().optional(),\n  metadata: z.record(z.string(), z.string()).optional(),\n})\n\n// ─── 签名 URL ───\n\n/** 获取下载签名 URL 入参 */\nexport const PresignGetInputSchema = z.object({\n  key: z.string().min(1),\n  expiresIn: z.number().int().min(1).optional(),\n})\n\n/** 获取上传签名 URL 入参 */\nexport const PresignPutInputSchema = z.object({\n  key: z.string().min(1),\n  contentType: z.string().optional(),\n  contentLength: z.number().int().min(1).optional(),\n  expiresIn: z.number().int().min(1).optional(),\n})\n\n/** 签名 URL 出参 */\nexport const PresignUrlOutputSchema = z.object({\n  url: z.string(),\n  key: z.string(),\n  expiresAt: z.coerce.date().optional(),\n})\n\n// ─── 列表 ───\n\n/** 文件列表出参 */\nexport const ListFilesOutputSchema = z.object({\n  files: z.array(FileMetadataSchema),\n  commonPrefixes: z.array(z.string()),\n  nextContinuationToken: z.string().optional(),\n  isTruncated: z.boolean(),\n})\n\n// ─── 删除 ───\n\n/** 删除文件入参 */\nexport const DeleteFileInputSchema = z.object({\n  key: z.string().min(1),\n})\n\n/** 批量删除文件入参 */\nexport const DeleteFilesInputSchema = z.object({\n  keys: z.array(z.string().min(1)).min(1),\n})\n\n// ─── 文件信息 ───\n\n/** 获取文件信息入参 */\nexport const FileInfoInputSchema = z.object({\n  key: z.string().min(1),\n})\n\n// ─── 推导类型 ───\n\nexport type PresignGetInput = z.infer<typeof PresignGetInputSchema>\nexport type PresignPutInput = z.infer<typeof PresignPutInputSchema>\nexport type PresignUrlOutput = z.infer<typeof PresignUrlOutputSchema>\nexport type ListFilesOutput = z.infer<typeof ListFilesOutputSchema>\nexport type DeleteFileInput = z.infer<typeof DeleteFileInputSchema>\nexport type DeleteFilesInput = z.infer<typeof DeleteFilesInputSchema>\nexport type FileInfoInput = z.infer<typeof FileInfoInputSchema>\n","/**\n * @h-ai/storage/api — 存储 API 端点契约定义\n *\n * 所有 storage 模块的 API 端点（path + method + schema），\n * 客户端和服务端都从此处引用，编译时保证一致性。\n * @module storage-api-contract\n */\n\nimport { z } from 'zod'\nimport {\n  DeleteFileInputSchema,\n  DeleteFilesInputSchema,\n  FileInfoInputSchema,\n  FileMetadataSchema,\n  ListFilesOutputSchema,\n  PresignGetInputSchema,\n  PresignPutInputSchema,\n  PresignUrlOutputSchema,\n} from './storage-api-schemas.js'\n\n// ─── 端点定义辅助（内联，避免对 @h-ai/api-client 的循环依赖） ───\n\ninterface EndpointDef<TInput = unknown, TOutput = unknown> {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'\n  path: string\n  input: z.ZodType<TInput>\n  output: z.ZodType<TOutput>\n  requireAuth?: boolean\n  meta?: { summary?: string, tags?: string[] }\n}\n\nfunction defineEndpoint<TInput, TOutput>(def: EndpointDef<TInput, TOutput>): EndpointDef<TInput, TOutput> {\n  return def\n}\n\n// ─── storage API 端点 ───\n\n/**\n * storage 所有 API 端点\n *\n * @example\n * ```ts\n * // 客户端\n * import { storageEndpoints } from '@h-ai/storage/api'\n * const { url } = await api.call(storageEndpoints.presignUpload, { key: 'avatar.png' })\n *\n * // 服务端\n * export const POST = kit.fromContract(storageEndpoints.presignUpload, async (input) => {\n *   const result = await storage.presign.putUrl(input.key, input)\n *   return result.success ? result.data : kit.response.internalError(result.error.message)\n * })\n * ```\n */\nexport const storageEndpoints = {\n  /** 获取下载签名 URL */\n  presignDownload: defineEndpoint({\n    method: 'POST',\n    path: '/storage/presign/download',\n    input: PresignGetInputSchema,\n    output: PresignUrlOutputSchema,\n    meta: { summary: 'Get presigned download URL', tags: ['storage'] },\n  }),\n\n  /** 获取上传签名 URL */\n  presignUpload: defineEndpoint({\n    method: 'POST',\n    path: '/storage/presign/upload',\n    input: PresignPutInputSchema,\n    output: PresignUrlOutputSchema,\n    meta: { summary: 'Get presigned upload URL', tags: ['storage'] },\n  }),\n\n  /** 获取文件元数据 */\n  fileInfo: defineEndpoint({\n    method: 'POST',\n    path: '/storage/file/info',\n    input: FileInfoInputSchema,\n    output: FileMetadataSchema,\n    meta: { summary: 'Get file metadata', tags: ['storage'] },\n  }),\n\n  /** 列出文件 */\n  listFiles: defineEndpoint({\n    method: 'GET',\n    path: '/storage/files',\n    input: z.object({\n      prefix: z.string().optional(),\n      maxKeys: z.coerce.number().int().min(1).max(1000).optional(),\n      continuationToken: z.string().optional(),\n      delimiter: z.string().optional(),\n    }),\n    output: ListFilesOutputSchema,\n    meta: { summary: 'List files by prefix', tags: ['storage'] },\n  }),\n\n  /** 删除单个文件 */\n  deleteFile: defineEndpoint({\n    method: 'POST',\n    path: '/storage/file/delete',\n    input: DeleteFileInputSchema,\n    output: z.void(),\n    meta: { summary: 'Delete a file', tags: ['storage'] },\n  }),\n\n  /** 批量删除文件 */\n  deleteFiles: defineEndpoint({\n    method: 'POST',\n    path: '/storage/files/delete',\n    input: DeleteFilesInputSchema,\n    output: z.void(),\n    meta: { summary: 'Delete multiple files', tags: ['storage'] },\n  }),\n} as const\n"]}