@gaganref/confect-alchemy 0.0.0-stage → 10.3.1-fork.1

package/dist/internal/LocalBackend.js.map

@@ -0,0 +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\";\nimport * as FileLock from \"./FileLock\";\nimport * as Loopback from \"./Loopback\";\nimport { userCache } from \"./UserCache\";\nimport { extract } from \"./Zip\";\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-06-a3538c6\";\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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"}

package/dist/internal/LocalSidecar.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("effect/Layer").Layer<import("alchemy/Provider").Provider<import("../Deployment").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>;
+export default _default;
+//# sourceMappingURL=LocalSidecar.d.ts.map

package/dist/internal/LocalSidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSidecar.d.ts","sourceRoot":"","sources":["../../src/internal/LocalSidecar.ts"],"names":[],"mappings":""}

package/dist/internal/LocalSidecar.js

@@ -0,0 +1,7 @@
+import { localLayer } from "../Deployment.js";
+//#region src/internal/LocalSidecar.ts
+var LocalSidecar_default = localLayer;
+//#endregion
+export { LocalSidecar_default as default };
+
+//# sourceMappingURL=LocalSidecar.js.map

package/dist/internal/LocalSidecar.js.map

@@ -0,0 +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\";\n\nexport default localLayer satisfies RpcServer.ProviderLayer;\n"],"mappings":";;AAQA,IAAA,uBAAe"}

package/dist/internal/Loopback.d.ts

@@ -0,0 +1,18 @@
+import * as Option from "effect/Option";
+/**
+ * The origin of a local backend port. Local backends bind only loopback.
+ */
+export declare const origin: (port: number) => string;
+/**
+ * Whether `url` is exactly a loopback origin such as `http://127.0.0.1:3210`.
+ */
+export declare const isOrigin: (url: string) => boolean;
+export interface PortRange {
+    readonly from: number;
+    readonly to: number;
+}
+/**
+ * Parse an inclusive `from-to` range of usable ports, such as `3300-3399`.
+ */
+export declare const parsePortRange: (value: string) => Option.Option<PortRange>;
+//# sourceMappingURL=Loopback.d.ts.map

package/dist/internal/Loopback.d.ts.map

@@ -0,0 +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"}

package/dist/internal/Loopback.js

@@ -0,0 +1,31 @@
+import * as Option from "effect/Option";
+//#region src/internal/Loopback.ts
+/**
+* The origin of a local backend port. Local backends bind only loopback.
+*/
+const origin = (port) => `http://127.0.0.1:${port}`;
+const isPort = (port) => port >= 1 && port <= 65535;
+/**
+* Whether `url` is exactly a loopback origin such as `http://127.0.0.1:3210`.
+*/
+const isOrigin = (url) => {
+	const match = /^http:\/\/127\.0\.0\.1:([1-9][0-9]{0,4})$/.exec(url);
+	return match !== null && isPort(Number(match[1]));
+};
+/**
+* Parse an inclusive `from-to` range of usable ports, such as `3300-3399`.
+*/
+const parsePortRange = (value) => {
+	const match = /^([0-9]{1,5})-([0-9]{1,5})$/.exec(value);
+	if (match === null) return Option.none();
+	const from = Number(match[1]);
+	const to = Number(match[2]);
+	return isPort(from) && isPort(to) && from <= to ? Option.some({
+		from,
+		to
+	}) : Option.none();
+};
+//#endregion
+export { isOrigin, origin, parsePortRange };
+
+//# sourceMappingURL=Loopback.js.map

package/dist/internal/Loopback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Loopback.js","names":[],"sources":["../../src/internal/Loopback.ts"],"sourcesContent":["import * as Option from \"effect/Option\";\n\n/**\n * The origin of a local backend port. Local backends bind only loopback.\n */\nexport const origin = (port: number) => `http://127.0.0.1:${port}`;\n\nconst isPort = (port: number) => port >= 1 && port <= 65535;\n\n/**\n * Whether `url` is exactly a loopback origin such as `http://127.0.0.1:3210`.\n */\nexport const isOrigin = (url: string) => {\n  const match = /^http:\\/\\/127\\.0\\.0\\.1:([1-9][0-9]{0,4})$/.exec(url);\n  return match !== null && isPort(Number(match[1]));\n};\n\nexport interface PortRange {\n  readonly from: number;\n  readonly to: number;\n}\n\n/**\n * Parse an inclusive `from-to` range of usable ports, such as `3300-3399`.\n */\nexport const parsePortRange = (value: string): Option.Option<PortRange> => {\n  const match = /^([0-9]{1,5})-([0-9]{1,5})$/.exec(value);\n  if (match === null) return Option.none();\n  const from = Number(match[1]);\n  const to = Number(match[2]);\n  return isPort(from) && isPort(to) && from <= to\n    ? Option.some({ from, to })\n    : Option.none();\n};\n"],"mappings":";;;;;AAKA,MAAa,UAAU,SAAiB,oBAAoB;AAE5D,MAAM,UAAU,SAAiB,QAAQ,KAAK,QAAQ;;;;AAKtD,MAAa,YAAY,QAAgB;CACvC,MAAM,QAAQ,4CAA4C,KAAK,GAAG;CAClE,OAAO,UAAU,QAAQ,OAAO,OAAO,MAAM,EAAE,CAAC;AAClD;;;;AAUA,MAAa,kBAAkB,UAA4C;CACzE,MAAM,QAAQ,8BAA8B,KAAK,KAAK;CACtD,IAAI,UAAU,MAAM,OAAO,OAAO,KAAK;CACvC,MAAM,OAAO,OAAO,MAAM,EAAE;CAC5B,MAAM,KAAK,OAAO,MAAM,EAAE;CAC1B,OAAO,OAAO,IAAI,KAAK,OAAO,EAAE,KAAK,QAAQ,KACzC,OAAO,KAAK;EAAE;EAAM;CAAG,CAAC,IACxB,OAAO,KAAK;AAClB"}

