@gaganref/confect-alchemy 10.3.1-fork.96 → 10.6.0-fork.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/README.md +1 -1
  2. package/dist/Backend.d.ts.map +1 -1
  3. package/dist/Backend.js +2 -3
  4. package/dist/Backend.js.map +1 -1
  5. package/dist/Code.d.ts +16 -3
  6. package/dist/Code.d.ts.map +1 -1
  7. package/dist/Code.js +13 -3
  8. package/dist/Code.js.map +1 -1
  9. package/dist/Confect.d.ts.map +1 -1
  10. package/dist/Confect.js +1 -2
  11. package/dist/Convex.d.ts.map +1 -1
  12. package/dist/Convex.js +3 -4
  13. package/dist/ConvexClient.d.ts +14 -4
  14. package/dist/ConvexClient.d.ts.map +1 -1
  15. package/dist/ConvexClient.js +44 -36
  16. package/dist/ConvexClient.js.map +1 -1
  17. package/dist/DeployKey.d.ts +22 -12
  18. package/dist/DeployKey.d.ts.map +1 -1
  19. package/dist/DeployKey.js +41 -29
  20. package/dist/DeployKey.js.map +1 -1
  21. package/dist/Deployment.d.ts +19 -10
  22. package/dist/Deployment.d.ts.map +1 -1
  23. package/dist/Deployment.js +22 -19
  24. package/dist/Deployment.js.map +1 -1
  25. package/dist/EnvironmentVariables.d.ts +23 -31
  26. package/dist/EnvironmentVariables.d.ts.map +1 -1
  27. package/dist/EnvironmentVariables.js +21 -20
  28. package/dist/EnvironmentVariables.js.map +1 -1
  29. package/dist/Project.d.ts +15 -10
  30. package/dist/Project.d.ts.map +1 -1
  31. package/dist/Project.js +23 -22
  32. package/dist/Project.js.map +1 -1
  33. package/dist/Providers.d.ts +3 -1
  34. package/dist/Providers.d.ts.map +1 -1
  35. package/dist/Providers.js +19 -18
  36. package/dist/Providers.js.map +1 -1
  37. package/dist/_virtual/_rolldown/runtime.js +5 -6
  38. package/dist/index.d.ts +3 -0
  39. package/dist/index.d.ts.map +1 -1
  40. package/dist/index.js +1 -1
  41. package/dist/internal/CodeDeployment.d.ts +6 -1
  42. package/dist/internal/CodeDeployment.d.ts.map +1 -1
  43. package/dist/internal/CodeDeployment.js +10 -8
  44. package/dist/internal/CodeDeployment.js.map +1 -1
  45. package/dist/internal/CommandRunner.d.ts +6 -1
  46. package/dist/internal/CommandRunner.d.ts.map +1 -1
  47. package/dist/internal/CommandRunner.js +11 -9
  48. package/dist/internal/CommandRunner.js.map +1 -1
  49. package/dist/internal/FileLock.d.ts +7 -3
  50. package/dist/internal/FileLock.d.ts.map +1 -1
  51. package/dist/internal/FileLock.js +10 -8
  52. package/dist/internal/FileLock.js.map +1 -1
  53. package/dist/internal/Lifecycle.d.ts +3 -1
  54. package/dist/internal/Lifecycle.d.ts.map +1 -1
  55. package/dist/internal/Lifecycle.js +3 -4
  56. package/dist/internal/Lifecycle.js.map +1 -1
  57. package/dist/internal/LocalBackend.d.ts +7 -3
  58. package/dist/internal/LocalBackend.d.ts.map +1 -1
  59. package/dist/internal/LocalBackend.js +26 -18
  60. package/dist/internal/LocalBackend.js.map +1 -1
  61. package/dist/internal/LocalSidecar.d.ts +4 -1
  62. package/dist/internal/LocalSidecar.d.ts.map +1 -1
  63. package/dist/internal/LocalSidecar.js +4 -2
  64. package/dist/internal/LocalSidecar.js.map +1 -1
  65. package/dist/internal/Loopback.d.ts.map +1 -1
  66. package/dist/internal/Loopback.js +1 -2
  67. package/dist/internal/MountInit.d.ts +5 -1
  68. package/dist/internal/MountInit.d.ts.map +1 -1
  69. package/dist/internal/MountInit.js +5 -4
  70. package/dist/internal/MountInit.js.map +1 -1
  71. package/dist/internal/PushLock.d.ts +7 -3
  72. package/dist/internal/PushLock.d.ts.map +1 -1
  73. package/dist/internal/PushLock.js +7 -6
  74. package/dist/internal/PushLock.js.map +1 -1
  75. package/dist/internal/ResourceIdentity.d.ts.map +1 -1
  76. package/dist/internal/ResourceIdentity.js +5 -3
  77. package/dist/internal/ResourceIdentity.js.map +1 -1
  78. package/dist/internal/UserCache.d.ts +2 -0
  79. package/dist/internal/UserCache.d.ts.map +1 -1
  80. package/dist/internal/UserCache.js +5 -4
  81. package/dist/internal/UserCache.js.map +1 -1
  82. package/dist/internal/Zip.d.ts +5 -1
  83. package/dist/internal/Zip.d.ts.map +1 -1
  84. package/dist/internal/Zip.js +9 -8
  85. package/dist/internal/Zip.js.map +1 -1
  86. package/package.json +5 -5
  87. package/src/Backend.ts +7 -6
  88. package/src/Code.ts +11 -0
  89. package/src/ConvexClient.ts +87 -74
  90. package/src/DeployKey.ts +73 -44
  91. package/src/Deployment.ts +50 -37
  92. package/src/EnvironmentVariables.ts +30 -27
  93. package/src/Project.ts +42 -41
  94. package/src/Providers.ts +2 -0
  95. package/src/index.ts +3 -0
  96. package/src/internal/CodeDeployment.ts +17 -11
  97. package/src/internal/CommandRunner.ts +27 -26
  98. package/src/internal/FileLock.ts +15 -12
  99. package/src/internal/Lifecycle.ts +11 -7
  100. package/src/internal/LocalBackend.ts +45 -39
  101. package/src/internal/LocalSidecar.ts +3 -0
  102. package/src/internal/MountInit.ts +8 -6
  103. package/src/internal/PushLock.ts +13 -11
  104. package/src/internal/ResourceIdentity.ts +12 -5
  105. package/src/internal/UserCache.ts +13 -4
  106. package/src/internal/Zip.ts +13 -8
@@ -1,4 +1,4 @@
1
- import * as Crypto from "effect/Crypto";
1
+ import * as SecureRandom from "effect/crypto/SecureRandom";
2
2
  import type * as Duration from "effect/Duration";
3
3
  import * as Effect from "effect/Effect";
4
4
  import * as FileSystem from "effect/FileSystem";
@@ -6,7 +6,9 @@ import * as Path from "effect/Path";
6
6
  import * as Schema from "effect/Schema";
7
7
  declare const FileLockError_base: Schema.Class<FileLockError, Schema.TaggedStruct<"FileLockError", {
8
8
  readonly reason: Schema.Literals<readonly ["held", "timeout", "filesystem"]>;
9
- }>, import("effect/Cause").YieldableError>;
9
+ }>, import("effect/Cause").YieldableError & {
10
+ readonly brand: unique symbol;
11
+ }>;
10
12
  export declare class FileLockError extends FileLockError_base {
11
13
  }
12
14
  /**
@@ -24,7 +26,9 @@ export declare class FileLockError extends FileLockError_base {
24
26
  * leaves waiters timing out rather than overlapping. A timeout that lands while
25
27
  * an attempt succeeds still fails, and the published lock is removed only when
26
28
  * the ambient scope closes.
29
+ *
30
+ * @internal
27
31
  */
28
- export declare const acquire: (file: string, wait?: Duration.Input | undefined) => Effect.Effect<undefined, FileLockError, Crypto.Crypto | FileSystem.FileSystem | Path.Path | import("effect/Scope").Scope>;
32
+ export declare const acquire: (file: string, wait?: Duration.Input | undefined) => Effect.Effect<undefined, FileLockError, FileSystem.FileSystem | Path.Path | import("effect/Scope").Scope | SecureRandom.SecureRandom>;
29
33
  export {};
30
34
  //# sourceMappingURL=FileLock.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"FileLock.d.ts","sourceRoot":"","sources":["../../src/internal/FileLock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;AAExC,qBAAa,aAAc,SAAQ,kBAGlC;CAAG;AAgBJ;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,gLA0FlB,CAAC"}
