@aurelienbn/oxlint-plugin-alchemy (英语)

4 oxlint rules for Alchemy v2(基础设施作为效果):代码,用于进行打字检查和部署,然后因为运行在错误的相位或错误的范围而行为不当.

[注] 释放候选人. 已核对 alchemy 2.0.0-β.79 (英语). 还没有消费者校正过.

pnpm add -D @aurelienbbn/oxlint-plugin-alchemy oxlint   # oxlint >=1.82.0 <2.0.0

{
  "jsPlugins": ["@aurelienbbn/oxlint-plugin-alchemy"],
  "rules": {
    "alchemy/config-in-init": "error",
    "alchemy/no-disposable-in-instance-scope": "error",
    "alchemy/worker-env-secret-literal": "error",
    "alchemy/workflow-io-outside-task": "error"
  }
}

无预设. 无自定义 : 每个定律都需要一个选择(在读取值的地方,资源生活的地方,步骤的名称),所以每个规则只报告.

什么火吗

export default Cloudflare.Worker(
  "Api",
  { main: import.meta.url, env: { STRIPE_SECRET: "sk_live_..." } }, // ❌ worker-env-secret-literal: bound as plain_text
  Effect.gen(function* () {
    const pool = yield* Effect.acquireRelease(openPool, close); // ❌ no-disposable-in-instance-scope: never released on workerd
    const apiKey = yield* Config.Redacted("API_KEY"); // ✅ read in the init, so Alchemy binds it
    return {
      fetch: Effect.gen(function* () {
        const host = yield* Config.String("HOST"); // ❌ config-in-init: never bound, missing at runtime
        const again = yield* Config.Redacted("API_KEY"); // ✅ already bound by the init
      }),
    };
  }),
);

export class Sync extends Cloudflare.Workflow<Sync>()(
  "Sync",
  Effect.gen(function* () {
    const kv = yield* Cloudflare.KV.ReadWriteNamespace(KV);
    return Effect.fn(function* (input: { id: string }) {
      yield* kv.put(input.id, "started"); // ❌ workflow-io-outside-task: runs again on every replay
      yield* Cloudflare.Workflows.task("store", kv.put(input.id, "done")); // ✅ checkpointed
    });
  }),
) {}

限制

• 单文件视图. 由另一个文件所建的、通过标识符传递的或由图层构成的索引是无形的。 A 类 Tag.make 在从另一个文件导入的标签上不被识别.
• config-in-init 假阳性 : 报告受不同声明约束的密钥(图层,工作流的主机工人)。 压制行,或读 键在这个init.
• workflow-io-outside-task 故意缩小: 只有直接通话 yield* 炼金术绑定; I/O 通过您自己的服务或助手功能不被看到.
• 其他炼金平台 (ECS, Containers, Railway, Fly,.)不被承认:他们的镜形语义不同(服务器在优雅的出道上运行最终确定器).

资信: 每个规则都独立执行由Alchemy所记录的行为(alchemy-run/alchemy,Apache-2.0):Secrets & Config, runtime(Intance size vs request size), Cloudflare Workers) env 绑定, Cloudflare Workflows 重放语义; 没有文档文本或代码复制 .

登记的合同库存

从软件包导出 pnpm catalog. 规则特定选项和限制在上文和源测试中都有描述.

信用概念

• https://alchemy.run/cloudflare/compute/ 工人(英语: (化学管理/化学文献和Cloudflare/工人/工人.ts) env JSDoc, Apache-2.0;灵感,独立执行)
• https://alchemy.run/cloudflare/compute/workflows (中文(简体) ) (alchemy-runy/alchemy docs,Apache-2.0;灵感,独立实施)
• https://alchemy.run/environments/secrets (中文(简体) ) (alchemy-runy/alchemy docs,Apache-2.0;灵感,独立实施)
• https://alchemy.run/information-as-effects/runtime (英语) (alchemy-runy/alchemy docs,Apache-2.0;灵感,独立实施)