package/dist/internal/PushLock.d.ts

@@ -0,0 +1,36 @@
+import * as Context from "effect/Context";
+import * as Crypto from "effect/Crypto";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+declare const PushLockError_base: Schema.Class<PushLockError, Schema.TaggedStruct<"PushLockError", {
+    readonly deploymentName: Schema.String;
+    readonly reason: Schema.Literals<readonly ["configuration", "timeout", "filesystem"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class PushLockError extends PushLockError_base {
+    get message(): string;
+}
+declare const PushLock_base: Context.ServiceClass<PushLock, "@confect/alchemy/internal/PushLock", {
+    readonly withLock: <A, E, R>(deploymentName: string, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E | PushLockError, R>;
+}>;
+/**
+ * Serialises pushes per deployment. Overlapping `convex deploy` runs against
+ * one deployment race on `wait_for_schema`, so every push holds the lock for
+ * its whole duration, whichever stack, checkout, or process it comes from.
+ */
+export declare class PushLock extends PushLock_base {
+}
+/**
+ * One lock file per deployment under the user's cache,
+ * `confect/alchemy/locks/<deployment>.lock`, so every checkout on the machine
+ * shares it. A lock left by a process that exited is taken over; a holder that
+ * never releases ends in a typed timeout.
+ */
+export declare const layer: (options?: {
+    readonly timeout?: Duration.Input;
+}) => Layer.Layer<PushLock, never, Crypto.Crypto | FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=PushLock.d.ts.map

package/dist/internal/PushLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PushLock.d.ts","sourceRoot":"","sources":["../../src/internal/PushLock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;;AAKxC,qBAAa,aAAc,SAAQ,kBAMlC;IACC,IAAa,OAAO,WASnB;CACF;;uBAUsB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACzB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,CAAC;;AAX/C;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,aAQW;CAAG;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,KAAK,aAAc;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;CAAE,oFA6ClE,CAAC"}

package/dist/internal/PushLock.js

@@ -0,0 +1,61 @@
+import { acquire } from "./FileLock.js";
+import { userCache } from "./UserCache.js";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Context from "effect/Context";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Option from "effect/Option";
+import * as Crypto from "effect/Crypto";
+import * as Duration from "effect/Duration";
+import * as Scope from "effect/Scope";
+//#region src/internal/PushLock.ts
+var PushLockError = class extends Schema.TaggedError()("PushLockError", {
+	deploymentName: Schema.String,
+	reason: Schema.Literals([
+		"configuration",
+		"timeout",
+		"filesystem"
+	])
+}) {
+	get message() {
+		switch (this.reason) {
+			case "configuration": return `Push lock for ${this.deploymentName} needs a home directory to keep its lock file in`;
+			case "timeout": return `Timed out waiting for another push to ${this.deploymentName} to release its push lock`;
+			case "filesystem": return `Push lock for ${this.deploymentName} could not read or write its lock file`;
+		}
+	}
+};
+/**
+* Serialises pushes per deployment. Overlapping `convex deploy` runs against
+* one deployment race on `wait_for_schema`, so every push holds the lock for
+* its whole duration, whichever stack, checkout, or process it comes from.
+*/
+var PushLock = class extends Context.Service()("@confect/alchemy/internal/PushLock") {};
+/**
+* One lock file per deployment under the user's cache,
+* `confect/alchemy/locks/<deployment>.lock`, so every checkout on the machine
+* shares it. A lock left by a process that exited is taken over; a holder that
+* never releases ends in a typed timeout.
+*/
+const layer = (options) => Layer.effect(PushLock, Effect.gen(function* () {
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const crypto = yield* Crypto.Crypto;
+	const timeout = options?.timeout ?? Duration.minutes(10);
+	const lock = Effect.fn("PushLock.lock")(function* (deploymentName, scope) {
+		const failed = (reason) => new PushLockError({
+			deploymentName,
+			reason
+		});
+		const cache = yield* userCache.pipe(Effect.mapError(() => failed("configuration")));
+		if (Option.isNone(cache)) return yield* failed("configuration");
+		yield* acquire(path.join(cache.value, "confect", "alchemy", "locks", `${deploymentName}.lock`), timeout).pipe(Scope.provide(scope), Effect.mapError((error) => failed(error.reason === "timeout" ? "timeout" : "filesystem")));
+	}, Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, path), Effect.provideService(Crypto.Crypto, crypto));
+	return PushLock.of({ withLock: (deploymentName, effect) => Effect.acquireUseRelease(Scope.make(), (scope) => lock(deploymentName, scope).pipe(Effect.andThen(effect)), (scope, exit) => Scope.close(scope, exit)) });
+}));
+//#endregion
+export { PushLock, PushLockError, layer };
+
+//# sourceMappingURL=PushLock.js.map

package/dist/internal/PushLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PushLock.js","names":["FileLock.acquire"],"sources":["../../src/internal/PushLock.ts"],"sourcesContent":["import * as Context from \"effect/Context\";\nimport * as Crypto from \"effect/Crypto\";\nimport * as Duration from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as FileSystem from \"effect/FileSystem\";\nimport * as Layer from \"effect/Layer\";\nimport * as Option from \"effect/Option\";\nimport * as Path from \"effect/Path\";\nimport * as Schema from \"effect/Schema\";\nimport * as Scope from \"effect/Scope\";\nimport * as FileLock from \"./FileLock\";\nimport { userCache } from \"./UserCache\";\n\nexport class PushLockError extends Schema.TaggedError<PushLockError>()(\n  \"PushLockError\",\n  {\n    deploymentName: Schema.String,\n    reason: Schema.Literals([\"configuration\", \"timeout\", \"filesystem\"]),\n  },\n) {\n  override get message() {\n    switch (this.reason) {\n      case \"configuration\":\n        return `Push lock for ${this.deploymentName} needs a home directory to keep its lock file in`;\n      case \"timeout\":\n        return `Timed out waiting for another push to ${this.deploymentName} to release its push lock`;\n      case \"filesystem\":\n        return `Push lock for ${this.deploymentName} could not read or write its lock file`;\n    }\n  }\n}\n\n/**\n * Serialises pushes per deployment. Overlapping `convex deploy` runs against\n * one deployment race on `wait_for_schema`, so every push holds the lock for\n * its whole duration, whichever stack, checkout, or process it comes from.\n */\nexport class PushLock extends Context.Service<\n  PushLock,\n  {\n    readonly withLock: <A, E, R>(\n      deploymentName: string,\n      effect: Effect.Effect<A, E, R>,\n    ) => Effect.Effect<A, E | PushLockError, R>;\n  }\n>()(\"@confect/alchemy/internal/PushLock\") {}\n\n/**\n * One lock file per deployment under the user's cache,\n * `confect/alchemy/locks/<deployment>.lock`, so every checkout on the machine\n * shares it. A lock left by a process that exited is taken over; a holder that\n * never releases ends in a typed timeout.\n */\nexport const layer = (options?: { readonly timeout?: Duration.Input }) =>\n  Layer.effect(\n    PushLock,\n    Effect.gen(function* () {\n      const fs = yield* FileSystem.FileSystem;\n      const path = yield* Path.Path;\n      const crypto = yield* Crypto.Crypto;\n      const timeout = options?.timeout ?? Duration.minutes(10);\n      const lock = Effect.fn(\"PushLock.lock\")(\n        function* (deploymentName: string, scope: Scope.Scope) {\n          const failed = (reason: PushLockError[\"reason\"]) =>\n            new PushLockError({ deploymentName, reason });\n          const cache = yield* userCache.pipe(\n            Effect.mapError(() => failed(\"configuration\")),\n          );\n          if (Option.isNone(cache)) return yield* failed(\"configuration\");\n          yield* FileLock.acquire(\n            path.join(\n              cache.value,\n              \"confect\",\n              \"alchemy\",\n              \"locks\",\n              `${deploymentName}.lock`,\n            ),\n            timeout,\n          ).pipe(\n            Scope.provide(scope),\n            Effect.mapError((error) =>\n              failed(error.reason === \"timeout\" ? \"timeout\" : \"filesystem\"),\n            ),\n          );\n        },\n        Effect.provideService(FileSystem.FileSystem, fs),\n        Effect.provideService(Path.Path, path),\n        Effect.provideService(Crypto.Crypto, crypto),\n      );\n      return PushLock.of({\n        withLock: (deploymentName, effect) =>\n          Effect.acquireUseRelease(\n            Scope.make(),\n            (scope) => lock(deploymentName, scope).pipe(Effect.andThen(effect)),\n            (scope, exit) => Scope.close(scope, exit),\n          ),\n      });\n    }),\n  );\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAa,gBAAb,cAAmC,OAAO,YAA2B,CAAC,CACpE,iBACA;CACE,gBAAgB,OAAO;CACvB,QAAQ,OAAO,SAAS;EAAC;EAAiB;EAAW;CAAY,CAAC;AACpE,CACF,CAAC,CAAC;CACA,IAAa,UAAU;EACrB,QAAQ,KAAK,QAAb;GACE,KAAK,iBACH,OAAO,iBAAiB,KAAK,eAAe;GAC9C,KAAK,WACH,OAAO,yCAAyC,KAAK,eAAe;GACtE,KAAK,cACH,OAAO,iBAAiB,KAAK,eAAe;EAChD;CACF;AACF;;;;;;AAOA,IAAa,WAAb,cAA8B,QAAQ,QAQpC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC;;;;;;;AAQ3C,MAAa,SAAS,YACpB,MAAM,OACJ,UACA,OAAO,IAAI,aAAa;CACtB,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,OAAO,OAAO,KAAK;CACzB,MAAM,SAAS,OAAO,OAAO;CAC7B,MAAM,UAAU,SAAS,WAAW,SAAS,QAAQ,EAAE;CACvD,MAAM,OAAO,OAAO,GAAG,eAAe,CAAC,CACrC,WAAW,gBAAwB,OAAoB;EACrD,MAAM,UAAU,WACd,IAAI,cAAc;GAAE;GAAgB;EAAO,CAAC;EAC9C,MAAM,QAAQ,OAAO,UAAU,KAC7B,OAAO,eAAe,OAAO,eAAe,CAAC,CAC/C;EACA,IAAI,OAAO,OAAO,KAAK,GAAG,OAAO,OAAO,OAAO,eAAe;EAC9D,OAAOA,QACL,KAAK,KACH,MAAM,OACN,WACA,WACA,SACA,GAAG,eAAe,MACpB,GACA,OACF,CAAC,CAAC,KACA,MAAM,QAAQ,KAAK,GACnB,OAAO,UAAU,UACf,OAAO,MAAM,WAAW,YAAY,YAAY,YAAY,CAC9D,CACF;CACF,GACA,OAAO,eAAe,WAAW,YAAY,EAAE,GAC/C,OAAO,eAAe,KAAK,MAAM,IAAI,GACrC,OAAO,eAAe,OAAO,QAAQ,MAAM,CAC7C;CACA,OAAO,SAAS,GAAG,EACjB,WAAW,gBAAgB,WACzB,OAAO,kBACL,MAAM,KAAK,IACV,UAAU,KAAK,gBAAgB,KAAK,CAAC,CAAC,KAAK,OAAO,QAAQ,MAAM,CAAC,IACjE,OAAO,SAAS,MAAM,MAAM,OAAO,IAAI,CAC1C,EACJ,CAAC;AACH,CAAC,CACH"}

package/dist/internal/ResourceIdentity.d.ts

@@ -0,0 +1,3 @@
+import * as Effect from "effect/Effect";
+export declare const resourceName: (kind: string, fqn: string, instanceId: string) => Effect.Effect<string, never, never>;
+//# sourceMappingURL=ResourceIdentity.d.ts.map

package/dist/internal/ResourceIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceIdentity.d.ts","sourceRoot":"","sources":["../../src/internal/ResourceIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,YAAY,wFAiBvB,CAAC"}

package/dist/internal/ResourceIdentity.js

@@ -0,0 +1,10 @@
+import * as Effect from "effect/Effect";
+//#region src/internal/ResourceIdentity.ts
+const resourceName = Effect.fn("ResourceIdentity.name")(function* (kind, fqn, instanceId) {
+	const hash = yield* Effect.promise(() => crypto.subtle.digest("SHA-256", new TextEncoder().encode(`${fqn}:${instanceId}`)));
+	return `confect-${kind}-${Array.from(new Uint8Array(hash), (byte) => byte.toString(16).padStart(2, "0")).join("").slice(0, 24)}`;
+});
+//#endregion
+export { resourceName };
+
+//# sourceMappingURL=ResourceIdentity.js.map

package/dist/internal/ResourceIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceIdentity.js","names":[],"sources":["../../src/internal/ResourceIdentity.ts"],"sourcesContent":["import * as Effect from \"effect/Effect\";\n\nexport const resourceName = Effect.fn(\"ResourceIdentity.name\")(function* (\n  kind: string,\n  fqn: string,\n  instanceId: string,\n) {\n  const hash = yield* Effect.promise(() =>\n    crypto.subtle.digest(\n      \"SHA-256\",\n      new TextEncoder().encode(`${fqn}:${instanceId}`),\n    ),\n  );\n  const suffix = Array.from(new Uint8Array(hash), (byte) =>\n    byte.toString(16).padStart(2, \"0\"),\n  )\n    .join(\"\")\n    .slice(0, 24);\n  return `confect-${kind}-${suffix}`;\n});\n"],"mappings":";;AAEA,MAAa,eAAe,OAAO,GAAG,uBAAuB,CAAC,CAAC,WAC7D,MACA,KACA,YACA;CACA,MAAM,OAAO,OAAO,OAAO,cACzB,OAAO,OAAO,OACZ,WACA,IAAI,YAAY,CAAC,CAAC,OAAO,GAAG,IAAI,GAAG,YAAY,CACjD,CACF;CAMA,OAAO,WAAW,KAAK,GALR,MAAM,KAAK,IAAI,WAAW,IAAI,IAAI,SAC/C,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CACnC,CAAC,CACE,KAAK,EAAE,CAAC,CACR,MAAM,GAAG,EACmB;AACjC,CAAC"}

