@geekmidas/cloud

中文文档
9.6.1发布于 2026/11/16TypeScriptESM + CJS构建来源已验证近 30 天下载 1.3万

SST(离子/钚)集成 @geekmidas 应用——可观察,可链接的构造,将1:1映射到可部署部队和 在部署前验证其环境,加上将资源与环境变量连接起来的运行时间帮助器.

中文使用文档
文档目录8 节
  1. 安装
  2. @geekmidas/cloud/sst
  3. 应用堆栈( S)
  4. 函数
  5. 阿庇语Name
  6. 克龙
  7. 从a gkm build 显示
  8. @geekmidas/cloud/utils (运行时间)

@geekmidas/云

SST(离子/钚)集成 @geekmidas 应用——有见解,可链接 将1:1地图绘制到可部署部队和 验证其环境 部署前,加上解决链接资源的运行时间助手 环境变量.

两分之一:

  • @geekmidas/cloud/sst - 那个 临时 构造您在 sst.config.ts (单位:千美元)App, (中文(简体) ), Stack, (中文(简体) ), Function, (中文(简体) ), Api, (中文(简体) ), Cron) (中文(简体) ).
  • @geekmidas/cloud 编号 : @geekmidas/cloud/utils - 那个 运行时间 帮助者 (单位:千美元)buildResourceEnv, (中文(简体) ), ResourceType变成SST Resource 链接为平面 在Lambda内的环境变量.

设计说明和原理 docs/sst-constructs.md (建筑)和 docs/sst-testing.md (测试).

安装

pnpm add @geekmidas/cloud

./sst 目标 SST v4 请检查url=值 (帮助) (同类依赖) sst@^4) 并按原样分发 TypeScript source — 它延伸环境 sst.aws.* 仅存在的环球 之后 sst install 在你的应用程序.

@geekmidas/cloud/sst

import { App, Api, Function, Cron } from '@geekmidas/cloud/sst';

应用堆栈( S)

App 是一个简单的同步构造; 在呼叫时解决主控区域 并传递到现场. app.stack(name) 创建一个 Stack 绑在应用程序.

const { zoneId } = await aws.route53.getZone({ name: 'example.com' });

const app = new App({
  name: 'my-app',
  stage: 'prod',
  domain: 'example.com',
  hostedZoneId: zoneId,
  region: 'us-east-1',
});

const stack = app.stack('api');
stack.logicalPrefixedName('handler'); // "prod-my-app-api-handler"
stack.select({ prod: 'live', default: 'dev' }); // by-stage value with a default

函数

扩展 sst.aws.FunctionArgs (本地选项通过),合并标准 env 默认,默认为 nodejs24.x + JSON 伐木,以及 验证 envVars 反对 links 合成时间 - 只附加一个函数需要的链接 (最少的特权).

const fn = new Function(stack, 'Processor', {
  handler: 'src/processor.handler',
  links: [db, topic],
  envVars: ['DATABASE_URL'], // validated against links; fails synth if missing
});

阿庇语Name

扩展 sst.aws.ApiGatewayV2Args (CORS/域/etc.通过). 路线是 键入的表格,每条路由内嵌验证,最小连接,以及一个键入 授权模式.

const api = new Api(stack, 'Api', {
  links: [db],
  authorizers: {
    jwt:      { issuer: 'https://issuer', audiences: ['aud'] }, // 'jwt' → JWT settings
    employee: { handler: 'src/employee-auth.handler' },         // custom → Lambda authorizer
  },
  routes: [
    { method: 'GET',  path: '/me',  handler: 'me.handler',  authorizer: 'jwt' },
    { method: 'GET',  path: '/adm', handler: 'adm.handler', authorizer: 'employee' },
    { method: 'POST', path: '/pub', handler: 'pub.handler' }, // public (none)
  ],
});

一条路线 authorizer 类型限制为 'iam' | 'none' 加上声明 授权人名称——未申报名称是编译错误,以及 jwt 要求 JWT 自定义授权方需要设置时 handler。 。 。 .

克龙

环绕 sst.aws.CronV2 (单位:千美元)sst.aws.Cron 已贬值. processor 是一个 Function (或任何带有 arn(三); schedule 是输入的 cron(…) 编号 : at(…)。 。 。 .

const cron = new Cron(stack, 'Nightly', { processor: fn, schedule: 'cron(0 0 * * ? *)' });

从a gkm build 显示

gkm build 发布部署清单(类型: @geekmidas/manifest) (中文(简体) ). 每个 构造有静态 fromManifest 将它直接映射到下面的工厂:

import routes from './.gkm/routes-manifest.json';

const api     = Api.fromManifest(stack, 'Api', routes, { links: [db], authorizers });
const workers = Function.fromManifest(stack, functionsManifest, { links: [db] });
const crons   = Cron.fromManifest(stack, cronsManifest, { links: [db] });

@geekmidas/cloud/utils (运行时间)

import { buildResourceEnv } from '@geekmidas/cloud';

buildResourceEnv 转换 SST 的记录 Resource 连接到平坦环境中 变量,使用共享 ResourceType 词汇.

版本与发布记录

@geekmidas/cloud 共发布 202 个版本,首次发布于 2025/10/07;过去 12 个月发布了 200 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
9.6.1latest2026/11/16今天
10.0.0-alpha.185alpha2026/11/16今天
10.0.0-alpha.1842026/11/16今天
10.0.0-alpha.1832026/11/16今天
10.0.0-alpha.1822026/11/132 天前
10.0.0-alpha.1812026/11/133 天前

关于 @geekmidas/cloud 的常见问题

@geekmidas/cloud 是什么?

SST(离子/钚)集成 @geekmidas 应用——可观察,可链接的构造,将1:1映射到可部署部队和 在部署前验证其环境,加上将资源与环境变量连接起来的运行时间帮助器.

如何安装 @geekmidas/cloud?

在项目目录运行 npm install @geekmidas/cloud,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:sst(^4.15.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@geekmidas/cloud 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@geekmidas/cloud 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@geekmidas/cloud 可以商用吗?

@geekmidas/cloud 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@geekmidas/cloud 的下载量有多少?

根据 npm 官方下载统计,@geekmidas/cloud 在 2026/10/16 – 2026/11/14 这 30 天内被下载 12,696 次,日均约 423 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@geekmidas/cloud 还在维护吗?

最新版本 9.6.1 发布于 2026/11/16(今天);至今共发布 202 个版本,其中过去 12 个月发布了 200 个;首次发布于 2025/10/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。