1
+ {"version":3,"file":"FileLock.d.ts","sources":["../../src/internal/FileLock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;oBAIpB,OAAO,MAAM;;AAFjC,qBAAa,aAAc,SAAQ,kBAKjC;CAAG;AAgBL;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,OAAO,4LAyFlB,CAAC"}
@@ -3,10 +3,10 @@ import * as FileSystem from "effect/FileSystem";
3
3
  import * as Path from "effect/Path";
4
4
  import * as Schema from "effect/Schema";
5
5
  import * as Option from "effect/Option";
6
- import * as Crypto from "effect/Crypto";
6
+ import * as SecureRandom from "effect/crypto/SecureRandom";
7
7
  import * as Predicate from "effect/Predicate";
8
8
  import * as Schedule from "effect/Schedule";
9
- //#region src/internal/FileLock.ts
9
+ // src/internal/FileLock.ts
10
10
  var FileLockError = class extends Schema.TaggedError()("FileLockError", { reason: Schema.Literals([
11
11
  "held",
12
12
  "timeout",
@@ -40,13 +40,16 @@ const isAlive = (pid) => {
40
40
  * leaves waiters timing out rather than overlapping. A timeout that lands while
41
41
  * an attempt succeeds still fails, and the published lock is removed only when
42
42
  * the ambient scope closes.
43
+ *
44
+ * @internal
43
45
  */
44
46
  const acquire = Effect.fn("FileLock.acquire")(function* (file, wait) {
45
47
  const fs = yield* FileSystem.FileSystem;
46
48
  const path = yield* Path.Path;
47
- const crypto = yield* Crypto.Crypto;
48
- const failed = () => new FileLockError({ reason: "filesystem" });
49
- const token = Buffer.from(yield* crypto.randomBytes(16).pipe(Effect.mapError(failed))).toString("hex");
49
+ const random = yield* SecureRandom.SecureRandom;
50
+ const failed = () => FileLockError.make({ reason: "filesystem" });
51
+ const randomBytes2 = yield* random.randomBytes(16);
52
+ const token = Buffer.from(randomBytes2).toString("hex");
50
53
  const holder = yield* Schema.encodeEffect(Holder)({
51
54
  pid: process.pid,
52
55
  token
@@ -67,17 +70,16 @@ const acquire = Effect.fn("FileLock.acquire")(function* (file, wait) {
67
70
  });
68
71
  const attempt = publish(file).pipe(Effect.flatMap((acquired) => acquired ? Effect.succeed(true) : Effect.flatMap(reclaim, (removed) => removed ? publish(file) : Effect.succeed(false))), Effect.uninterruptible, Effect.mapError(failed));
69
72
  if (wait === void 0) {
70
- if (!(yield* attempt)) return yield* new FileLockError({ reason: "held" });
73
+ if (!(yield* attempt)) return yield* FileLockError.make({ reason: "held" });
71
74
  } else yield* attempt.pipe(Effect.repeat({
72
75
  until: (acquired) => acquired,
73
76
  schedule: Schedule.spaced("100 millis")
74
77
  }), Effect.timeoutOrElse({
75
78
  duration: wait,
76
- orElse: () => Effect.fail(new FileLockError({ reason: "timeout" }))
79
+ orElse: () => Effect.fail(FileLockError.make({ reason: "timeout" }))
77
80
  }));
78
81
  yield* fs.remove(claim, { force: true }).pipe(Effect.ignore);
79
82
  });
80
- //#endregion
81
83
  export { FileLockError, acquire };
82
84
 
83
85
  //# sourceMappingURL=FileLock.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"FileLock.js","names":[],"sources":["../../src/internal/FileLock.ts"],"sourcesContent":["import * as Crypto from \"effect/Crypto\";\nimport type * as Duration from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as FileSystem from \"effect/FileSystem\";\nimport * as Option from \"effect/Option\";\nimport * as Path from \"effect/Path\";\nimport * as Predicate from \"effect/Predicate\";\nimport * as Schedule from \"effect/Schedule\";\nimport * as Schema from \"effect/Schema\";\n\nexport class FileLockError extends Schema.TaggedError<FileLockError>()(\n \"FileLockError\",\n { reason: Schema.Literals([\"held\", \"timeout\", \"filesystem\"]) },\n) {}\n\nconst Holder = Schema.fromJsonString(\n Schema.Struct({ pid: Schema.Finite, token: Schema.String }),\n);\nconst decodeHolder = Schema.decodeUnknownOption(Holder);\n\nconst isAlive = (pid: number) => {\n try {\n process.kill(pid, 0);\n return true;\n } catch (error) {\n return Predicate.hasProperty(error, \"code\") && error.code === \"EPERM\";\n }\n};\n\n/**\n * Hold an exclusive lock file for the ambient scope, waiting up to `wait` for\n * another holder or failing with `held` at once when `wait` is omitted.\n *\n * The holder, `{ pid, token }`, is written to a private claim file and\n * published with a hard link, which fails when the lock exists, so a visible\n * lock always names its holder. A lock whose holder has exited is removed only\n * under `<file>.recovery`, after re-reading that the same dead holder still\n * owns it, so a successor's lock is never removed in its place. Publishing and\n * recovering are uninterruptible: Node cannot cancel a link or unlink it has\n * started, so stopping early would let one land after `.recovery` is released.\n * The recovery lock is never reclaimed: a crash inside its few file operations\n * leaves waiters timing out rather than overlapping. A timeout that lands while\n * an attempt succeeds still fails, and the published lock is removed only when\n * the ambient scope closes.\n */\nexport const acquire = Effect.fn(\"FileLock.acquire\")(function* (\n file: string,\n wait?: Duration.Input,\n) {\n const fs = yield* FileSystem.FileSystem;\n const path = yield* Path.Path;\n const crypto = yield* Crypto.Crypto;\n const failed = () => new FileLockError({ reason: \"filesystem\" });\n const token = Buffer.from(\n yield* crypto.randomBytes(16).pipe(Effect.mapError(failed)),\n ).toString(\"hex\");\n const holder = yield* Schema.encodeEffect(Holder)({\n pid: process.pid,\n token,\n }).pipe(Effect.mapError(failed));\n const claim = `${file}.${token}`;\n const recovery = `${file}.recovery`;\n const removeIfOwned = (target: string) =>\n fs.readFileString(target).pipe(\n Effect.flatMap((content) =>\n content === holder ? fs.remove(target) : Effect.void,\n ),\n Effect.ignore,\n );\n yield* Effect.addFinalizer(() =>\n Effect.all([\n removeIfOwned(file),\n fs.remove(claim, { force: true }).pipe(Effect.ignore),\n ]),\n );\n yield* fs\n .makeDirectory(path.dirname(file), { recursive: true })\n .pipe(Effect.mapError(failed));\n yield* fs\n .writeFileString(claim, holder, { mode: 0o600 })\n .pipe(Effect.mapError(failed));\n\n const read = (target: string) =>\n fs.readFileString(target).pipe(\n Effect.map(decodeHolder),\n Effect.orElseSucceed(() => Option.none()),\n );\n const publish = (target: string) =>\n fs.link(claim, target).pipe(\n Effect.as(true),\n Effect.catchReason(\"PlatformError\", \"AlreadyExists\", () =>\n Effect.succeed(false),\n ),\n );\n // Whether a dead holder's lock was removed.\n const reclaim = Effect.gen(function* () {\n const stale = yield* read(file);\n if (Option.isNone(stale) || isAlive(stale.value.pid)) return false;\n if (!(yield* publish(recovery))) return false;\n return yield* read(file).pipe(\n Effect.flatMap((current) =>\n Option.isSome(current) && current.value.token === stale.value.token\n ? fs.remove(file).pipe(Effect.as(true))\n : Effect.succeed(false),\n ),\n Effect.ensuring(removeIfOwned(recovery)),\n );\n });\n const attempt = publish(file).pipe(\n Effect.flatMap((acquired) =>\n acquired\n ? Effect.succeed(true)\n : Effect.flatMap(reclaim, (removed) =>\n removed ? publish(file) : Effect.succeed(false),\n ),\n ),\n Effect.uninterruptible,\n Effect.mapError(failed),\n );\n\n if (wait === undefined) {\n if (!(yield* attempt)) return yield* new FileLockError({ reason: \"held\" });\n } else {\n yield* attempt.pipe(\n Effect.repeat({\n until: (acquired) => acquired,\n schedule: Schedule.spaced(\"100 millis\"),\n }),\n Effect.timeoutOrElse({\n duration: wait,\n orElse: () => Effect.fail(new FileLockError({ reason: \"timeout\" })),\n }),\n );\n }\n yield* fs.remove(claim, { force: true }).pipe(Effect.ignore);\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"FileLock.js","names":[],"sources":["../../src/internal/FileLock.ts"],"sourcesContent":["import * as SecureRandom from \"effect/crypto/SecureRandom\";\nimport type * as Duration from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as FileSystem from \"effect/FileSystem\";\nimport * as Option from \"effect/Option\";\nimport * as Path from \"effect/Path\";\nimport * as Predicate from \"effect/Predicate\";\nimport * as Schedule from \"effect/Schedule\";\nimport * as Schema from \"effect/Schema\";\n\nexport class FileLockError extends Schema.TaggedError<\n FileLockError,\n { readonly brand: unique symbol }\n>()(\"FileLockError\", {\n reason: Schema.Literals([\"held\", \"timeout\", \"filesystem\"]),\n}) {}\n\nconst Holder = Schema.fromJsonString(\n Schema.Struct({ pid: Schema.Finite, token: Schema.String }),\n);\nconst decodeHolder = Schema.decodeUnknownOption(Holder);\n\nconst isAlive = (pid: number) => {\n try {\n process.kill(pid, 0);\n return true;\n } catch (error) {\n return Predicate.hasProperty(error, \"code\") && error.code === \"EPERM\";\n }\n};\n\n/**\n * Hold an exclusive lock file for the ambient scope, waiting up to `wait` for\n * another holder or failing with `held` at once when `wait` is omitted.\n *\n * The holder, `{ pid, token }`, is written to a private claim file and\n * published with a hard link, which fails when the lock exists, so a visible\n * lock always names its holder. A lock whose holder has exited is removed only\n * under `<file>.recovery`, after re-reading that the same dead holder still\n * owns it, so a successor's lock is never removed in its place. Publishing and\n * recovering are uninterruptible: Node cannot cancel a link or unlink it has\n * started, so stopping early would let one land after `.recovery` is released.\n * The recovery lock is never reclaimed: a crash inside its few file operations\n * leaves waiters timing out rather than overlapping. A timeout that lands while\n * an attempt succeeds still fails, and the published lock is removed only when\n * the ambient scope closes.\n *\n * @internal\n */\nexport const acquire = Effect.fn(\"FileLock.acquire\")(function* (\n file: string,\n wait?: Duration.Input,\n) {\n const fs = yield* FileSystem.FileSystem;\n const path = yield* Path.Path;\n const random = yield* SecureRandom.SecureRandom;\n const failed = () => FileLockError.make({ reason: \"filesystem\" });\n const randomBytes2 = yield* random.randomBytes(16);\n const token = Buffer.from(randomBytes2).toString(\"hex\");\n const holder = yield* Schema.encodeEffect(Holder)({\n pid: process.pid,\n token,\n }).pipe(Effect.mapError(failed));\n const claim = `${file}.${token}`;\n const recovery = `${file}.recovery`;\n const removeIfOwned = (target: string) =>\n fs.readFileString(target).pipe(\n Effect.flatMap((content) =>\n content === holder ? fs.remove(target) : Effect.void,\n ),\n Effect.ignore,\n );\n yield* Effect.addFinalizer(() =>\n Effect.all([\n removeIfOwned(file),\n fs.remove(claim, { force: true }).pipe(Effect.ignore),\n ]),\n );\n yield* fs\n .makeDirectory(path.dirname(file), { recursive: true })\n .pipe(Effect.mapError(failed));\n yield* fs\n .writeFileString(claim, holder, { mode: 0o600 })\n .pipe(Effect.mapError(failed));\n\n const read = (target: string) =>\n fs.readFileString(target).pipe(\n Effect.map(decodeHolder),\n Effect.orElseSucceed(() => Option.none()),\n );\n const publish = (target: string) =>\n fs.link(claim, target).pipe(\n Effect.as(true),\n Effect.catchReason(\"PlatformError\", \"AlreadyExists\", () =>\n Effect.succeed(false),\n ),\n );\n // Whether a dead holder's lock was removed.\n const reclaim = Effect.gen(function* () {\n const stale = yield* read(file);\n if (Option.isNone(stale) || isAlive(stale.value.pid)) return false;\n if (!(yield* publish(recovery))) return false;\n return yield* read(file).pipe(\n Effect.flatMap((current) =>\n Option.isSome(current) && current.value.token === stale.value.token\n ? fs.remove(file).pipe(Effect.as(true))\n : Effect.succeed(false),\n ),\n Effect.ensuring(removeIfOwned(recovery)),\n );\n });\n const attempt = publish(file).pipe(\n Effect.flatMap((acquired) =>\n acquired\n ? Effect.succeed(true)\n : Effect.flatMap(reclaim, (removed) =>\n removed ? publish(file) : Effect.succeed(false),\n ),\n ),\n Effect.uninterruptible,\n Effect.mapError(failed),\n );\n\n if (wait === undefined) {\n if (!(yield* attempt)) return yield* FileLockError.make({ reason: \"held\" });\n } else {\n yield* attempt.pipe(\n Effect.repeat({\n until: (acquired) => acquired,\n schedule: Schedule.spaced(\"100 millis\"),\n }),\n Effect.timeoutOrElse({\n duration: wait,\n orElse: () => Effect.fail(FileLockError.make({ reason: \"timeout\" })),\n }),\n );\n }\n yield* fs.remove(claim, { force: true }).pipe(Effect.ignore);\n});\n"],"mappings":"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"}
@@ -2,7 +2,9 @@ import * as Effect from "effect/Effect";
2
2
  import * as Schema from "effect/Schema";
3
3
  declare const LifecycleStateError_base: Schema.Class<LifecycleStateError, Schema.TaggedStruct<"LifecycleStateError", {
4
4
  readonly fqn: Schema.String;
5
- }>, import("effect/Cause").YieldableError>;
5
+ }>, import("effect/Cause").YieldableError & {
6
+ readonly brand: unique symbol;
7
+ }>;
6
8
  export declare class LifecycleStateError extends LifecycleStateError_base {
7
9
  }
8
10
  export declare const checkpointCreate: (fqn: string, instanceId: string, props: object, output?: object | undefined) => Effect.Effect<undefined, LifecycleStateError | import("alchemy/State/State").StateStoreError, never>;
@@ -1 +1 @@
1
- {"version":3,"file":"Lifecycle.d.ts","sourceRoot":"","sources":["../../src/internal/Lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;AAExC,qBAAa,mBAAoB,SAAQ,wBAGxC;CAAG;AAEJ,eAAO,MAAM,gBAAgB,uLAqB5B,CAAC;AAEF,eAAO,MAAM,WAAW,uDAYtB,CAAC"}
1
+ {"version":3,"file":"Lifecycle.d.ts","sources":["../../src/internal/Lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;oBAIpB,OAAO,MAAM;;AAFjC,qBAAa,mBAAoB,SAAQ,wBAGS;CAAG;AAErD,eAAO,MAAM,gBAAgB,uLAyB5B,CAAC;AAEF,eAAO,MAAM,WAAW,uDAYtB,CAAC"}
@@ -5,13 +5,13 @@ import { AdoptPolicy } from "alchemy/AdoptPolicy";
5
5
  import { AlchemyContext } from "alchemy/AlchemyContext";
6
6
  import { Stack } from "alchemy/Stack";
7
7
  import { State } from "alchemy/State/State";
8
- //#region src/internal/Lifecycle.ts
8
+ // src/internal/Lifecycle.ts
9
9
  var LifecycleStateError = class extends Schema.TaggedError()("LifecycleStateError", { fqn: Schema.String }) {};
10
10
  const checkpointCreate = Effect.fn("Lifecycle.checkpointCreate")(function* (fqn, instanceId, props, output) {
11
11
  const stack = yield* Effect.serviceOption(Stack);
12
12
  if (Option.isNone(stack)) return;
13
13
  const state = yield* Effect.serviceOption(State);
14
- if (Option.isNone(state)) return yield* new LifecycleStateError({ fqn });
14
+ if (Option.isNone(state)) return yield* LifecycleStateError.make({ fqn });
15
15
  const store = yield* state.value;
16
16
  const key = {
17
17
  stack: stack.value.name,
@@ -19,7 +19,7 @@ const checkpointCreate = Effect.fn("Lifecycle.checkpointCreate")(function* (fqn,
19
19
  fqn
20
20
  };
21
21
  const row = yield* store.get(key);
22
- if (!row || row.kind === "action" || row.instanceId !== instanceId) return yield* new LifecycleStateError({ fqn });
22
+ if (row === void 0 || row.kind === "action" || row.instanceId !== instanceId) return yield* LifecycleStateError.make({ fqn });
23
23
  if (row.status !== "creating") return;
24
24
  yield* store.set({
25
25
  ...key,
@@ -39,7 +39,6 @@ const shouldAdopt = Effect.fn("Lifecycle.shouldAdopt")(function* (fqn) {
39
39
  const context = yield* Effect.serviceOption(AlchemyContext);
40
40
  return Option.isSome(context) && context.value.adopt;
41
41
  });
42
- //#endregion
43
42
  export { LifecycleStateError, checkpointCreate, shouldAdopt };
44
43
 
45
44
  //# sourceMappingURL=Lifecycle.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Lifecycle.js","names":[],"sources":["../../src/internal/Lifecycle.ts"],"sourcesContent":["import { AdoptPolicy } from \"alchemy/AdoptPolicy\";\nimport { AlchemyContext } from \"alchemy/AlchemyContext\";\nimport { Stack } from \"alchemy/Stack\";\nimport { State } from \"alchemy/State/State\";\nimport * as Effect from \"effect/Effect\";\nimport * as Option from \"effect/Option\";\nimport * as Schema from \"effect/Schema\";\n\nexport class LifecycleStateError extends Schema.TaggedError<LifecycleStateError>()(\n \"LifecycleStateError\",\n { fqn: Schema.String },\n) {}\n\nexport const checkpointCreate = Effect.fn(\"Lifecycle.checkpointCreate\")(\n function* (fqn: string, instanceId: string, props: object, output?: object) {\n const stack = yield* Effect.serviceOption(Stack);\n if (Option.isNone(stack)) return;\n const state = yield* Effect.serviceOption(State);\n if (Option.isNone(state)) return yield* new LifecycleStateError({ fqn });\n const store = yield* state.value;\n const key = { stack: stack.value.name, stage: stack.value.stage, fqn };\n const row = yield* store.get(key);\n if (!row || row.kind === \"action\" || row.instanceId !== instanceId)\n return yield* new LifecycleStateError({ fqn });\n if (row.status !== \"creating\") return;\n yield* store.set({\n ...key,\n value: {\n ...row,\n props,\n ...(output === undefined ? {} : { attr: output }),\n },\n });\n },\n);\n\nexport const shouldAdopt = Effect.fn(\"Lifecycle.shouldAdopt\")(function* (\n fqn: string,\n) {\n const stack = yield* Effect.serviceOption(Stack);\n const resourcePolicy = Option.isSome(stack)\n ? stack.value.resources[fqn]?.Adopt\n : undefined;\n if (resourcePolicy !== undefined) return resourcePolicy;\n const policy = yield* Effect.serviceOption(AdoptPolicy);\n if (Option.isSome(policy)) return policy.value;\n const context = yield* Effect.serviceOption(AlchemyContext);\n return Option.isSome(context) && context.value.adopt;\n});\n"],"mappings":";;;;;;;;AAQA,IAAa,sBAAb,cAAyC,OAAO,YAAiC,CAAC,CAChF,uBACA,EAAE,KAAK,OAAO,OAAO,CACvB,CAAC,CAAC,CAAC;AAEH,MAAa,mBAAmB,OAAO,GAAG,4BAA4B,CAAC,CACrE,WAAW,KAAa,YAAoB,OAAe,QAAiB;CAC1E,MAAM,QAAQ,OAAO,OAAO,cAAc,KAAK;CAC/C,IAAI,OAAO,OAAO,KAAK,GAAG;CAC1B,MAAM,QAAQ,OAAO,OAAO,cAAc,KAAK;CAC/C,IAAI,OAAO,OAAO,KAAK,GAAG,OAAO,OAAO,IAAI,oBAAoB,EAAE,IAAI,CAAC;CACvE,MAAM,QAAQ,OAAO,MAAM;CAC3B,MAAM,MAAM;EAAE,OAAO,MAAM,MAAM;EAAM,OAAO,MAAM,MAAM;EAAO;CAAI;CACrE,MAAM,MAAM,OAAO,MAAM,IAAI,GAAG;CAChC,IAAI,CAAC,OAAO,IAAI,SAAS,YAAY,IAAI,eAAe,YACtD,OAAO,OAAO,IAAI,oBAAoB,EAAE,IAAI,CAAC;CAC/C,IAAI,IAAI,WAAW,YAAY;CAC/B,OAAO,MAAM,IAAI;EACf,GAAG;EACH,OAAO;GACL,GAAG;GACH;GACA,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,OAAO;EACjD;CACF,CAAC;AACH,CACF;AAEA,MAAa,cAAc,OAAO,GAAG,uBAAuB,CAAC,CAAC,WAC5D,KACA;CACA,MAAM,QAAQ,OAAO,OAAO,cAAc,KAAK;CAC/C,MAAM,iBAAiB,OAAO,OAAO,KAAK,IACtC,MAAM,MAAM,UAAU,IAAI,EAAE,QAC5B,KAAA;CACJ,IAAI,mBAAmB,KAAA,GAAW,OAAO;CACzC,MAAM,SAAS,OAAO,OAAO,cAAc,WAAW;CACtD,IAAI,OAAO,OAAO,MAAM,GAAG,OAAO,OAAO;CACzC,MAAM,UAAU,OAAO,OAAO,cAAc,cAAc;CAC1D,OAAO,OAAO,OAAO,OAAO,KAAK,QAAQ,MAAM;AACjD,CAAC"}
1
+ {"version":3,"file":"Lifecycle.js","names":[],"sources":["../../src/internal/Lifecycle.ts"],"sourcesContent":["import { AdoptPolicy } from \"alchemy/AdoptPolicy\";\nimport { AlchemyContext } from \"alchemy/AlchemyContext\";\nimport { Stack } from \"alchemy/Stack\";\nimport { State } from \"alchemy/State/State\";\nimport * as Effect from \"effect/Effect\";\nimport * as Option from \"effect/Option\";\nimport * as Schema from \"effect/Schema\";\n\nexport class LifecycleStateError extends Schema.TaggedError<\n LifecycleStateError,\n { readonly brand: unique symbol }\n>()(\"LifecycleStateError\", { fqn: Schema.String }) {}\n\nexport const checkpointCreate = Effect.fn(\"Lifecycle.checkpointCreate\")(\n function* (fqn: string, instanceId: string, props: object, output?: object) {\n const stack = yield* Effect.serviceOption(Stack);\n if (Option.isNone(stack)) return;\n const state = yield* Effect.serviceOption(State);\n if (Option.isNone(state)) return yield* LifecycleStateError.make({ fqn });\n const store = yield* state.value;\n const key = { stack: stack.value.name, stage: stack.value.stage, fqn };\n const row = yield* store.get(key);\n if (\n row === undefined ||\n row.kind === \"action\" ||\n row.instanceId !== instanceId\n )\n return yield* LifecycleStateError.make({ fqn });\n if (row.status !== \"creating\") return;\n yield* store.set({\n ...key,\n value: {\n ...row,\n props,\n ...(output === undefined ? {} : { attr: output }),\n },\n });\n },\n);\n\nexport const shouldAdopt = Effect.fn(\"Lifecycle.shouldAdopt\")(function* (\n fqn: string,\n) {\n const stack = yield* Effect.serviceOption(Stack);\n const resourcePolicy = Option.isSome(stack)\n ? stack.value.resources[fqn]?.Adopt\n : undefined;\n if (resourcePolicy !== undefined) return resourcePolicy;\n const policy = yield* Effect.serviceOption(AdoptPolicy);\n if (Option.isSome(policy)) return policy.value;\n const context = yield* Effect.serviceOption(AlchemyContext);\n return Option.isSome(context) && context.value.adopt;\n});\n"],"mappings":";;;;;;;;AAQA,IAAa,sBAAb,cAAyC,OAAO,YAG9C,CAAC,CAAC,uBAAuB,EAAE,KAAK,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpD,MAAa,mBAAmB,OAAO,GAAG,4BAA4B,CAAC,CACrE,WAAW,KAAa,YAAoB,OAAe,QAAiB;CAC1E,MAAM,QAAQ,OAAO,OAAO,cAAc,KAAK;CAC/C,IAAI,OAAO,OAAO,KAAK,GAAG;CAC1B,MAAM,QAAQ,OAAO,OAAO,cAAc,KAAK;CAC/C,IAAI,OAAO,OAAO,KAAK,GAAG,OAAO,OAAO,oBAAoB,KAAK,EAAE,IAAI,CAAC;CACxE,MAAM,QAAQ,OAAO,MAAM;CAC3B,MAAM,MAAM;EAAE,OAAO,MAAM,MAAM;EAAM,OAAO,MAAM,MAAM;EAAO;CAAI;CACrE,MAAM,MAAM,OAAO,MAAM,IAAI,GAAG;CAChC,IACE,QAAQ,KAAA,KACR,IAAI,SAAS,YACb,IAAI,eAAe,YAEnB,OAAO,OAAO,oBAAoB,KAAK,EAAE,IAAI,CAAC;CAChD,IAAI,IAAI,WAAW,YAAY;CAC/B,OAAO,MAAM,IAAI;EACf,GAAG;EACH,OAAO;GACL,GAAG;GACH;GACA,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,OAAO;EACjD;CACF,CAAC;AACH,CACF;AAEA,MAAa,cAAc,OAAO,GAAG,uBAAuB,CAAC,CAAC,WAC5D,KACA;CACA,MAAM,QAAQ,OAAO,OAAO,cAAc,KAAK;CAC/C,MAAM,iBAAiB,OAAO,OAAO,KAAK,IACtC,MAAM,MAAM,UAAU,IAAI,EAAE,QAC5B,KAAA;CACJ,IAAI,mBAAmB,KAAA,GAAW,OAAO;CACzC,MAAM,SAAS,OAAO,OAAO,cAAc,WAAW;CACtD,IAAI,OAAO,OAAO,MAAM,GAAG,OAAO,OAAO;CACzC,MAAM,UAAU,OAAO,OAAO,cAAc,cAAc;CAC1D,OAAO,OAAO,OAAO,OAAO,KAAK,QAAQ,MAAM;AACjD,CAAC"}
@@ -1,5 +1,5 @@
1
1
  import { Stack } from "alchemy/Stack";
2
- import * as Crypto from "effect/Crypto";
2
+ import * as SecureRandom from "effect/crypto/SecureRandom";
3
3
  import * as Effect from "effect/Effect";
4
4
  import * as FileSystem from "effect/FileSystem";
5
5
  import * as Path from "effect/Path";
@@ -18,7 +18,9 @@ declare const LocalBackendError_base: Schema.Class<LocalBackendError, Schema.Tag
18
18
  readonly deploymentName: Schema.String;
19
19
  readonly reason: Schema.Literals<readonly ["configuration", "filesystem", "install", "identity", "ports", "running", "spawn", "exit", "timeout"]>;
20
20
  readonly exitCode: Schema.optionalKey<Schema.Finite>;
21
- }>, import("effect/Cause").YieldableError>;
21
+ }>, import("effect/Cause").YieldableError & {
22
+ readonly brand: unique symbol;
23
+ }>;
22
24
  export declare class LocalBackendError extends LocalBackendError_base {
23
25
  get message(): string;
24
26
  }
@@ -36,6 +38,8 @@ export interface LocalBackend {
36
38
  * Resolves the directory that holds one local deployment's identity, database,
37
39
  * and file storage: `.alchemy/convex/<stack>/<stage>/<deployment>`. Keyed by
38
40
  * the deployment name because a deploy key resource only knows that name.
41
+ *
42
+ * @internal
39
43
  */
40
44
  export declare const dataDirectories: Effect.Effect<(deploymentName: string) => string, never, Path.Path | Stack>;
41
45
  /**
@@ -58,6 +62,6 @@ export declare const boot: (deploymentName: string, directory: string) => Effect
58
62
  siteUrl: string;
59
63
  adminKey: Redacted.Redacted<string>;
60
64
  exited: Effect.Effect<void, never, never>;
61
- }, LocalBackendError, ChildProcessSpawner.ChildProcessSpawner | Crypto.Crypto | FileSystem.FileSystem | HttpClient.HttpClient | Path.Path | Scope.Scope>;
65
+ }, LocalBackendError, ChildProcessSpawner.ChildProcessSpawner | FileSystem.FileSystem | HttpClient.HttpClient | Path.Path | Scope.Scope | SecureRandom.SecureRandom>;
62
66
  export {};
63
67
  //# sourceMappingURL=LocalBackend.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"LocalBackend.d.ts","sourceRoot":"","sources":["../../src/internal/LocalBackend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAgB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAOnE;;;;GAIG;AACH,eAAO,MAAM,cAAc,mCAAmC,CAAC;;;;;;AAE/D,qBAAa,iBAAkB,SAAQ,sBAiBtC;IACC,IAAa,OAAO,WAsBnB;CACF;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACtC;AAmED;;;;GAIG;AACH,eAAO,MAAM,eAAe,iCASF,MAAM,sCAC9B,CAAC;AAuBH;;GAEG;AACH,eAAO,MAAM,QAAQ,+IAQnB,CAAC;AAEH,eAAO,MAAM,MAAM,8GAYjB,CAAC;AA0CH;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI;;;;;wJAiOf,CAAC"}
1
+ {"version":3,"file":"LocalBackend.d.ts","sources":["../../src/internal/LocalBackend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,KAAK,YAAY,MAAM,4BAA4B,CAAC;AAE3D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAgB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAUnE;;;;GAIG;AACH,eAAO,MAAM,cAAc,mCAAmC,CAAC;;;;;;oBAI3C,OAAO,MAAM;;AAFjC,qBAAa,iBAAkB,SAAQ,sBAiBrC;IACA,IAAa,OAAO,WAsBnB;CACF;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACtC;AAmED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,iCAUF,MAAM,sCAC9B,CAAC;AAuBH;;GAEG;AACH,eAAO,MAAM,QAAQ,+IAWnB,CAAC;AAEH,eAAO,MAAM,MAAM,8GAYjB,CAAC;AA0CH;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI;;;;;oKA8Nf,CAAC"}
@@ -1,6 +1,6 @@
1
- import { origin, parsePortRange } from "./Loopback.js";
2
1
  import { processEnvironment } from "./CommandRunner.js";
3
2
  import { acquire } from "./FileLock.js";
3
+ import { origin, parsePortRange } from "./Loopback.js";
4
4
  import { userCache } from "./UserCache.js";
5
5
  import { extract } from "./Zip.js";
6
6
  import * as Effect from "effect/Effect";
@@ -11,8 +11,11 @@ import * as Redacted from "effect/Redacted";
11
11
  import * as Schema from "effect/Schema";
12
12
  import * as HttpClient from "effect/http/HttpClient";
13
13
  import * as Option from "effect/Option";
14
+ import * as Str from "effect/String";
15
+ import { pipe } from "effect/Function";
16
+ import * as Array from "effect/Array";
14
17
  import { ChildProcess, ChildProcessSpawner } from "effect/process";
15
- import * as Crypto from "effect/Crypto";
18
+ import * as SecureRandom from "effect/crypto/SecureRandom";
16
19
  import * as Scope from "effect/Scope";
17
20
  import * as Schedule from "effect/Schedule";
18
21
  import { dotAlchemyDirectory } from "alchemy/AlchemyContext";
@@ -22,7 +25,7 @@ import * as Deferred from "effect/Deferred";
22
25
  import * as Exit from "effect/Exit";
23
26
  import * as Semaphore from "effect/Semaphore";
24
27
  import * as Stream from "effect/Stream";
25
- //#region src/internal/LocalBackend.ts
28
+ // src/internal/LocalBackend.ts
26
29
  /**
27
30
  * The backend release a new local deployment runs. An existing data directory
28
31
  * keeps running the release that created it, so upgrading this package never
@@ -85,7 +88,7 @@ const listen = (port) => Effect.acquireRelease(Effect.callback((resume) => {
85
88
  const server = createServer();
86
89
  server.once("error", () => resume(Effect.undefined));
87
90
  server.listen(port, "127.0.0.1", () => resume(Effect.succeed(server)));
88
- }), (server) => server ? close(server) : Effect.void);
91
+ }), (server) => server !== void 0 ? close(server) : Effect.void);
89
92
  const isFree = (port) => listen(port).pipe(Effect.map((server) => server !== void 0), Effect.scoped);
90
93
  const portOf = (server) => {
91
94
  const address = server?.address();
@@ -96,17 +99,20 @@ const startup = Semaphore.makeUnsafe(1);
96
99
  * Resolves the directory that holds one local deployment's identity, database,
97
100
  * and file storage: `.alchemy/convex/<stack>/<stage>/<deployment>`. Keyed by
98
101
  * the deployment name because a deploy key resource only knows that name.
102
+ *
103
+ * @internal
99
104
  */
100
105
  const dataDirectories = Effect.gen(function* () {
101
106
  const path = yield* Path.Path;
102
107
  const stack = yield* Stack;
103
- const root = path.resolve(yield* dotAlchemyDirectory, "convex", stack.name, stack.stage);
108
+ const dotAlchemyDirectoryValue = yield* dotAlchemyDirectory;
109
+ const root = path.resolve(dotAlchemyDirectoryValue, "convex", stack.name, stack.stage);
104
110
  return (deploymentName) => path.join(root, deploymentName);
105
111
  });
106
112
  const readIdentity = Effect.fn("LocalBackend.readIdentity")(function* (deploymentName, directory) {
107
113
  const fs = yield* FileSystem.FileSystem;
108
114
  const file = (yield* Path.Path).join(directory, "identity.json");
109
- const invalid = () => new LocalBackendError({
115
+ const invalid = () => LocalBackendError.make({
110
116
  deploymentName,
111
117
  reason: "identity"
112
118
  });
@@ -120,7 +126,7 @@ const readIdentity = Effect.fn("LocalBackend.readIdentity")(function* (deploymen
120
126
  */
121
127
  const adminKey = Effect.fn("LocalBackend.adminKey")(function* (deploymentName, directory) {
122
128
  const identity = yield* readIdentity(deploymentName, directory);
123
- if (Option.isNone(identity)) return yield* new LocalBackendError({
129
+ if (Option.isNone(identity)) return yield* LocalBackendError.make({
124
130
  deploymentName,
125
131
  reason: "identity"
126
132
  });
@@ -130,7 +136,7 @@ const remove = Effect.fn("LocalBackend.remove")(function* (deploymentName, direc
130
136
  yield* (yield* FileSystem.FileSystem).remove(directory, {
131
137
  recursive: true,
132
138
  force: true
133
- }).pipe(Effect.mapError(() => new LocalBackendError({
139
+ }).pipe(Effect.mapError(() => LocalBackendError.make({
134
140
  deploymentName,
135
141
  reason: "filesystem"
136
142
  })));
@@ -143,7 +149,7 @@ const install = Effect.fn("LocalBackend.install")(function* (deploymentName, ver
143
149
  const fs = yield* FileSystem.FileSystem;
144
150
  const path = yield* Path.Path;
145
151
  const http = yield* HttpClient.HttpClient;
146
- const failed = () => new LocalBackendError({
152
+ const failed = () => LocalBackendError.make({
147
153
  deploymentName,
148
154
  reason: "install"
149
155
  });
@@ -185,8 +191,8 @@ const boot = Effect.fn("LocalBackend.boot")(function* (deploymentName, directory
185
191
  const fs = yield* FileSystem.FileSystem;
186
192
  const http = yield* HttpClient.HttpClient;
187
193
  const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
188
- const crypto = yield* Crypto.Crypto;
189
- const fail = (reason, exitCode) => new LocalBackendError({
194
+ const random = yield* SecureRandom.SecureRandom;
195
+ const fail = (reason, exitCode) => LocalBackendError.make({
190
196
  deploymentName,
191
197
  reason,
192
198
  ...exitCode === void 0 ? {} : { exitCode }
@@ -207,7 +213,7 @@ const boot = Effect.fn("LocalBackend.boot")(function* (deploymentName, directory
207
213
  const answer = (url) => http.get(`${url}/instance_name`).pipe(Effect.flatMap((response) => response.status === 200 ? response.text : Effect.undefined), Effect.orElseSucceed(() => void 0));
208
214
  const allocate = Effect.gen(function* () {
209
215
  if (Option.isNone(range) || Option.isNone(range.value)) {
210
- const [port, sitePort] = yield* Effect.all([listen(0), listen(0)]).pipe(Effect.map((servers) => servers.map(portOf)), Effect.scoped);
216
+ const [port, sitePort] = yield* Effect.all([listen(0), listen(0)]).pipe(Effect.map((servers) => Array.map(servers, portOf)), Effect.scoped);
211
217
  if (port === void 0 || sitePort === void 0) return yield* fail("ports");
212
218
  return {
213
219
  port,
@@ -225,8 +231,9 @@ const boot = Effect.fn("LocalBackend.boot")(function* (deploymentName, directory
225
231
  };
226
232
  });
227
233
  const generate = (binary) => Effect.gen(function* () {
228
- const instanceSecret = Buffer.from(yield* crypto.randomBytes(32)).toString("hex");
229
- const key = (yield* spawner.string(ChildProcess.make(binary, [
234
+ const randomBytes2 = yield* random.randomBytes(32);
235
+ const instanceSecret = Buffer.from(randomBytes2).toString("hex");
236
+ const output = yield* spawner.string(ChildProcess.make(binary, [
230
237
  "keygen",
231
238
  "admin-key",
232
239
  "--instance-name",
@@ -238,8 +245,9 @@ const boot = Effect.fn("LocalBackend.boot")(function* (deploymentName, directory
238
245
  extendEnv: false,
239
246
  stdin: "ignore",
240
247
  stderr: "ignore"
241
- }))).trim();
242
- if (!key.startsWith(`${deploymentName}|`)) return yield* fail("identity");
248
+ }));
249
+ const key = pipe(output, Str.trim);
250
+ if (!pipe(key, Str.startsWith(`${deploymentName}|`))) return yield* fail("identity");
243
251
  return {
244
252
  instanceSecret,
245
253
  adminKey: key
@@ -248,7 +256,8 @@ const boot = Effect.fn("LocalBackend.boot")(function* (deploymentName, directory
248
256
  const save = (identity) => Effect.gen(function* () {
249
257
  const file = path.join(directory, "identity.json");
250
258
  const temp = `${file}.${process.pid}.tmp`;
251
- yield* fs.writeFileString(temp, yield* Schema.encodeEffect(Identity)(identity), { mode: 384 });
259
+ const encoded = yield* Schema.encodeEffect(Identity)(identity);
260
+ yield* fs.writeFileString(temp, encoded, { mode: 384 });
252
261
  yield* fs.rename(temp, file);
253
262
  }).pipe(Effect.uninterruptible, Effect.mapError(() => fail("identity")));
254
263
  const session = yield* Scope.Scope;
@@ -327,7 +336,6 @@ const boot = Effect.fn("LocalBackend.boot")(function* (deploymentName, directory
327
336
  });
328
337
  return yield* startup.withPermits(1)(start).pipe(Scope.provide(owned), Effect.onExit((exit) => Exit.isSuccess(exit) ? Effect.void : Scope.close(owned, exit)));
329
338
  });
330
- //#endregion
331
339
  export { LocalBackendError, adminKey, backendVersion, boot, dataDirectories, remove };
332
340
 
333
341
  //# sourceMappingURL=LocalBackend.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"LocalBackend.js","names":["Loopback.parsePortRange","FileLock.acquire","Loopback.origin"],"sources":["../../src/internal/LocalBackend.ts"],"sourcesContent":["import { createServer, type Server } from \"node:net\";\nimport { dotAlchemyDirectory } from \"alchemy/AlchemyContext\";\nimport { Stack } from \"alchemy/Stack\";\nimport * as Config from \"effect/Config\";\nimport * as Crypto from \"effect/Crypto\";\nimport * as Deferred from \"effect/Deferred\";\nimport * as Effect from \"effect/Effect\";\nimport * as Exit from \"effect/Exit\";\nimport * as FileSystem from \"effect/FileSystem\";\nimport * as Option from \"effect/Option\";\nimport * as Path from \"effect/Path\";\nimport * as Redacted from \"effect/Redacted\";\nimport * as Schedule from \"effect/Schedule\";\nimport * as Schema from \"effect/Schema\";\nimport * as Scope from \"effect/Scope\";\nimport * as Semaphore from \"effect/Semaphore\";\nimport * as Stream from \"effect/Stream\";\nimport * as HttpClient from \"effect/http/HttpClient\";\nimport { ChildProcess, ChildProcessSpawner } from \"effect/process\";\nimport { processEnvironment } from \"./CommandRunner.js\";\nimport * as FileLock from \"./FileLock.js\";\nimport * as Loopback from \"./Loopback.js\";\nimport { userCache } from \"./UserCache.js\";\nimport { extract } from \"./Zip.js\";\n\n/**\n * The backend release a new local deployment runs. An existing data directory\n * keeps running the release that created it, so upgrading this package never\n * opens a database with a different release.\n */\nexport const backendVersion = \"precompiled-2026-10-28-cccbade\";\n\nexport class LocalBackendError extends Schema.TaggedError<LocalBackendError>()(\n \"LocalBackendError\",\n {\n deploymentName: Schema.String,\n reason: Schema.Literals([\n \"configuration\",\n \"filesystem\",\n \"install\",\n \"identity\",\n \"ports\",\n \"running\",\n \"spawn\",\n \"exit\",\n \"timeout\",\n ]),\n exitCode: Schema.optionalKey(Schema.Finite),\n },\n) {\n override get message() {\n const subject = `Local backend for ${this.deploymentName}`;\n switch (this.reason) {\n case \"configuration\":\n return `${subject} needs a home directory and, when set, CONFECT_LOCAL_BACKEND_PORTS as a range such as 3300-3399`;\n case \"filesystem\":\n return `${subject} could not read or write its data directory`;\n case \"install\":\n return `${subject} could not download or install the backend binary`;\n case \"identity\":\n return `${subject} could not read, create, or save its identity`;\n case \"ports\":\n return `${subject} could not get its ports; another process is using them`;\n case \"running\":\n return `${subject} is already running: stop the other alchemy dev session, or the backend process left over from one, that serves its data directory`;\n case \"spawn\":\n return `${subject} could not be started`;\n case \"exit\":\n return `${subject} exited${this.exitCode === undefined ? \"\" : ` with code ${this.exitCode}`} before it was ready`;\n case \"timeout\":\n return `${subject} did not become ready in time`;\n }\n }\n}\n\nexport interface LocalBackend {\n readonly url: string;\n readonly siteUrl: string;\n readonly adminKey: Redacted.Redacted<string>;\n /**\n * Completes when the backend process has exited and released its data\n * directory, so the deployment can be booted again.\n */\n readonly exited: Effect.Effect<void>;\n}\n\n// Ports are saved once a backend has answered on them, so a first start that\n// fails picks fresh ports next time instead of keeping ones that never worked.\nconst Identity = Schema.fromJsonString(\n Schema.Struct({\n name: Schema.String,\n version: Schema.String,\n instanceSecret: Schema.String,\n adminKey: Schema.String,\n ports: Schema.optionalKey(\n Schema.Struct({ port: Schema.Int, sitePort: Schema.Int }),\n ),\n }),\n);\ntype Identity = typeof Identity.Type;\n\n// The release archive per platform, as the Convex CLI maps it\n// (convex-js src/cli/lib/localDeployment/download.ts getDownloadPath).\nconst artifacts: Readonly<Record<string, string>> = {\n \"darwin-arm64\": \"convex-local-backend-aarch64-apple-darwin.zip\",\n \"darwin-x64\": \"convex-local-backend-x86_64-apple-darwin.zip\",\n \"linux-arm64\": \"convex-local-backend-aarch64-unknown-linux-gnu.zip\",\n \"linux-x64\": \"convex-local-backend-x86_64-unknown-linux-gnu.zip\",\n \"win32-arm64\": \"convex-local-backend-x86_64-pc-windows-msvc.zip\",\n \"win32-x64\": \"convex-local-backend-x86_64-pc-windows-msvc.zip\",\n};\nconst executable =\n process.platform === \"win32\"\n ? \"convex-local-backend.exe\"\n : \"convex-local-backend\";\n\nconst close = (server: Server) =>\n Effect.callback<void>((resume) => {\n server.close(() => resume(Effect.void));\n });\n\n// A server listening on `port`, or undefined when the port is taken, closed\n// with the scope. Listening is uninterruptible, so an interrupted probe never\n// leaves a server bound to the port.\nconst listen = (port: number) =>\n Effect.acquireRelease(\n Effect.callback<Server | undefined>((resume) => {\n const server = createServer();\n server.once(\"error\", () => resume(Effect.undefined));\n server.listen(port, \"127.0.0.1\", () => resume(Effect.succeed(server)));\n }),\n (server) => (server ? close(server) : Effect.void),\n );\n\nconst isFree = (port: number) =>\n listen(port).pipe(\n Effect.map((server) => server !== undefined),\n Effect.scoped,\n );\n\nconst portOf = (server: Server | undefined) => {\n const address = server?.address();\n return typeof address === \"object\" && address !== null\n ? address.port\n : undefined;\n};\n\n// Backends in one process start one at a time, so two deployments starting\n// together never probe and claim the same ports.\nconst startup = Semaphore.makeUnsafe(1);\n\n/**\n * Resolves the directory that holds one local deployment's identity, database,\n * and file storage: `.alchemy/convex/<stack>/<stage>/<deployment>`. Keyed by\n * the deployment name because a deploy key resource only knows that name.\n */\nexport const dataDirectories = Effect.gen(function* () {\n const path = yield* Path.Path;\n const stack = yield* Stack;\n const root = path.resolve(\n yield* dotAlchemyDirectory,\n \"convex\",\n stack.name,\n stack.stage,\n );\n return (deploymentName: string) => path.join(root, deploymentName);\n});\n\nconst readIdentity = Effect.fn(\"LocalBackend.readIdentity\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const fs = yield* FileSystem.FileSystem;\n const path = yield* Path.Path;\n const file = path.join(directory, \"identity.json\");\n const invalid = () =>\n new LocalBackendError({ deploymentName, reason: \"identity\" });\n if (!(yield* fs.exists(file).pipe(Effect.mapError(invalid))))\n return Option.none<Identity>();\n const identity = yield* fs\n .readFileString(file)\n .pipe(\n Effect.flatMap(Schema.decodeEffect(Identity)),\n Effect.mapError(invalid),\n );\n if (identity.name !== deploymentName) return yield* invalid();\n return Option.some(identity);\n});\n\n/**\n * The admin key of a local deployment, for its deploy key resource.\n */\nexport const adminKey = Effect.fn(\"LocalBackend.adminKey\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const identity = yield* readIdentity(deploymentName, directory);\n if (Option.isNone(identity))\n return yield* new LocalBackendError({ deploymentName, reason: \"identity\" });\n return Redacted.make(identity.value.adminKey);\n});\n\nexport const remove = Effect.fn(\"LocalBackend.remove\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const fs = yield* FileSystem.FileSystem;\n yield* fs\n .remove(directory, { recursive: true, force: true })\n .pipe(\n Effect.mapError(\n () => new LocalBackendError({ deploymentName, reason: \"filesystem\" }),\n ),\n );\n});\n\n/**\n * Install a backend release into the Convex CLI's binary cache,\n * `<cache>/convex/binaries/<version>/`, unless it is already there.\n */\nconst install = Effect.fn(\"LocalBackend.install\")(function* (\n deploymentName: string,\n version: string,\n cache: string,\n) {\n const fs = yield* FileSystem.FileSystem;\n const path = yield* Path.Path;\n const http = yield* HttpClient.HttpClient;\n const failed = () =>\n new LocalBackendError({ deploymentName, reason: \"install\" });\n const binaries = path.join(cache, \"convex\", \"binaries\");\n const binary = path.join(binaries, version, executable);\n const artifact = artifacts[`${process.platform}-${process.arch}`];\n return yield* Effect.gen(function* () {\n if (yield* fs.exists(binary)) return binary;\n if (artifact === undefined) return yield* failed();\n yield* fs.makeDirectory(binaries, { recursive: true });\n const temp = yield* fs.makeTempDirectoryScoped({\n directory: binaries,\n prefix: \".download-\",\n });\n const archive = path.join(temp, artifact);\n const response = yield* http.get(\n `https://github.com/get-convex/convex-backend/releases/download/${version}/${artifact}`,\n );\n if (response.status !== 200) return yield* failed();\n yield* response.stream.pipe(Stream.run(fs.sink(archive)));\n const extracted = path.join(temp, executable);\n yield* extract(archive, executable, extracted);\n yield* fs.chmod(extracted, 0o755);\n yield* fs.makeDirectory(path.dirname(binary), { recursive: true });\n yield* fs.rename(extracted, binary);\n return binary;\n }).pipe(Effect.scoped, Effect.mapError(failed));\n});\n\n/**\n * Boot the local backend for one deployment and keep it running for the ambient\n * scope. The process and the data directory's `owner.lock` share a child scope\n * that closes when the boot fails or is interrupted and when the process exits,\n * so a deployment can be booted again in the same session. The first boot\n * installs the pinned release, generates an instance secret and admin key, and\n * picks two free loopback ports; later boots reuse all of them, so stored\n * credentials and URLs stay valid. A saved port that something else now holds\n * is an error rather than a move, because resources keep the URL.\n */\nexport const boot = Effect.fn(\"LocalBackend.boot\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const path = yield* Path.Path;\n const fs = yield* FileSystem.FileSystem;\n const http = yield* HttpClient.HttpClient;\n const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;\n const crypto = yield* Crypto.Crypto;\n const fail = (reason: LocalBackendError[\"reason\"], exitCode?: number) =>\n new LocalBackendError({\n deploymentName,\n reason,\n ...(exitCode === undefined ? {} : { exitCode }),\n });\n const settings = yield* Config.all({\n environment: processEnvironment,\n ports: Config.String(\"CONFECT_LOCAL_BACKEND_PORTS\").pipe(Config.option),\n }).pipe(Effect.mapError(() => fail(\"configuration\")));\n const cache = yield* userCache.pipe(\n Effect.mapError(() => fail(\"configuration\")),\n );\n if (Option.isNone(cache)) return yield* fail(\"configuration\");\n const range = Option.map(settings.ports, Loopback.parsePortRange);\n if (Option.isSome(range) && Option.isNone(range.value))\n return yield* fail(\"configuration\");\n const env = {\n ...settings.environment,\n DISABLE_BEACON: \"1\",\n DO_NOT_TRACK: \"1\",\n };\n\n const answer = (url: string) =>\n http.get(`${url}/instance_name`).pipe(\n Effect.flatMap((response) =>\n response.status === 200 ? response.text : Effect.undefined,\n ),\n Effect.orElseSucceed(() => undefined),\n );\n\n const allocate = Effect.gen(function* () {\n if (Option.isNone(range) || Option.isNone(range.value)) {\n // A closed server no longer has an address.\n const [port, sitePort] = yield* Effect.all([listen(0), listen(0)]).pipe(\n Effect.map((servers) => servers.map(portOf)),\n Effect.scoped,\n );\n if (port === undefined || sitePort === undefined)\n return yield* fail(\"ports\");\n return { port, sitePort };\n }\n const free: number[] = [];\n const { from, to } = range.value.value;\n for (let port = from; port <= to && free.length < 2; port++) {\n if (yield* isFree(port)) free.push(port);\n }\n const [port, sitePort] = free;\n if (port === undefined || sitePort === undefined)\n return yield* fail(\"ports\");\n return { port, sitePort };\n });\n\n const generate = (binary: string) =>\n Effect.gen(function* () {\n const instanceSecret = Buffer.from(\n yield* crypto.randomBytes(32),\n ).toString(\"hex\");\n const output = yield* spawner.string(\n ChildProcess.make(\n binary,\n [\n \"keygen\",\n \"admin-key\",\n \"--instance-name\",\n deploymentName,\n \"--instance-secret\",\n instanceSecret,\n ],\n { env, extendEnv: false, stdin: \"ignore\", stderr: \"ignore\" },\n ),\n );\n const key = output.trim();\n if (!key.startsWith(`${deploymentName}|`)) return yield* fail(\"identity\");\n return { instanceSecret, adminKey: key };\n }).pipe(\n Effect.catchTag(\"PlatformError\", () => Effect.fail(fail(\"identity\"))),\n );\n\n const save = (identity: Identity) =>\n Effect.gen(function* () {\n const file = path.join(directory, \"identity.json\");\n const temp = `${file}.${process.pid}.tmp`;\n yield* fs.writeFileString(\n temp,\n yield* Schema.encodeEffect(Identity)(identity),\n { mode: 0o600 },\n );\n yield* fs.rename(temp, file);\n }).pipe(\n // Node cannot cancel a write or rename it has started; finishing it\n // keeps a pending rename from landing after owner.lock is released.\n Effect.uninterruptible,\n Effect.mapError(() => fail(\"identity\")),\n );\n\n const session = yield* Scope.Scope;\n const owned = yield* Scope.fork(session);\n const stopped = yield* Deferred.make<void>();\n // Registered first, so it runs after the process and owner.lock finalizers\n // however the scope closes.\n yield* Scope.addFinalizer(owned, Deferred.succeed(stopped, undefined));\n const start = Effect.gen(function* () {\n yield* FileLock.acquire(path.join(directory, \"owner.lock\")).pipe(\n Effect.mapError((error) =>\n fail(error.reason === \"held\" ? \"running\" : \"filesystem\"),\n ),\n );\n const saved = yield* readIdentity(deploymentName, directory);\n const version = Option.isSome(saved) ? saved.value.version : backendVersion;\n const binary = yield* install(deploymentName, version, cache.value);\n let identity: Identity;\n if (Option.isSome(saved)) {\n identity = saved.value;\n } else {\n identity = {\n name: deploymentName,\n version,\n ...(yield* generate(binary)),\n };\n yield* save(identity);\n }\n const ports = identity.ports ?? (yield* allocate);\n if (identity.ports !== undefined) {\n if (!(yield* isFree(ports.port)) || !(yield* isFree(ports.sitePort)))\n return yield* fail(\n (yield* answer(Loopback.origin(ports.port))) === deploymentName\n ? \"running\"\n : \"ports\",\n );\n }\n\n const url = Loopback.origin(ports.port);\n const siteUrl = Loopback.origin(ports.sitePort);\n const handle = yield* spawner\n .spawn(\n ChildProcess.make(\n binary,\n [\n \"--interface\",\n \"127.0.0.1\",\n \"--port\",\n String(ports.port),\n \"--site-proxy-port\",\n String(ports.sitePort),\n \"--instance-name\",\n deploymentName,\n \"--instance-secret\",\n identity.instanceSecret,\n \"--convex-origin\",\n url,\n \"--convex-site\",\n siteUrl,\n \"--local-storage\",\n path.join(directory, \"convex_local_storage\"),\n \"--disable-beacon\",\n path.join(directory, \"convex_local_backend.sqlite3\"),\n ],\n {\n cwd: directory,\n env,\n extendEnv: false,\n stdin: \"ignore\",\n stdout: \"ignore\",\n stderr: \"ignore\",\n forceKillAfter: \"3 seconds\",\n },\n ),\n )\n .pipe(Effect.mapError(() => fail(\"spawn\")));\n\n const ready = answer(url).pipe(\n Effect.flatMap((name) =>\n name === undefined || name === deploymentName\n ? Effect.succeed(name === deploymentName)\n : Effect.fail(fail(\"ports\")),\n ),\n Effect.repeat({\n until: (isReady) => isReady,\n schedule: Schedule.spaced(\"100 millis\"),\n }),\n );\n const exit = handle.exitCode.pipe(\n Effect.mapError(() => fail(\"exit\")),\n Effect.flatMap((code) => Effect.fail(fail(\"exit\", Number(code)))),\n );\n yield* Effect.raceFirst(ready, exit).pipe(\n Effect.timeoutOrElse({\n duration: \"60 seconds\",\n orElse: () => Effect.fail(fail(\"timeout\")),\n }),\n );\n if (identity.ports === undefined) yield* save({ ...identity, ports });\n // An exited backend releases the data directory before `exited`\n // completes, so the deployment can be booted again in this session.\n yield* handle.exitCode.pipe(\n Effect.ignore,\n Effect.andThen(Scope.close(owned, Exit.void)),\n Effect.forkIn(session),\n );\n return {\n url,\n siteUrl,\n adminKey: Redacted.make(identity.adminKey),\n exited: Deferred.await(stopped),\n } satisfies LocalBackend;\n });\n\n return yield* startup\n .withPermits(1)(start)\n .pipe(\n Scope.provide(owned),\n Effect.onExit((exit) =>\n Exit.isSuccess(exit) ? Effect.void : Scope.close(owned, exit),\n ),\n );\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"LocalBackend.js","names":["Loopback.parsePortRange","FileLock.acquire","Loopback.origin"],"sources":["../../src/internal/LocalBackend.ts"],"sourcesContent":["import { createServer, type Server } from \"node:net\";\nimport { dotAlchemyDirectory } from \"alchemy/AlchemyContext\";\nimport { Stack } from \"alchemy/Stack\";\nimport * as Config from \"effect/Config\";\nimport * as SecureRandom from \"effect/crypto/SecureRandom\";\nimport * as Deferred from \"effect/Deferred\";\nimport * as Effect from \"effect/Effect\";\nimport * as Exit from \"effect/Exit\";\nimport * as FileSystem from \"effect/FileSystem\";\nimport * as Option from \"effect/Option\";\nimport * as Path from \"effect/Path\";\nimport * as Redacted from \"effect/Redacted\";\nimport * as Schedule from \"effect/Schedule\";\nimport * as Schema from \"effect/Schema\";\nimport * as Scope from \"effect/Scope\";\nimport * as Semaphore from \"effect/Semaphore\";\nimport * as Stream from \"effect/Stream\";\nimport * as HttpClient from \"effect/http/HttpClient\";\nimport { ChildProcess, ChildProcessSpawner } from \"effect/process\";\nimport { processEnvironment } from \"./CommandRunner.js\";\nimport * as FileLock from \"./FileLock.js\";\nimport * as Loopback from \"./Loopback.js\";\nimport { userCache } from \"./UserCache.js\";\nimport { extract } from \"./Zip.js\";\nimport * as Str from \"effect/String\";\nimport { pipe } from \"effect/Function\";\nimport * as Array from \"effect/Array\";\n\n/**\n * The backend release a new local deployment runs. An existing data directory\n * keeps running the release that created it, so upgrading this package never\n * opens a database with a different release.\n */\nexport const backendVersion = \"precompiled-2026-10-28-cccbade\";\n\nexport class LocalBackendError extends Schema.TaggedError<\n LocalBackendError,\n { readonly brand: unique symbol }\n>()(\"LocalBackendError\", {\n deploymentName: Schema.String,\n reason: Schema.Literals([\n \"configuration\",\n \"filesystem\",\n \"install\",\n \"identity\",\n \"ports\",\n \"running\",\n \"spawn\",\n \"exit\",\n \"timeout\",\n ]),\n exitCode: Schema.optionalKey(Schema.Finite),\n}) {\n override get message() {\n const subject = `Local backend for ${this.deploymentName}`;\n switch (this.reason) {\n case \"configuration\":\n return `${subject} needs a home directory and, when set, CONFECT_LOCAL_BACKEND_PORTS as a range such as 3300-3399`;\n case \"filesystem\":\n return `${subject} could not read or write its data directory`;\n case \"install\":\n return `${subject} could not download or install the backend binary`;\n case \"identity\":\n return `${subject} could not read, create, or save its identity`;\n case \"ports\":\n return `${subject} could not get its ports; another process is using them`;\n case \"running\":\n return `${subject} is already running: stop the other alchemy dev session, or the backend process left over from one, that serves its data directory`;\n case \"spawn\":\n return `${subject} could not be started`;\n case \"exit\":\n return `${subject} exited${this.exitCode === undefined ? \"\" : ` with code ${this.exitCode}`} before it was ready`;\n case \"timeout\":\n return `${subject} did not become ready in time`;\n }\n }\n}\n\nexport interface LocalBackend {\n readonly url: string;\n readonly siteUrl: string;\n readonly adminKey: Redacted.Redacted<string>;\n /**\n * Completes when the backend process has exited and released its data\n * directory, so the deployment can be booted again.\n */\n readonly exited: Effect.Effect<void>;\n}\n\n// Ports are saved once a backend has answered on them, so a first start that\n// fails picks fresh ports next time instead of keeping ones that never worked.\nconst Identity = Schema.fromJsonString(\n Schema.Struct({\n name: Schema.String,\n version: Schema.String,\n instanceSecret: Schema.String,\n adminKey: Schema.String,\n ports: Schema.optionalKey(\n Schema.Struct({ port: Schema.Int, sitePort: Schema.Int }),\n ),\n }),\n);\ntype Identity = typeof Identity.Type;\n\n// The release archive per platform, as the Convex CLI maps it\n// (convex-js src/cli/lib/localDeployment/download.ts getDownloadPath).\nconst artifacts: Readonly<Record<string, string>> = {\n \"darwin-arm64\": \"convex-local-backend-aarch64-apple-darwin.zip\",\n \"darwin-x64\": \"convex-local-backend-x86_64-apple-darwin.zip\",\n \"linux-arm64\": \"convex-local-backend-aarch64-unknown-linux-gnu.zip\",\n \"linux-x64\": \"convex-local-backend-x86_64-unknown-linux-gnu.zip\",\n \"win32-arm64\": \"convex-local-backend-x86_64-pc-windows-msvc.zip\",\n \"win32-x64\": \"convex-local-backend-x86_64-pc-windows-msvc.zip\",\n};\nconst executable =\n process.platform === \"win32\"\n ? \"convex-local-backend.exe\"\n : \"convex-local-backend\";\n\nconst close = (server: Server) =>\n Effect.callback<void>((resume) => {\n server.close(() => resume(Effect.void));\n });\n\n// A server listening on `port`, or undefined when the port is taken, closed\n// with the scope. Listening is uninterruptible, so an interrupted probe never\n// leaves a server bound to the port.\nconst listen = (port: number) =>\n Effect.acquireRelease(\n Effect.callback<Server | undefined>((resume) => {\n const server = createServer();\n server.once(\"error\", () => resume(Effect.undefined));\n server.listen(port, \"127.0.0.1\", () => resume(Effect.succeed(server)));\n }),\n (server) => (server !== undefined ? close(server) : Effect.void),\n );\n\nconst isFree = (port: number) =>\n listen(port).pipe(\n Effect.map((server) => server !== undefined),\n Effect.scoped,\n );\n\nconst portOf = (server: Server | undefined) => {\n const address = server?.address();\n return typeof address === \"object\" && address !== null\n ? address.port\n : undefined;\n};\n\n// Backends in one process start one at a time, so two deployments starting\n// together never probe and claim the same ports.\nconst startup = Semaphore.makeUnsafe(1);\n\n/**\n * Resolves the directory that holds one local deployment's identity, database,\n * and file storage: `.alchemy/convex/<stack>/<stage>/<deployment>`. Keyed by\n * the deployment name because a deploy key resource only knows that name.\n *\n * @internal\n */\nexport const dataDirectories = Effect.gen(function* () {\n const path = yield* Path.Path;\n const stack = yield* Stack;\n const dotAlchemyDirectoryValue = yield* dotAlchemyDirectory;\n const root = path.resolve(\n dotAlchemyDirectoryValue,\n \"convex\",\n stack.name,\n stack.stage,\n );\n return (deploymentName: string) => path.join(root, deploymentName);\n});\n\nconst readIdentity = Effect.fn(\"LocalBackend.readIdentity\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const fs = yield* FileSystem.FileSystem;\n const path = yield* Path.Path;\n const file = path.join(directory, \"identity.json\");\n const invalid = () =>\n LocalBackendError.make({ deploymentName, reason: \"identity\" });\n if (!(yield* fs.exists(file).pipe(Effect.mapError(invalid))))\n return Option.none<Identity>();\n const identity = yield* fs\n .readFileString(file)\n .pipe(\n Effect.flatMap(Schema.decodeEffect(Identity)),\n Effect.mapError(invalid),\n );\n if (identity.name !== deploymentName) return yield* invalid();\n return Option.some(identity);\n});\n\n/**\n * The admin key of a local deployment, for its deploy key resource.\n */\nexport const adminKey = Effect.fn(\"LocalBackend.adminKey\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const identity = yield* readIdentity(deploymentName, directory);\n if (Option.isNone(identity))\n return yield* LocalBackendError.make({\n deploymentName,\n reason: \"identity\",\n });\n return Redacted.make(identity.value.adminKey);\n});\n\nexport const remove = Effect.fn(\"LocalBackend.remove\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const fs = yield* FileSystem.FileSystem;\n yield* fs\n .remove(directory, { recursive: true, force: true })\n .pipe(\n Effect.mapError(() =>\n LocalBackendError.make({ deploymentName, reason: \"filesystem\" }),\n ),\n );\n});\n\n/**\n * Install a backend release into the Convex CLI's binary cache,\n * `<cache>/convex/binaries/<version>/`, unless it is already there.\n */\nconst install = Effect.fn(\"LocalBackend.install\")(function* (\n deploymentName: string,\n version: string,\n cache: string,\n) {\n const fs = yield* FileSystem.FileSystem;\n const path = yield* Path.Path;\n const http = yield* HttpClient.HttpClient;\n const failed = () =>\n LocalBackendError.make({ deploymentName, reason: \"install\" });\n const binaries = path.join(cache, \"convex\", \"binaries\");\n const binary = path.join(binaries, version, executable);\n const artifact = artifacts[`${process.platform}-${process.arch}`];\n return yield* Effect.gen(function* () {\n if (yield* fs.exists(binary)) return binary;\n if (artifact === undefined) return yield* failed();\n yield* fs.makeDirectory(binaries, { recursive: true });\n const temp = yield* fs.makeTempDirectoryScoped({\n directory: binaries,\n prefix: \".download-\",\n });\n const archive = path.join(temp, artifact);\n const response = yield* http.get(\n `https://github.com/get-convex/convex-backend/releases/download/${version}/${artifact}`,\n );\n if (response.status !== 200) return yield* failed();\n yield* response.stream.pipe(Stream.run(fs.sink(archive)));\n const extracted = path.join(temp, executable);\n yield* extract(archive, executable, extracted);\n yield* fs.chmod(extracted, 0o755);\n yield* fs.makeDirectory(path.dirname(binary), { recursive: true });\n yield* fs.rename(extracted, binary);\n return binary;\n }).pipe(Effect.scoped, Effect.mapError(failed));\n});\n\n/**\n * Boot the local backend for one deployment and keep it running for the ambient\n * scope. The process and the data directory's `owner.lock` share a child scope\n * that closes when the boot fails or is interrupted and when the process exits,\n * so a deployment can be booted again in the same session. The first boot\n * installs the pinned release, generates an instance secret and admin key, and\n * picks two free loopback ports; later boots reuse all of them, so stored\n * credentials and URLs stay valid. A saved port that something else now holds\n * is an error rather than a move, because resources keep the URL.\n */\nexport const boot = Effect.fn(\"LocalBackend.boot\")(function* (\n deploymentName: string,\n directory: string,\n) {\n const path = yield* Path.Path;\n const fs = yield* FileSystem.FileSystem;\n const http = yield* HttpClient.HttpClient;\n const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;\n const random = yield* SecureRandom.SecureRandom;\n const fail = (reason: LocalBackendError[\"reason\"], exitCode?: number) =>\n LocalBackendError.make({\n deploymentName,\n reason,\n ...(exitCode === undefined ? {} : { exitCode }),\n });\n const settings = yield* Config.all({\n environment: processEnvironment,\n ports: Config.String(\"CONFECT_LOCAL_BACKEND_PORTS\").pipe(Config.option),\n }).pipe(Effect.mapError(() => fail(\"configuration\")));\n const cache = yield* userCache.pipe(\n Effect.mapError(() => fail(\"configuration\")),\n );\n if (Option.isNone(cache)) return yield* fail(\"configuration\");\n const range = Option.map(settings.ports, Loopback.parsePortRange);\n if (Option.isSome(range) && Option.isNone(range.value))\n return yield* fail(\"configuration\");\n const env = {\n ...settings.environment,\n DISABLE_BEACON: \"1\",\n DO_NOT_TRACK: \"1\",\n };\n\n const answer = (url: string) =>\n http.get(`${url}/instance_name`).pipe(\n Effect.flatMap((response) =>\n response.status === 200 ? response.text : Effect.undefined,\n ),\n Effect.orElseSucceed(() => undefined),\n );\n\n const allocate = Effect.gen(function* () {\n if (Option.isNone(range) || Option.isNone(range.value)) {\n // A closed server no longer has an address.\n const [port, sitePort] = yield* Effect.all([listen(0), listen(0)]).pipe(\n Effect.map((servers) => Array.map(servers, portOf)),\n Effect.scoped,\n );\n if (port === undefined || sitePort === undefined)\n return yield* fail(\"ports\");\n return { port, sitePort };\n }\n const free: number[] = [];\n const { from, to } = range.value.value;\n for (let port = from; port <= to && free.length < 2; port++) {\n if (yield* isFree(port)) free.push(port);\n }\n const [port, sitePort] = free;\n if (port === undefined || sitePort === undefined)\n return yield* fail(\"ports\");\n return { port, sitePort };\n });\n\n const generate = (binary: string) =>\n Effect.gen(function* () {\n const randomBytes2 = yield* random.randomBytes(32);\n const instanceSecret = Buffer.from(randomBytes2).toString(\"hex\");\n const output = yield* spawner.string(\n ChildProcess.make(\n binary,\n [\n \"keygen\",\n \"admin-key\",\n \"--instance-name\",\n deploymentName,\n \"--instance-secret\",\n instanceSecret,\n ],\n { env, extendEnv: false, stdin: \"ignore\", stderr: \"ignore\" },\n ),\n );\n const key = pipe(output, Str.trim);\n if (!pipe(key, Str.startsWith(`${deploymentName}|`)))\n return yield* fail(\"identity\");\n return { instanceSecret, adminKey: key };\n }).pipe(\n Effect.catchTag(\"PlatformError\", () => Effect.fail(fail(\"identity\"))),\n );\n\n const save = (identity: Identity) =>\n Effect.gen(function* () {\n const file = path.join(directory, \"identity.json\");\n const temp = `${file}.${process.pid}.tmp`;\n const encoded = yield* Schema.encodeEffect(Identity)(identity);\n yield* fs.writeFileString(temp, encoded, { mode: 0o600 });\n yield* fs.rename(temp, file);\n }).pipe(\n // Node cannot cancel a write or rename it has started; finishing it\n // keeps a pending rename from landing after owner.lock is released.\n Effect.uninterruptible,\n Effect.mapError(() => fail(\"identity\")),\n );\n\n const session = yield* Scope.Scope;\n const owned = yield* Scope.fork(session);\n const stopped = yield* Deferred.make<void>();\n // Registered first, so it runs after the process and owner.lock finalizers\n // however the scope closes.\n yield* Scope.addFinalizer(owned, Deferred.succeed(stopped, undefined));\n const start = Effect.gen(function* () {\n yield* FileLock.acquire(path.join(directory, \"owner.lock\")).pipe(\n Effect.mapError((error) =>\n fail(error.reason === \"held\" ? \"running\" : \"filesystem\"),\n ),\n );\n const saved = yield* readIdentity(deploymentName, directory);\n const version = Option.isSome(saved) ? saved.value.version : backendVersion;\n const binary = yield* install(deploymentName, version, cache.value);\n let identity: Identity;\n if (Option.isSome(saved)) {\n identity = saved.value;\n } else {\n identity = {\n name: deploymentName,\n version,\n ...(yield* generate(binary)),\n };\n yield* save(identity);\n }\n const ports = identity.ports ?? (yield* allocate);\n if (identity.ports !== undefined) {\n if (!(yield* isFree(ports.port)) || !(yield* isFree(ports.sitePort)))\n return yield* fail(\n (yield* answer(Loopback.origin(ports.port))) === deploymentName\n ? \"running\"\n : \"ports\",\n );\n }\n\n const url = Loopback.origin(ports.port);\n const siteUrl = Loopback.origin(ports.sitePort);\n const handle = yield* spawner\n .spawn(\n ChildProcess.make(\n binary,\n [\n \"--interface\",\n \"127.0.0.1\",\n \"--port\",\n String(ports.port),\n \"--site-proxy-port\",\n String(ports.sitePort),\n \"--instance-name\",\n deploymentName,\n \"--instance-secret\",\n identity.instanceSecret,\n \"--convex-origin\",\n url,\n \"--convex-site\",\n siteUrl,\n \"--local-storage\",\n path.join(directory, \"convex_local_storage\"),\n \"--disable-beacon\",\n path.join(directory, \"convex_local_backend.sqlite3\"),\n ],\n {\n cwd: directory,\n env,\n extendEnv: false,\n stdin: \"ignore\",\n stdout: \"ignore\",\n stderr: \"ignore\",\n forceKillAfter: \"3 seconds\",\n },\n ),\n )\n .pipe(Effect.mapError(() => fail(\"spawn\")));\n\n const ready = answer(url).pipe(\n Effect.flatMap((name) =>\n name === undefined || name === deploymentName\n ? Effect.succeed(name === deploymentName)\n : Effect.fail(fail(\"ports\")),\n ),\n Effect.repeat({\n until: (isReady) => isReady,\n schedule: Schedule.spaced(\"100 millis\"),\n }),\n );\n const exit = handle.exitCode.pipe(\n Effect.mapError(() => fail(\"exit\")),\n Effect.flatMap((code) => Effect.fail(fail(\"exit\", Number(code)))),\n );\n yield* Effect.raceFirst(ready, exit).pipe(\n Effect.timeoutOrElse({\n duration: \"60 seconds\",\n orElse: () => Effect.fail(fail(\"timeout\")),\n }),\n );\n if (identity.ports === undefined) yield* save({ ...identity, ports });\n // An exited backend releases the data directory before `exited`\n // completes, so the deployment can be booted again in this session.\n yield* handle.exitCode.pipe(\n Effect.ignore,\n Effect.andThen(Scope.close(owned, Exit.void)),\n Effect.forkIn(session),\n );\n return {\n url,\n siteUrl,\n adminKey: Redacted.make(identity.adminKey),\n exited: Deferred.await(stopped),\n } satisfies LocalBackend;\n });\n\n return yield* startup\n .withPermits(1)(start)\n .pipe(\n Scope.provide(owned),\n Effect.onExit((exit) =>\n Exit.isSuccess(exit) ? Effect.void : Scope.close(owned, exit),\n ),\n );\n});\n"],"mappings":"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"}
@@ -1,3 +1,6 @@
1
- declare const _default: import("effect/Layer").Layer<import("alchemy/Provider").Provider<import("../Deployment.js").Deployment>, never, import("alchemy/AlchemyContext").AlchemyContext | import("alchemy/Artifacts").ArtifactStore | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient | import("effect/Path").Path | import("alchemy/Stack").Stack>;
1
+ /**
2
+ * @internal
3
+ */
4
+ declare const _default: import("effect/Layer").Layer<import("alchemy").Provider<import("../Deployment.js").Deployment>, never, import("alchemy").AlchemyContext | import("alchemy/Artifacts").ArtifactStore | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/http/HttpClient").HttpClient | import("effect/Path").Path | import("effect/crypto/SecureRandom").SecureRandom | import("alchemy").Stack>;
2
5
  export default _default;
3
6
  //# sourceMappingURL=LocalSidecar.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"LocalSidecar.d.ts","sourceRoot":"","sources":["../../src/internal/LocalSidecar.ts"],"names":[],"mappings":""}
1
+ {"version":3,"file":"LocalSidecar.d.ts","sources":["../../src/internal/LocalSidecar.ts"],"names":[],"mappings":"AAQA;;GAEG;;AACH,wBAA4D"}
@@ -1,7 +1,9 @@
1
1
  import { localLayer } from "../Deployment.js";
2
- //#region src/internal/LocalSidecar.ts
2
+ // src/internal/LocalSidecar.ts
3
+ /**
4
+ * @internal
5
+ */
3
6
  var LocalSidecar_default = localLayer;
4
- //#endregion
5
7
  export { LocalSidecar_default as default };
6
8
 
7
9
  //# sourceMappingURL=LocalSidecar.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"LocalSidecar.js","names":[],"sources":["../../src/internal/LocalSidecar.ts"],"sourcesContent":["/**\n * The local Deployment provider served by Alchemy's dev sidecar, so a local\n * backend outlives reloads of the stack. Alchemy imports this module by URL and\n * builds its default export once per dev session.\n */\nimport type * as RpcServer from \"alchemy/Local/RpcServer\";\nimport { localLayer } from \"../Deployment.js\";\n\nexport default localLayer satisfies RpcServer.ProviderLayer;\n"],"mappings":";;AAQA,IAAA,uBAAe"}
1
+ {"version":3,"file":"LocalSidecar.js","names":[],"sources":["../../src/internal/LocalSidecar.ts"],"sourcesContent":["/**\n * The local Deployment provider served by Alchemy's dev sidecar, so a local\n * backend outlives reloads of the stack. Alchemy imports this module by URL and\n * builds its default export once per dev session.\n */\nimport type * as RpcServer from \"alchemy/Local/RpcServer\";\nimport { localLayer } from \"../Deployment.js\";\n\n/**\n * @internal\n */\nexport default localLayer satisfies RpcServer.ProviderLayer;\n"],"mappings":";;;;;AAWA,IAAA,uBAAe"}
@@ -1 +1 @@
1
- {"version":3,"file":"Loopback.d.ts","sourceRoot":"","sources":["../../src/internal/Loopback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,MAAM,SAAU,MAAM,WAA+B,CAAC;AAInE;;GAEG;AACH,eAAO,MAAM,QAAQ,QAAS,MAAM,YAGnC,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAQrE,CAAC"}
1
+ {"version":3,"file":"Loopback.d.ts","sources":["../../src/internal/Loopback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,MAAM,SAAU,MAAM,WAA+B,CAAC;AAInE;;GAEG;AACH,eAAO,MAAM,QAAQ,QAAS,MAAM,YAGnC,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAQrE,CAAC"}
@@ -1,5 +1,5 @@
1
1
  import * as Option from "effect/Option";
2
- //#region src/internal/Loopback.ts
2
+ // src/internal/Loopback.ts
3
3
  /**
4
4
  * The origin of a local backend port. Local backends bind only loopback.
5
5
  */
@@ -25,7 +25,6 @@ const parsePortRange = (value) => {
25
25
  to
26
26
  }) : Option.none();
27
27
  };
28
- //#endregion
29
28
  export { isOrigin, origin, parsePortRange };
30
29
 
31
30
  //# sourceMappingURL=Loopback.js.map
@@ -7,7 +7,9 @@ import { ConvexClient } from "../ConvexClient.js";
7
7
  declare const MountInitFailed_base: Schema.Class<MountInitFailed, Schema.TaggedStruct<"MountInitFailed", {
8
8
  readonly mount: Schema.String;
9
9
  readonly detail: Schema.String;
10
- }>, import("effect/Cause").YieldableError>;
10
+ }>, import("effect/Cause").YieldableError & {
11
+ readonly brand: unique symbol;
12
+ }>;
11
13
  export declare class MountInitFailed extends MountInitFailed_base {
12
14
  get message(): string;
13
15
  }
@@ -17,6 +19,8 @@ export declare class MountInitFailed extends MountInitFailed_base {
17
19
  * path, one at a time, and visit a nested component's own steps after its
18
20
  * `init`. The first failing mount stops the run. Each `init` is its own
19
21
  * transaction, so earlier mounts stay applied and a rerun converges.
22
+ *
23
+ * @internal
20
24
  */
21
25
  export declare const run: (url: string, key: Redacted.Redacted<string>, cwd: string) => Effect.Effect<void, MountInitFailed, ConvexClient | FileSystem.FileSystem | Path.Path>;
22
26
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"MountInit.d.ts","sourceRoot":"","sources":["../../src/internal/MountInit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAuB,MAAM,oBAAoB,CAAC;;;;;AAEvE,qBAAa,eAAgB,SAAQ,oBAGpC;IACC,IAAa,OAAO,WAEnB;CACF;AAwCD;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,sJAgDd,CAAC"}
1
+ {"version":3,"file":"MountInit.d.ts","sources":["../../src/internal/MountInit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAuB,MAAM,oBAAoB,CAAC;;;;;oBAInD,OAAO,MAAM;;AAFjC,qBAAa,eAAgB,SAAQ,oBAGkC;IACrE,IAAa,OAAO,WAEnB;CACF;AAwCD;;;;;;;;GAQG;AACH,eAAO,MAAM,GAAG,sJAgDd,CAAC"}