package/dist/internal/UserCache.d.ts

@@ -0,0 +1,12 @@
+import * as Config from "effect/Config";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+/**
+ * The user's cache directory, as the Convex CLI resolves it: `~/.cache` on
+ * POSIX and `%LOCALAPPDATA%` on Windows. Shared by every checkout on the
+ * machine, so binaries are downloaded once and push locks are seen by every
+ * stack. None when no absolute directory can be derived.
+ */
+export declare const userCache: Effect.Effect<Option.None<string> | Option.Some<string>, Config.ConfigError, Path.Path>;
+//# sourceMappingURL=UserCache.d.ts.map

package/dist/internal/UserCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCache.d.ts","sourceRoot":"","sources":["../../src/internal/UserCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,yFAapB,CAAC"}

package/dist/internal/UserCache.js

@@ -0,0 +1,25 @@
+import * as Effect from "effect/Effect";
+import * as Config from "effect/Config";
+import * as Path from "effect/Path";
+import * as Option from "effect/Option";
+//#region src/internal/UserCache.ts
+/**
+* The user's cache directory, as the Convex CLI resolves it: `~/.cache` on
+* POSIX and `%LOCALAPPDATA%` on Windows. Shared by every checkout on the
+* machine, so binaries are downloaded once and push locks are seen by every
+* stack. None when no absolute directory can be derived.
+*/
+const userCache = Effect.gen(function* () {
+	const path = yield* Path.Path;
+	const { HOME, LOCALAPPDATA, USERPROFILE } = yield* Config.all({
+		HOME: Config.String("HOME").pipe(Config.withDefault("")),
+		LOCALAPPDATA: Config.String("LOCALAPPDATA").pipe(Config.withDefault("")),
+		USERPROFILE: Config.String("USERPROFILE").pipe(Config.withDefault(""))
+	});
+	const root = process.platform === "win32" ? LOCALAPPDATA || USERPROFILE && path.join(USERPROFILE, "AppData", "Local") : HOME && path.join(HOME, ".cache");
+	return root && path.isAbsolute(root) ? Option.some(root) : Option.none();
+});
+//#endregion
+export { userCache };
+
+//# sourceMappingURL=UserCache.js.map

