cloud-function-cli 1.1.2 → 1.1.4

package/dist/cli/create.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("../utils/logger");
 const api_template_1 = require("../template/api-template");
+const context_types_1 = require("../template/context-types");
 const create = async (name) => {
     const parts = name.split('/');
     let group, api;
@@ -20,6 +21,14 @@ const create = async (name) => {
         api = parts[1];
     }
     const apiRootDir = path_1.default.join(process.cwd(), 'api');
+    if (!fs_1.default.existsSync(apiRootDir)) {
+        fs_1.default.mkdirSync(apiRootDir, { recursive: true });
+    }
+    const typesPath = path_1.default.join(apiRootDir, '_cf.d.ts');
+    if (!fs_1.default.existsSync(typesPath)) {
+        fs_1.default.writeFileSync(typesPath, context_types_1.contextTypesDts);
+        logger_1.logger.success('Created context types: api/_cf.d.ts');
+    }
     const groupDir = path_1.default.join(apiRootDir, group);
     if (!fs_1.default.existsSync(groupDir)) {
         fs_1.default.mkdirSync(groupDir, { recursive: true });

package/dist/cli/files.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filesDelete = exports.filesDownload = exports.filesList = exports.filesUpload = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const form_data_1 = __importDefault(require("form-data"));
+const apiClient_1 = require("../services/apiClient");
+const logger_1 = require("../utils/logger");
+const filesUpload = async (filePaths, options) => {
+    const resolvedFiles = filePaths
+        .map((p) => path_1.default.resolve(process.cwd(), p))
+        .filter((p) => fs_1.default.existsSync(p) && fs_1.default.statSync(p).isFile());
+    if (resolvedFiles.length === 0) {
+        logger_1.logger.error('No valid files to upload');
+        return;
+    }
+    const form = new form_data_1.default();
+    if (options.path)
+        form.append('path', options.path);
+    resolvedFiles.forEach((p) => {
+        form.append('file', fs_1.default.createReadStream(p), { filename: path_1.default.basename(p) });
+    });
+    try {
+        const res = await apiClient_1.apiClient.postRaw('/api/management/files/upload', form, {
+            headers: form.getHeaders()
+        });
+        const items = Array.isArray(res.data?.items) ? res.data.items : [];
+        logger_1.logger.success(`Uploaded ${items.length || resolvedFiles.length} file(s)`);
+        items.forEach((it) => logger_1.logger.info(`  ${it.filename} -> ${it.fileId}`));
+    }
+    catch (error) {
+        logger_1.logger.error(`Upload failed: ${error.response?.data?.error || error.message}`);
+    }
+};
+exports.filesUpload = filesUpload;
+const filesList = async (options) => {
+    const page = options.page ? Number(options.page) : 1;
+    const limit = options.limit ? Number(options.limit) : 20;
+    try {
+        const res = await apiClient_1.apiClient.get('/api/management/files/list', {
+            page,
+            limit,
+            pathPrefix: options.pathPrefix
+        });
+        const items = Array.isArray(res.data?.items) ? res.data.items : [];
+        if (items.length === 0) {
+            logger_1.logger.info('No files found');
+            return;
+        }
+        items.forEach((it) => {
+            const id = it?._id?.toString ? it._id.toString() : String(it?._id || '');
+            logger_1.logger.info(`${id}  ${String(it?.filename || '')}`);
+        });
+    }
+    catch (error) {
+        logger_1.logger.error(`List failed: ${error.response?.data?.error || error.message}`);
+    }
+};
+exports.filesList = filesList;
+const filesDownload = async (fileId, output) => {
+    const safeId = encodeURIComponent(fileId);
+    try {
+        const res = await apiClient_1.apiClient.getRaw(`/api/management/files/download/${safeId}`, {
+            responseType: 'stream'
+        });
+        const contentDisposition = String(res.headers?.['content-disposition'] || '');
+        const filename = parseFilenameFromContentDisposition(contentDisposition) || `${fileId}.bin`;
+        const target = output ? path_1.default.resolve(process.cwd(), output) : path_1.default.resolve(process.cwd(), filename);
+        await new Promise((resolve, reject) => {
+            const writer = fs_1.default.createWriteStream(target);
+            res.data.pipe(writer);
+            writer.on('finish', () => resolve());
+            writer.on('error', reject);
+        });
+        logger_1.logger.success(`Saved to ${target}`);
+    }
+    catch (error) {
+        logger_1.logger.error(`Download failed: ${error.response?.data?.error || error.message}`);
+    }
+};
+exports.filesDownload = filesDownload;
+const filesDelete = async (fileId) => {
+    const safeId = encodeURIComponent(fileId);
+    try {
+        await apiClient_1.apiClient.delete(`/api/management/files/${safeId}`);
+        logger_1.logger.success('Deleted');
+    }
+    catch (error) {
+        logger_1.logger.error(`Delete failed: ${error.response?.data?.error || error.message}`);
+    }
+};
+exports.filesDelete = filesDelete;
+const parseFilenameFromContentDisposition = (value) => {
+    const m = value.match(/filename\*\s*=\s*UTF-8''([^;]+)/i);
+    if (m && m[1]) {
+        try {
+            return decodeURIComponent(m[1]);
+        }
+        catch {
+            return m[1];
+        }
+    }
+    const m2 = value.match(/filename\s*=\s*"?([^"]+)"?/i);
+    return m2?.[1] ? m2[1] : '';
+};

package/dist/index.js

@@ -9,6 +9,7 @@ const get_1 = require("./cli/get");
 const history_1 = require("./cli/history");
 const rollback_1 = require("./cli/rollback");
 const list_1 = require("./cli/list");
+const files_1 = require("./cli/files");
 const program = new commander_1.Command();
 program
     .name('cf')
@@ -48,4 +49,25 @@ program
     .description('List groups or APIs in a group')
     .option('-e, --env <env>', 'Environment (dev/prod)')
     .action(list_1.list);
+const files = program.command('files').description('Manage uploaded files');
+files
+    .command('upload <paths...>')
+    .description('Upload file(s) to server (management files)')
+    .option('-p, --path <path>', 'Remote path/folder (metadata.path)')
+    .action((paths, options) => (0, files_1.filesUpload)(paths, options));
+files
+    .command('list')
+    .description('List uploaded files')
+    .option('--page <page>', 'Page number', '1')
+    .option('--limit <limit>', 'Page size', '20')
+    .option('--pathPrefix <pathPrefix>', 'Filter by path prefix (metadata.path)')
+    .action((options) => (0, files_1.filesList)(options));
+files
+    .command('download <fileId> [output]')
+    .description('Download a file by fileId')
+    .action((fileId, output) => (0, files_1.filesDownload)(fileId, output));
+files
+    .command('delete <fileId>')
+    .description('Delete a file by fileId')
+    .action((fileId) => (0, files_1.filesDelete)(fileId));
 program.parse(process.argv);

package/dist/services/apiClient.js

@@ -30,7 +30,9 @@ const getClient = () => {
 };
 exports.apiClient = {
     get: (url, params) => getClient().get(url, { params }),
+    getRaw: (url, config) => getClient().get(url, config),
     post: (url, data) => getClient().post(url, data),
+    postRaw: (url, data, config) => getClient().post(url, data, config),
     put: (url, data) => getClient().put(url, data),
     delete: (url) => getClient().delete(url)
 };

package/dist/template/api-template.js

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.apiTemplate = void 0;
-exports.apiTemplate = `async function handler(context) {
-  const { log, cacher, options, utils, mongo, http, https, request, response } = context
+exports.apiTemplate = `
+/** @typedef {import('../_cf').CloudFunctionContext} CloudFunctionContext */
 
-  let query = request.query
-  let data = request.body
+/**
+ * @param {CloudFunctionContext} context
+ */
+async function handler(context) {
+  const { request, libs, packages, files, mongo, cacher, log } = context
+
+  const query = request.query
+  const data = request.body
 
   return { code: 1, data: data || query }
 }

package/dist/template/context-types.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextTypesDts = void 0;
+exports.contextTypesDts = `export type RuntimeEnvironment = 'dev' | 'prod'
+
+export type UploadedFile = {
+  fieldname?: string
+  originalname?: string
+  encoding?: string
+  mimetype?: string
+  size?: number
+  buffer?: any
+}
+
+export type CloudFunctionRequest = {
+  body: any
+  query: any
+  params?: any
+  headers?: Record<string, any>
+  method?: string
+  path?: string
+  originalUrl?: string
+  url?: string
+  files?: UploadedFile[]
+}
+
+export type CloudFunctionResponse = {
+  status?: (code: number) => any
+  json?: (body: any) => any
+  send?: (body: any) => any
+  setHeader?: (name: string, value: any) => any
+  end?: () => any
+  headersSent?: boolean
+}
+
+export type FileService = {
+  uploadBuffer: (input: { buffer: any; filename: string; contentType?: string; metadata?: Record<string, any> }) => Promise<string>
+  findById: (fileId: string) => Promise<any | null>
+  openDownloadStream: (fileId: string) => any
+  downloadBuffer: (fileId: string) => Promise<any>
+  delete: (fileId: string) => Promise<void>
+  listFiles: (opts?: { page?: number; limit?: number; pathPrefix?: string }) => Promise<{ items: any[]; page: number; limit: number; total: number }>
+}
+
+export type LibLoader = {
+  use: (name: string) => Promise<any>
+}
+
+export type Packages = {
+  ensure: (spec: string) => Promise<{ name: string; spec: string }>
+  import: (nameOrSpec: string) => any
+  importOrInstall: (spec: string) => Promise<any>
+}
+
+export type CloudFunctionContext = {
+  log: {
+    info: (...args: any[]) => void
+    warn: (...args: any[]) => void
+    error: (...args: any[]) => void
+    debug: (...args: any[]) => void
+  }
+  cacher: {
+    get: (key: string) => Promise<any>
+    set: (key: string, value: any, ttlSeconds?: number) => Promise<void>
+    del: (key: string) => Promise<void>
+  }
+  options: {
+    group: string
+    apiName: string
+    option?: string
+    environment?: RuntimeEnvironment
+  }
+  environment?: RuntimeEnvironment
+  mongo: {
+    getDB: (dbName?: string) => any
+  }
+  files: FileService
+  libs: LibLoader
+  packages: Packages
+  http: any
+  https: any
+  request: CloudFunctionRequest
+  response: CloudFunctionResponse
+}
+`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloud-function-cli",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "CLI for Cloud Function System - Create, deploy, and manage serverless functions",
   "main": "dist/index.js",
   "bin": {
@@ -50,6 +50,7 @@
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "dotenv": "^16.4.1",
+    "form-data": "^4.0.4",
     "inquirer": "^8.2.6"
   },
   "devDependencies": {