package/dist/internal/UserCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCache.js","names":[],"sources":["../../src/internal/UserCache.ts"],"sourcesContent":["import * as Config from \"effect/Config\";\nimport * as Effect from \"effect/Effect\";\nimport * as Option from \"effect/Option\";\nimport * as Path from \"effect/Path\";\n\n/**\n * The user's cache directory, as the Convex CLI resolves it: `~/.cache` on\n * POSIX and `%LOCALAPPDATA%` on Windows. Shared by every checkout on the\n * machine, so binaries are downloaded once and push locks are seen by every\n * stack. None when no absolute directory can be derived.\n */\nexport const userCache = Effect.gen(function* () {\n  const path = yield* Path.Path;\n  const { HOME, LOCALAPPDATA, USERPROFILE } = yield* Config.all({\n    HOME: Config.String(\"HOME\").pipe(Config.withDefault(\"\")),\n    LOCALAPPDATA: Config.String(\"LOCALAPPDATA\").pipe(Config.withDefault(\"\")),\n    USERPROFILE: Config.String(\"USERPROFILE\").pipe(Config.withDefault(\"\")),\n  });\n  const root =\n    process.platform === \"win32\"\n      ? LOCALAPPDATA ||\n        (USERPROFILE && path.join(USERPROFILE, \"AppData\", \"Local\"))\n      : HOME && path.join(HOME, \".cache\");\n  return root && path.isAbsolute(root) ? Option.some(root) : Option.none();\n});\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,YAAY,OAAO,IAAI,aAAa;CAC/C,MAAM,OAAO,OAAO,KAAK;CACzB,MAAM,EAAE,MAAM,cAAc,gBAAgB,OAAO,OAAO,IAAI;EAC5D,MAAM,OAAO,OAAO,MAAM,CAAC,CAAC,KAAK,OAAO,YAAY,EAAE,CAAC;EACvD,cAAc,OAAO,OAAO,cAAc,CAAC,CAAC,KAAK,OAAO,YAAY,EAAE,CAAC;EACvE,aAAa,OAAO,OAAO,aAAa,CAAC,CAAC,KAAK,OAAO,YAAY,EAAE,CAAC;CACvE,CAAC;CACD,MAAM,OACJ,QAAQ,aAAa,UACjB,gBACC,eAAe,KAAK,KAAK,aAAa,WAAW,OAAO,IACzD,QAAQ,KAAK,KAAK,MAAM,QAAQ;CACtC,OAAO,QAAQ,KAAK,WAAW,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK;AACzE,CAAC"}

package/dist/internal/Zip.d.ts

@@ -0,0 +1,15 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+declare const ZipError_base: Schema.Class<ZipError, Schema.TaggedStruct<"ZipError", {
+    readonly reason: Schema.Literals<readonly ["format", "entry", "io"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ZipError extends ZipError_base {
+}
+/**
+ * Extract one entry of a zip archive. Convex publishes the local backend as a
+ * single-file zip, stored or deflated.
+ */
+export declare const extract: (archive: string, name: string, destination: string) => Effect.Effect<void, ZipError, FileSystem.FileSystem>;
+export {};
+//# sourceMappingURL=Zip.d.ts.map

package/dist/internal/Zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Zip.d.ts","sourceRoot":"","sources":["../../src/internal/Zip.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;AAExC,qBAAa,QAAS,SAAQ,aAE5B;CAAG;AA2EL;;;GAGG;AACH,eAAO,MAAM,OAAO,8GAoBlB,CAAC"}

package/dist/internal/Zip.js

@@ -0,0 +1,65 @@
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import * as FileSystem from "effect/FileSystem";
+import { inflateRaw } from "node:zlib";
+//#region src/internal/Zip.ts
+var ZipError = class extends Schema.TaggedError()("ZipError", { reason: Schema.Literals([
+	"format",
+	"entry",
+	"io"
+]) }) {};
+const format = () => Result.fail(new ZipError({ reason: "format" }));
+/**
+* Locate one entry's compressed bytes through the archive's central directory.
+* No Zip64: a single-file release far under 4 GiB never needs it.
+*/
+const locate = (archive, name) => {
+	const bytes = Buffer.from(archive.buffer, archive.byteOffset, archive.length);
+	const end = bytes.lastIndexOf(Buffer.from([
+		80,
+		75,
+		5,
+		6
+	]));
+	if (end < 0 || end + 22 > bytes.length) return format();
+	const directoryEnd = bytes.readUInt32LE(end + 16) + bytes.readUInt32LE(end + 12);
+	if (directoryEnd > bytes.length) return format();
+	for (let offset = bytes.readUInt32LE(end + 16); offset + 46 <= directoryEnd;) {
+		if (bytes.readUInt32LE(offset) !== 33639248) return format();
+		const nameLength = bytes.readUInt16LE(offset + 28);
+		if (bytes.toString("utf8", offset + 46, offset + 46 + nameLength) === name) {
+			const size = bytes.readUInt32LE(offset + 20);
+			const header = bytes.readUInt32LE(offset + 42);
+			if (header + 30 > bytes.length || bytes.readUInt32LE(header) !== 67324752) return format();
+			const start = header + 30 + bytes.readUInt16LE(header + 26) + bytes.readUInt16LE(header + 28);
+			if (start + size > bytes.length) return format();
+			return Result.succeed({
+				method: bytes.readUInt16LE(offset + 10),
+				start,
+				end: start + size
+			});
+		}
+		offset += 46 + nameLength + bytes.readUInt16LE(offset + 30) + bytes.readUInt16LE(offset + 32);
+	}
+	return Result.fail(new ZipError({ reason: "entry" }));
+};
+const inflate = (data) => Effect.callback((resume) => {
+	inflateRaw(data, (error, output) => resume(error ? Effect.fail(new ZipError({ reason: "format" })) : Effect.succeed(output)));
+});
+/**
+* Extract one entry of a zip archive. Convex publishes the local backend as a
+* single-file zip, stored or deflated.
+*/
+const extract = Effect.fn("Zip.extract")(function* (archive, name, destination) {
+	const fs = yield* FileSystem.FileSystem;
+	const bytes = yield* fs.readFile(archive).pipe(Effect.mapError(() => new ZipError({ reason: "io" })));
+	const entry = yield* Effect.fromResult(locate(bytes, name));
+	const data = bytes.subarray(entry.start, entry.end);
+	const content = entry.method === 8 ? yield* inflate(data) : entry.method === 0 ? data : yield* new ZipError({ reason: "format" });
+	yield* fs.writeFile(destination, content, { mode: 493 }).pipe(Effect.mapError(() => new ZipError({ reason: "io" })));
+});
+//#endregion
+export { ZipError, extract };
+
+//# sourceMappingURL=Zip.js.map

package/dist/internal/Zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Zip.js","names":[],"sources":["../../src/internal/Zip.ts"],"sourcesContent":["import { inflateRaw } from \"node:zlib\";\nimport * as Effect from \"effect/Effect\";\nimport * as FileSystem from \"effect/FileSystem\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\n\nexport class ZipError extends Schema.TaggedError<ZipError>()(\"ZipError\", {\n  reason: Schema.Literals([\"format\", \"entry\", \"io\"]),\n}) {}\n\ninterface Entry {\n  readonly method: number;\n  readonly start: number;\n  readonly end: number;\n}\n\nconst format = () => Result.fail(new ZipError({ reason: \"format\" }));\n\n/**\n * Locate one entry's compressed bytes through the archive's central directory.\n * No Zip64: a single-file release far under 4 GiB never needs it.\n */\nconst locate = (\n  archive: Uint8Array,\n  name: string,\n): Result.Result<Entry, ZipError> => {\n  const bytes = Buffer.from(archive.buffer, archive.byteOffset, archive.length);\n  const end = bytes.lastIndexOf(Buffer.from([0x50, 0x4b, 0x05, 0x06]));\n  if (end < 0 || end + 22 > bytes.length) return format();\n  const directoryEnd =\n    bytes.readUInt32LE(end + 16) + bytes.readUInt32LE(end + 12);\n  if (directoryEnd > bytes.length) return format();\n  for (\n    let offset = bytes.readUInt32LE(end + 16);\n    offset + 46 <= directoryEnd;\n  ) {\n    if (bytes.readUInt32LE(offset) !== 0x02014b50) return format();\n    const nameLength = bytes.readUInt16LE(offset + 28);\n    const entryName = bytes.toString(\n      \"utf8\",\n      offset + 46,\n      offset + 46 + nameLength,\n    );\n    if (entryName === name) {\n      const size = bytes.readUInt32LE(offset + 20);\n      const header = bytes.readUInt32LE(offset + 42);\n      if (\n        header + 30 > bytes.length ||\n        bytes.readUInt32LE(header) !== 0x04034b50\n      )\n        return format();\n      const start =\n        header +\n        30 +\n        bytes.readUInt16LE(header + 26) +\n        bytes.readUInt16LE(header + 28);\n      if (start + size > bytes.length) return format();\n      return Result.succeed({\n        method: bytes.readUInt16LE(offset + 10),\n        start,\n        end: start + size,\n      });\n    }\n    offset +=\n      46 +\n      nameLength +\n      bytes.readUInt16LE(offset + 30) +\n      bytes.readUInt16LE(offset + 32);\n  }\n  return Result.fail(new ZipError({ reason: \"entry\" }));\n};\n\nconst inflate = (data: Uint8Array) =>\n  Effect.callback<Uint8Array, ZipError>((resume) => {\n    inflateRaw(data, (error, output) =>\n      resume(\n        error\n          ? Effect.fail(new ZipError({ reason: \"format\" }))\n          : Effect.succeed(output),\n      ),\n    );\n  });\n\n/**\n * Extract one entry of a zip archive. Convex publishes the local backend as a\n * single-file zip, stored or deflated.\n */\nexport const extract = Effect.fn(\"Zip.extract\")(function* (\n  archive: string,\n  name: string,\n  destination: string,\n) {\n  const fs = yield* FileSystem.FileSystem;\n  const bytes = yield* fs\n    .readFile(archive)\n    .pipe(Effect.mapError(() => new ZipError({ reason: \"io\" })));\n  const entry = yield* Effect.fromResult(locate(bytes, name));\n  const data = bytes.subarray(entry.start, entry.end);\n  const content =\n    entry.method === 8\n      ? yield* inflate(data)\n      : entry.method === 0\n        ? data\n        : yield* new ZipError({ reason: \"format\" });\n  yield* fs\n    .writeFile(destination, content, { mode: 0o755 })\n    .pipe(Effect.mapError(() => new ZipError({ reason: \"io\" })));\n});\n"],"mappings":";;;;;;AAMA,IAAa,WAAb,cAA8B,OAAO,YAAsB,CAAC,CAAC,YAAY,EACvE,QAAQ,OAAO,SAAS;CAAC;CAAU;CAAS;AAAI,CAAC,EACnD,CAAC,CAAC,CAAC,CAAC;AAQJ,MAAM,eAAe,OAAO,KAAK,IAAI,SAAS,EAAE,QAAQ,SAAS,CAAC,CAAC;;;;;AAMnE,MAAM,UACJ,SACA,SACmC;CACnC,MAAM,QAAQ,OAAO,KAAK,QAAQ,QAAQ,QAAQ,YAAY,QAAQ,MAAM;CAC5E,MAAM,MAAM,MAAM,YAAY,OAAO,KAAK;EAAC;EAAM;EAAM;EAAM;CAAI,CAAC,CAAC;CACnE,IAAI,MAAM,KAAK,MAAM,KAAK,MAAM,QAAQ,OAAO,OAAO;CACtD,MAAM,eACJ,MAAM,aAAa,MAAM,EAAE,IAAI,MAAM,aAAa,MAAM,EAAE;CAC5D,IAAI,eAAe,MAAM,QAAQ,OAAO,OAAO;CAC/C,KACE,IAAI,SAAS,MAAM,aAAa,MAAM,EAAE,GACxC,SAAS,MAAM,eACf;EACA,IAAI,MAAM,aAAa,MAAM,MAAM,UAAY,OAAO,OAAO;EAC7D,MAAM,aAAa,MAAM,aAAa,SAAS,EAAE;EAMjD,IALkB,MAAM,SACtB,QACA,SAAS,IACT,SAAS,KAAK,UAEJ,MAAM,MAAM;GACtB,MAAM,OAAO,MAAM,aAAa,SAAS,EAAE;GAC3C,MAAM,SAAS,MAAM,aAAa,SAAS,EAAE;GAC7C,IACE,SAAS,KAAK,MAAM,UACpB,MAAM,aAAa,MAAM,MAAM,UAE/B,OAAO,OAAO;GAChB,MAAM,QACJ,SACA,KACA,MAAM,aAAa,SAAS,EAAE,IAC9B,MAAM,aAAa,SAAS,EAAE;GAChC,IAAI,QAAQ,OAAO,MAAM,QAAQ,OAAO,OAAO;GAC/C,OAAO,OAAO,QAAQ;IACpB,QAAQ,MAAM,aAAa,SAAS,EAAE;IACtC;IACA,KAAK,QAAQ;GACf,CAAC;EACH;EACA,UACE,KACA,aACA,MAAM,aAAa,SAAS,EAAE,IAC9B,MAAM,aAAa,SAAS,EAAE;CAClC;CACA,OAAO,OAAO,KAAK,IAAI,SAAS,EAAE,QAAQ,QAAQ,CAAC,CAAC;AACtD;AAEA,MAAM,WAAW,SACf,OAAO,UAAgC,WAAW;CAChD,WAAW,OAAO,OAAO,WACvB,OACE,QACI,OAAO,KAAK,IAAI,SAAS,EAAE,QAAQ,SAAS,CAAC,CAAC,IAC9C,OAAO,QAAQ,MAAM,CAC3B,CACF;AACF,CAAC;;;;;AAMH,MAAa,UAAU,OAAO,GAAG,aAAa,CAAC,CAAC,WAC9C,SACA,MACA,aACA;CACA,MAAM,KAAK,OAAO,WAAW;CAC7B,MAAM,QAAQ,OAAO,GAClB,SAAS,OAAO,CAAC,CACjB,KAAK,OAAO,eAAe,IAAI,SAAS,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC;CAC7D,MAAM,QAAQ,OAAO,OAAO,WAAW,OAAO,OAAO,IAAI,CAAC;CAC1D,MAAM,OAAO,MAAM,SAAS,MAAM,OAAO,MAAM,GAAG;CAClD,MAAM,UACJ,MAAM,WAAW,IACb,OAAO,QAAQ,IAAI,IACnB,MAAM,WAAW,IACf,OACA,OAAO,IAAI,SAAS,EAAE,QAAQ,SAAS,CAAC;CAChD,OAAO,GACJ,UAAU,aAAa,SAAS,EAAE,MAAM,IAAM,CAAC,CAAC,CAChD,KAAK,OAAO,eAAe,IAAI,SAAS,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@gaganref/confect-alchemy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "10.3.1-fork.1",
+  "dependencies": {
+    "@convex-dev/platform": "^0.1.10"
+  },
+  "peerDependencies": {
+    "@confect/cli": "npm:@gaganref/confect-cli@10.3.1-fork.1",
+    "@confect/core": "npm:@gaganref/confect-core@10.3.1-fork.1",
+    "alchemy": "2.0.0-beta.82",
+    "convex": "^1.32.0",
+    "effect": "^4.0.0"
+  },
+  "description": "Alchemy resources for deploying Convex and Confect applications",
+  "author": "RJ Dellecese",
+  "bugs": {
+    "url": "https://github.com/gaganref/confect"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./package.json": "./package.json",
+    "./internal/*": null
+  },
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "dist",
+    "!dist/*.tsbuildinfo",
+    "package.json",
+    "src"
+  ],
+  "homepage": "https://confect.dev",
+  "keywords": [
+    "alchemy",
+    "convex",
+    "effect"
+  ],
+  "license": "ISC",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "peerDependenciesMeta": {
+    "@confect/cli": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gaganref/confect.git"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
 }

package/src/Backend.ts

@@ -0,0 +1,101 @@
+import type * as Manifest from "@confect/core/Manifest";
+import type { Input } from "alchemy/Input";
+import * as Namespace from "alchemy/Namespace";
+import * as Output from "alchemy/Output";
+import * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import { Code } from "./Code";
+import { EnvironmentVariables } from "./EnvironmentVariables";
+
+interface CommonProps {
+  readonly deployment: {
+    readonly name: Input<string>;
+    readonly url: Input<string>;
+  };
+  readonly deployKey: Input<Redacted.Redacted<string>>;
+  readonly cwd?: string;
+}
+
+type Environment<M extends Manifest.Manifest> = {
+  readonly [K in keyof Manifest.Values<M>]: Input<
+    Exclude<Manifest.Values<M>[K], undefined>
+  >;
+};
+
+export type BackendProps<M extends Manifest.Manifest | undefined = undefined> =
+  CommonProps &
+    (M extends Manifest.Manifest
+      ? { readonly manifest: M } & ({} extends Manifest.Values<M>
+          ? { readonly env?: Environment<NoInfer<M>> }
+          : { readonly env: Environment<NoInfer<M>> })
+      : {
+          readonly manifest?: never;
+          readonly env?: Readonly<
+            Record<string, Input<string | Redacted.Redacted<string>>>
+          >;
+        });
+
+/**
+ * Deploy a declared backend with env typed by its generated manifest.
+ */
+export function Backend<
+  const M extends Manifest.Manifest,
+  const E extends Environment<NoInfer<M>> = Environment<NoInfer<M>>,
+>(
+  id: string,
+  props: BackendProps<M> & {
+    readonly env?: E &
+      Readonly<Record<Exclude<keyof E, keyof M["env"]>, never>>;
+  },
+): ReturnType<typeof backend>;
+export function Backend(
+  id: string,
+  props: BackendProps,
+): ReturnType<typeof backend>;
+export function Backend(
+  id: string,
+  props: CommonProps & {
+    readonly env?: Readonly<
+      Record<string, Input<string | Redacted.Redacted<string>>>
+    >;
+  },
+): ReturnType<typeof backend> {
+  return backend(id, props);
+}
+
+const backend = (
+  id: string,
+  props: CommonProps & {
+    readonly env?: Readonly<
+      Record<string, Input<string | Redacted.Redacted<string>>>
+    >;
+  },
+) =>
+  Namespace.push(
+    id,
+    Effect.gen(function* () {
+      const environment =
+        props.env === undefined
+          ? undefined
+          : yield* EnvironmentVariables("Environment", {
+              url: props.deployment.url,
+              deployKey: props.deployKey,
+              variables: props.env,
+            });
+      const code = yield* Code("Code", {
+        deployment: {
+          name: props.deployment.name,
+          url: environment
+            ? Output.map(
+                Output.all(environment.variables, environment.url),
+                ([, url]) => url,
+              )
+            : props.deployment.url,
+        },
+        deployKey: props.deployKey,
+        ...(props.cwd === undefined ? {} : { cwd: props.cwd }),
+        prepare: { command: "confect", args: ["codegen"] },
+      });
+      return { code, environment, name: code.name, url: code.url };
+    }),
+  );