@axonpack/preview 0.0.0-stage → 0.1.0

package/build/services/previews/use-running.service.d.ts

@@ -0,0 +1,4 @@
+import { type Running } from "../../utils/previews/running.util";
+/** What runs now, read from the package's state. Needs a `<PreviewProvider>` above it. */
+export declare function useRunning(): Running;
+//# sourceMappingURL=use-running.service.d.ts.map

package/build/services/previews/use-running.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-running.service.d.ts","sourceRoot":"","sources":["../../../src/services/previews/use-running.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,mCAAmC,CAAC;AAE7E,0FAA0F;AAC1F,wBAAgB,UAAU,IAAI,OAAO,CAcpC"}

package/build/services/previews/use-running.service.js

@@ -0,0 +1,21 @@
+import { nativeModule } from "../native/native.service";
+import { usePreview } from "./use-preview.service";
+import { useDevPreviewServersState } from "../../stores/dev-preview-servers/dev-preview-servers.store";
+import { runningNow } from "../../utils/previews/running.util";
+/** What runs now, read from the package's state. Needs a `<PreviewProvider>` above it. */
+export function useRunning() {
+    const preview = usePreview();
+    const local = useDevPreviewServersState();
+    const showLocal = __DEV__ && preview.devPreviewServers;
+    // The first poll fills activeUrl a moment after the list mounts, but native knows it from the start.
+    const localUrl = showLocal
+        ? (local.activeUrl ?? nativeModule()?.state().localServer ?? null)
+        : null;
+    return runningNow({
+        items: preview.items,
+        activeId: preview.activeId,
+        localUrl,
+        servers: local.servers,
+    });
+}
+//# sourceMappingURL=use-running.service.js.map

package/build/services/previews/use-running.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-running.service.js","sourceRoot":"","sources":["../../../src/services/previews/use-running.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4DAA4D,CAAC;AACvG,OAAO,EAAgB,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAE7E,0FAA0F;AAC1F,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,yBAAyB,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IACvD,qGAAqG;IACrG,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,IAAI,IAAI,CAAC;QAClE,CAAC,CAAC,IAAI,CAAC;IACT,OAAO,UAAU,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ;QACR,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { nativeModule } from \"../native/native.service\";\nimport { usePreview } from \"./use-preview.service\";\nimport { useDevPreviewServersState } from \"../../stores/dev-preview-servers/dev-preview-servers.store\";\nimport { type Running, runningNow } from \"../../utils/previews/running.util\";\n\n/** What runs now, read from the package's state. Needs a `<PreviewProvider>` above it. */\nexport function useRunning(): Running {\n  const preview = usePreview();\n  const local = useDevPreviewServersState();\n  const showLocal = __DEV__ && preview.devPreviewServers;\n  // The first poll fills activeUrl a moment after the list mounts, but native knows it from the start.\n  const localUrl = showLocal\n    ? (local.activeUrl ?? nativeModule()?.state().localServer ?? null)\n    : null;\n  return runningNow({\n    items: preview.items,\n    activeId: preview.activeId,\n    localUrl,\n    servers: local.servers,\n  });\n}\n"]}

package/build/services/publish/bundle.service.d.ts

@@ -0,0 +1,11 @@
+import { ManifestFile, Platform } from "../../utils/previews/layout.util";
+export type BuiltFile = ManifestFile & {
+    absolutePath: string;
+};
+export declare const hermesVersion: (bundle: Buffer) => number | null;
+/** The same release bundle and images the native build embeds, as Hermes bytecode. */
+export declare function buildBundle(projectRoot: string, platform: Platform, entryFile?: string): {
+    files: BuiltFile[];
+    hermesVersion: number | null;
+};
+//# sourceMappingURL=bundle.service.d.ts.map

package/build/services/publish/bundle.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.service.d.ts","sourceRoot":"","sources":["../../../src/services/publish/bundle.service.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,YAAY,EACZ,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAWhE,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,IAG9C,CAAC;AAEX,sFAAsF;AACtF,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,MAAM;;;EA8BnB"}

package/build/services/publish/bundle.service.js

@@ -0,0 +1,46 @@
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { mkdtempSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, relative, sep } from "node:path";
+import { BUNDLE_FILE, } from "../../utils/previews/layout.util";
+const walk = (dir) => readdirSync(dir, { withFileTypes: true }).flatMap((entry) => entry.isDirectory() ? walk(join(dir, entry.name)) : [join(dir, entry.name)]);
+/** Hermes bytecode starts with an 8-byte magic number, then its version as a 32-bit int. */
+const HERMES_MAGIC = Buffer.from([
+    0xc6, 0x1f, 0xbc, 0x03, 0xc1, 0x03, 0x19, 0x1f,
+]);
+export const hermesVersion = (bundle) => bundle.length >= 12 && bundle.subarray(0, 8).equals(HERMES_MAGIC)
+    ? bundle.readUInt32LE(8)
+    : null;
+/** The same release bundle and images the native build embeds, as Hermes bytecode. */
+export function buildBundle(projectRoot, platform, entryFile) {
+    const out = mkdtempSync(join(tmpdir(), `preview-${platform}-`));
+    const args = [
+        "expo",
+        "export:embed",
+        "--platform",
+        platform,
+        "--dev",
+        "false",
+        "--bytecode",
+        "--bundle-output",
+        join(out, BUNDLE_FILE[platform]),
+        "--assets-dest",
+        out,
+    ];
+    if (entryFile)
+        args.push("--entry-file", entryFile);
+    execFileSync("npx", args, { cwd: projectRoot, stdio: "inherit" });
+    const files = walk(out).map((absolutePath) => {
+        const data = readFileSync(absolutePath);
+        return {
+            absolutePath,
+            path: relative(out, absolutePath).split(sep).join("/"),
+            sha256: createHash("sha256").update(data).digest("hex"),
+            size: statSync(absolutePath).size,
+        };
+    });
+    const bundle = readFileSync(join(out, BUNDLE_FILE[platform]));
+    return { files, hermesVersion: hermesVersion(bundle) };
+}
+//# sourceMappingURL=bundle.service.js.map

package/build/services/publish/bundle.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.service.js","sourceRoot":"","sources":["../../../src/services/publish/bundle.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { createHash } from \"node:crypto\";\nimport { mkdtempSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join, relative, sep } from \"node:path\";\n\nimport {\n  BUNDLE_FILE,\n  ManifestFile,\n  Platform,\n} from \"../../utils/previews/layout.util\";\n\nexport type BuiltFile = ManifestFile & { absolutePath: string };\n\nconst walk = (dir: string): string[] =>\n  readdirSync(dir, { withFileTypes: true }).flatMap((entry) =>\n    entry.isDirectory() ? walk(join(dir, entry.name)) : [join(dir, entry.name)],\n  );\n\n/** Hermes bytecode starts with an 8-byte magic number, then its version as a 32-bit int. */\nconst HERMES_MAGIC = Buffer.from([\n  0xc6, 0x1f, 0xbc, 0x03, 0xc1, 0x03, 0x19, 0x1f,\n]);\nexport const hermesVersion = (bundle: Buffer): number | null =>\n  bundle.length >= 12 && bundle.subarray(0, 8).equals(HERMES_MAGIC)\n    ? bundle.readUInt32LE(8)\n    : null;\n\n/** The same release bundle and images the native build embeds, as Hermes bytecode. */\nexport function buildBundle(\n  projectRoot: string,\n  platform: Platform,\n  entryFile?: string,\n) {\n  const out = mkdtempSync(join(tmpdir(), `preview-${platform}-`));\n  const args = [\n    \"expo\",\n    \"export:embed\",\n    \"--platform\",\n    platform,\n    \"--dev\",\n    \"false\",\n    \"--bytecode\",\n    \"--bundle-output\",\n    join(out, BUNDLE_FILE[platform]),\n    \"--assets-dest\",\n    out,\n  ];\n  if (entryFile) args.push(\"--entry-file\", entryFile);\n  execFileSync(\"npx\", args, { cwd: projectRoot, stdio: \"inherit\" });\n\n  const files: BuiltFile[] = walk(out).map((absolutePath) => {\n    const data = readFileSync(absolutePath);\n    return {\n      absolutePath,\n      path: relative(out, absolutePath).split(sep).join(\"/\"),\n      sha256: createHash(\"sha256\").update(data).digest(\"hex\"),\n      size: statSync(absolutePath).size,\n    };\n  });\n  const bundle = readFileSync(join(out, BUNDLE_FILE[platform]));\n  return { files, hermesVersion: hermesVersion(bundle) };\n}\n"]}

package/build/services/publish/commands.service.d.ts

@@ -0,0 +1,23 @@
+import { Compatibility, Platform } from "../../utils/previews/layout.util";
+import { S3Config } from "../s3/s3.service";
+import { AppConfig } from "../../utils/config/expo-config.util";
+export type PublishOptions = {
+    projectRoot: string;
+    config: AppConfig;
+    compatibility: Compatibility;
+    s3: S3Config;
+    platforms: Platform[];
+    id: string;
+    title?: string;
+    branch: string;
+    commit: string;
+    author: string;
+    changelog: string;
+    entryFile?: string;
+};
+export declare function publish(options: PublishOptions): Promise<void>;
+/** Removes the preview from every build's list. Its files stay until `prune`. */
+export declare function unpublish(s3: S3Config, id: string): Promise<void>;
+/** Deletes every file that no manifest refers to. */
+export declare function prune(s3: S3Config): Promise<void>;
+//# sourceMappingURL=commands.service.d.ts.map

package/build/services/publish/commands.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.service.d.ts","sourceRoot":"","sources":["../../../src/services/publish/commands.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,aAAa,EAGb,QAAQ,EAST,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,QAAQ,EAOT,MAAM,kBAAkB,CAAC;AAU1B,OAAO,EACL,SAAS,EAGV,MAAM,qCAAqC,CAAC;AA8B7C,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,iBA4FpD;AAED,iFAAiF;AACjF,wBAAsB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,iBAoBvD;AAED,qDAAqD;AACrD,wBAAsB,KAAK,CAAC,EAAE,EAAE,QAAQ,iBAavC"}

package/build/services/publish/commands.service.js

@@ -0,0 +1,130 @@
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { BUNDLE_FILE, ROOT_INDEX_KEY, SCHEMA, compatibilityKey, fileKey, manifestKey, platformIndexKey, } from "../../utils/previews/layout.util";
+import { deleteObject, exists, getJson, listKeys, objectUrl, putObject, } from "../s3/s3.service";
+import { previewTitle } from "../../utils/previews/preview-title.util";
+import { buildBundle } from "./bundle.service";
+import { shortChangelog } from "../../utils/publish/changelog.util";
+import { indexesListing, removePreview, syncRootVersion, upsertPreview, } from "../../utils/publish/indexes.util";
+import { appVersionOf, buildNumberOf, } from "../../utils/config/expo-config.util";
+import { fingerprint } from "../cli/project.service";
+const log = (message) => process.stdout.write(`${message}\n`);
+/**
+ * Read, change, write back only if nobody else wrote in between (the ETag still matches), and
+ * start over when someone did. This is what keeps two publishes at once from losing an entry.
+ */
+async function updateJson(s3, key, change, attempts = 8) {
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        const current = await getJson(s3, key);
+        const next = change(current?.data ?? null);
+        const written = await putObject(s3, key, JSON.stringify(next, null, 2), {
+            contentType: "application/json",
+            etag: current?.etag ?? null,
+        });
+        if (written)
+            return next;
+        await new Promise((r) => setTimeout(r, 100 * attempt + Math.random() * 200));
+    }
+    throw new Error(`Gave up writing ${key}: it kept changing under us`);
+}
+export async function publish(options) {
+    const { s3, id } = options;
+    const title = options.title || previewTitle(id);
+    const publishedAt = new Date().toISOString();
+    for (const platform of options.platforms) {
+        log(`\n${platform}: building ${id}`);
+        const { files, hermesVersion } = buildBundle(options.projectRoot, platform, options.entryFile);
+        const fp = await fingerprint(options.projectRoot, platform);
+        const version = appVersionOf(options.config, platform);
+        const key = compatibilityKey(options.compatibility, options.compatibility === "appVersion" ? version : fp);
+        let uploaded = 0;
+        for (const file of files) {
+            if (await exists(s3, fileKey(file.sha256)))
+                continue;
+            await putObject(s3, fileKey(file.sha256), readFileSync(file.absolutePath));
+            uploaded++;
+        }
+        log(`${platform}: ${files.length} files, ${uploaded} new`);
+        const info = {
+            id,
+            title,
+            branch: options.branch,
+            commit: options.commit,
+            author: options.author,
+            publishedAt,
+            appVersion: version,
+            buildNumber: buildNumberOf(options.config, platform),
+            compatibility: options.compatibility,
+            fingerprint: fp,
+        };
+        const manifest = {
+            schema: SCHEMA,
+            ...info,
+            platform,
+            key,
+            bundle: BUNDLE_FILE[platform],
+            hermesVersion,
+            changelog: options.changelog,
+            files: files.map(({ path, sha256, size }) => ({ path, sha256, size })),
+        };
+        const manifestPath = manifestKey(platform, key, id);
+        await putObject(s3, manifestPath, JSON.stringify(manifest, null, 2), {
+            contentType: "application/json",
+        });
+        const entry = {
+            ...info,
+            revision: createHash("sha256")
+                .update(manifest.files
+                .map((f) => `${f.path}:${f.sha256}`)
+                .sort()
+                .join("\n"))
+                .digest("hex")
+                .slice(0, 16),
+            size: files.reduce((sum, f) => sum + f.size, 0),
+            changelog: shortChangelog(options.changelog),
+            manifest: manifestPath,
+        };
+        // Last, so an app never sees an entry whose files are not all there yet.
+        const index = await updateJson(s3, platformIndexKey(platform, key), (current) => upsertPreview(current, platform, { key, compatibility: options.compatibility }, entry, publishedAt));
+        await updateJson(s3, ROOT_INDEX_KEY, (root) => syncRootVersion(root, index, publishedAt));
+        log(`${platform}: published ${id} for build ${key}`);
+        log(`${platform}: ${objectUrl(s3, platformIndexKey(platform, key))}`);
+    }
+}
+/** Removes the preview from every build's list. Its files stay until `prune`. */
+export async function unpublish(s3, id) {
+    const root = await getJson(s3, ROOT_INDEX_KEY);
+    const keys = indexesListing(root?.data ?? null, id);
+    if (keys.length === 0) {
+        log(`${id} is not published`);
+        return;
+    }
+    const now = new Date().toISOString();
+    for (const key of keys) {
+        const index = await updateJson(s3, key, (current) => {
+            if (!current)
+                throw new Error(`${key} is listed in ${ROOT_INDEX_KEY} but missing`);
+            return removePreview(current, id, now);
+        });
+        await deleteObject(s3, manifestKey(index.platform, index.key, id));
+        await updateJson(s3, ROOT_INDEX_KEY, (current) => syncRootVersion(current, index, now));
+        log(`unpublished ${id} from ${key}`);
+    }
+}
+/** Deletes every file that no manifest refers to. */
+export async function prune(s3) {
+    const referenced = new Set();
+    for (const key of await listKeys(s3, "previews/")) {
+        const manifest = await getJson(s3, key);
+        manifest?.data.files.forEach((f) => referenced.add(fileKey(f.sha256)));
+    }
+    let removed = 0;
+    for (const key of await listKeys(s3, "files/")) {
+        if (referenced.has(key))
+            continue;
+        await deleteObject(s3, key);
+        removed++;
+    }
+    log(`pruned ${removed} files, kept ${referenced.size}`);
+}
+//# sourceMappingURL=commands.service.js.map

package/build/services/publish/commands.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.service.js","sourceRoot":"","sources":["../../../src/services/publish/commands.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\n\nimport {\n  BUNDLE_FILE,\n  Compatibility,\n  IndexEntry,\n  Manifest,\n  Platform,\n  PlatformIndex,\n  ROOT_INDEX_KEY,\n  RootIndex,\n  SCHEMA,\n  compatibilityKey,\n  fileKey,\n  manifestKey,\n  platformIndexKey,\n} from \"../../utils/previews/layout.util\";\nimport {\n  S3Config,\n  deleteObject,\n  exists,\n  getJson,\n  listKeys,\n  objectUrl,\n  putObject,\n} from \"../s3/s3.service\";\nimport { previewTitle } from \"../../utils/previews/preview-title.util\";\nimport { buildBundle } from \"./bundle.service\";\nimport { shortChangelog } from \"../../utils/publish/changelog.util\";\nimport {\n  indexesListing,\n  removePreview,\n  syncRootVersion,\n  upsertPreview,\n} from \"../../utils/publish/indexes.util\";\nimport {\n  AppConfig,\n  appVersionOf,\n  buildNumberOf,\n} from \"../../utils/config/expo-config.util\";\nimport { fingerprint } from \"../cli/project.service\";\n\nconst log = (message: string) => process.stdout.write(`${message}\\n`);\n\n/**\n * Read, change, write back only if nobody else wrote in between (the ETag still matches), and\n * start over when someone did. This is what keeps two publishes at once from losing an entry.\n */\nasync function updateJson<T>(\n  s3: S3Config,\n  key: string,\n  change: (current: T | null) => T,\n  attempts = 8,\n): Promise<T> {\n  for (let attempt = 1; attempt <= attempts; attempt++) {\n    const current = await getJson<T>(s3, key);\n    const next = change(current?.data ?? null);\n    const written = await putObject(s3, key, JSON.stringify(next, null, 2), {\n      contentType: \"application/json\",\n      etag: current?.etag ?? null,\n    });\n    if (written) return next;\n    await new Promise((r) =>\n      setTimeout(r, 100 * attempt + Math.random() * 200),\n    );\n  }\n  throw new Error(`Gave up writing ${key}: it kept changing under us`);\n}\n\nexport type PublishOptions = {\n  projectRoot: string;\n  config: AppConfig;\n  compatibility: Compatibility;\n  s3: S3Config;\n  platforms: Platform[];\n  id: string;\n  title?: string;\n  branch: string;\n  commit: string;\n  author: string;\n  changelog: string;\n  entryFile?: string;\n};\n\nexport async function publish(options: PublishOptions) {\n  const { s3, id } = options;\n  const title = options.title || previewTitle(id);\n  const publishedAt = new Date().toISOString();\n\n  for (const platform of options.platforms) {\n    log(`\\n${platform}: building ${id}`);\n    const { files, hermesVersion } = buildBundle(\n      options.projectRoot,\n      platform,\n      options.entryFile,\n    );\n    const fp = await fingerprint(options.projectRoot, platform);\n    const version = appVersionOf(options.config, platform);\n    const key = compatibilityKey(\n      options.compatibility,\n      options.compatibility === \"appVersion\" ? version : fp,\n    );\n\n    let uploaded = 0;\n    for (const file of files) {\n      if (await exists(s3, fileKey(file.sha256))) continue;\n      await putObject(\n        s3,\n        fileKey(file.sha256),\n        readFileSync(file.absolutePath),\n      );\n      uploaded++;\n    }\n    log(`${platform}: ${files.length} files, ${uploaded} new`);\n\n    const info = {\n      id,\n      title,\n      branch: options.branch,\n      commit: options.commit,\n      author: options.author,\n      publishedAt,\n      appVersion: version,\n      buildNumber: buildNumberOf(options.config, platform),\n      compatibility: options.compatibility,\n      fingerprint: fp,\n    };\n    const manifest: Manifest = {\n      schema: SCHEMA,\n      ...info,\n      platform,\n      key,\n      bundle: BUNDLE_FILE[platform],\n      hermesVersion,\n      changelog: options.changelog,\n      files: files.map(({ path, sha256, size }) => ({ path, sha256, size })),\n    };\n    const manifestPath = manifestKey(platform, key, id);\n    await putObject(s3, manifestPath, JSON.stringify(manifest, null, 2), {\n      contentType: \"application/json\",\n    });\n\n    const entry: IndexEntry = {\n      ...info,\n      revision: createHash(\"sha256\")\n        .update(\n          manifest.files\n            .map((f) => `${f.path}:${f.sha256}`)\n            .sort()\n            .join(\"\\n\"),\n        )\n        .digest(\"hex\")\n        .slice(0, 16),\n      size: files.reduce((sum, f) => sum + f.size, 0),\n      changelog: shortChangelog(options.changelog),\n      manifest: manifestPath,\n    };\n    // Last, so an app never sees an entry whose files are not all there yet.\n    const index = await updateJson<PlatformIndex>(\n      s3,\n      platformIndexKey(platform, key),\n      (current) =>\n        upsertPreview(\n          current,\n          platform,\n          { key, compatibility: options.compatibility },\n          entry,\n          publishedAt,\n        ),\n    );\n    await updateJson<RootIndex>(s3, ROOT_INDEX_KEY, (root) =>\n      syncRootVersion(root, index, publishedAt),\n    );\n    log(`${platform}: published ${id} for build ${key}`);\n    log(`${platform}: ${objectUrl(s3, platformIndexKey(platform, key))}`);\n  }\n}\n\n/** Removes the preview from every build's list. Its files stay until `prune`. */\nexport async function unpublish(s3: S3Config, id: string) {\n  const root = await getJson<RootIndex>(s3, ROOT_INDEX_KEY);\n  const keys = indexesListing(root?.data ?? null, id);\n  if (keys.length === 0) {\n    log(`${id} is not published`);\n    return;\n  }\n  const now = new Date().toISOString();\n  for (const key of keys) {\n    const index = await updateJson<PlatformIndex>(s3, key, (current) => {\n      if (!current)\n        throw new Error(`${key} is listed in ${ROOT_INDEX_KEY} but missing`);\n      return removePreview(current, id, now);\n    });\n    await deleteObject(s3, manifestKey(index.platform, index.key, id));\n    await updateJson<RootIndex>(s3, ROOT_INDEX_KEY, (current) =>\n      syncRootVersion(current, index, now),\n    );\n    log(`unpublished ${id} from ${key}`);\n  }\n}\n\n/** Deletes every file that no manifest refers to. */\nexport async function prune(s3: S3Config) {\n  const referenced = new Set<string>();\n  for (const key of await listKeys(s3, \"previews/\")) {\n    const manifest = await getJson<Manifest>(s3, key);\n    manifest?.data.files.forEach((f) => referenced.add(fileKey(f.sha256)));\n  }\n  let removed = 0;\n  for (const key of await listKeys(s3, \"files/\")) {\n    if (referenced.has(key)) continue;\n    await deleteObject(s3, key);\n    removed++;\n  }\n  log(`pruned ${removed} files, kept ${referenced.size}`);\n}\n"]}

package/build/services/publish/eas-env.service.d.ts

@@ -0,0 +1,9 @@
+/**
+ * An EAS environment's variables, as `eas env:pull` gives them. Pulled into a temp folder outside
+ * the project and deleted after. Secret-visibility variables never leave EAS servers: `env:pull`
+ * writes them as comments, so they are missing here.
+ */
+export declare function pullEasEnv(projectRoot: string, environment: string): Record<string, string>;
+/** Adds the EAS values to `env`; a variable already set there (the shell's) wins. */
+export declare function applyEasEnv(projectRoot: string, environment: string, env?: Record<string, string | undefined>): void;
+//# sourceMappingURL=eas-env.service.d.ts.map

package/build/services/publish/eas-env.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eas-env.service.d.ts","sourceRoot":"","sources":["../../../src/services/publish/eas-env.service.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxB;AAsBD,qFAAqF;AACrF,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,QAMtD"}

package/build/services/publish/eas-env.service.js

@@ -0,0 +1,49 @@
+import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { parseEnv } from "node:util";
+/**
+ * An EAS environment's variables, as `eas env:pull` gives them. Pulled into a temp folder outside
+ * the project and deleted after. Secret-visibility variables never leave EAS servers: `env:pull`
+ * writes them as comments, so they are missing here.
+ */
+export function pullEasEnv(projectRoot, environment) {
+    const dir = mkdtempSync(join(tmpdir(), "preview-eas-env-"));
+    const file = join(dir, ".env");
+    try {
+        execFileSync("eas", [
+            "env:pull",
+            "--environment",
+            environment,
+            "--non-interactive",
+            "--path",
+            file,
+        ], { cwd: projectRoot, encoding: "utf8", stdio: "pipe" });
+        return parseEnv(readFileSync(file, "utf8"));
+    }
+    catch (error) {
+        throw easError(error, environment);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+function easError(error, environment) {
+    const e = error;
+    if (e.code === "ENOENT")
+        return new Error("--environment needs eas-cli: npm install -g eas-cli, then eas login.");
+    const output = `${e.stdout ?? ""}${e.stderr ?? ""}`;
+    if (output.includes("An Expo user account is required"))
+        return new Error("--environment needs an Expo login: run eas login, or set EXPO_TOKEN in CI.");
+    if (output.includes("eas init"))
+        return new Error("--environment needs the project linked to EAS: run eas init in the app's root.");
+    return new Error(`eas env:pull --environment ${environment} failed:\n${output.trim() || String(error)}`);
+}
+/** Adds the EAS values to `env`; a variable already set there (the shell's) wins. */
+export function applyEasEnv(projectRoot, environment, env = process.env) {
+    for (const [name, value] of Object.entries(pullEasEnv(projectRoot, environment)))
+        if (env[name] === undefined)
+            env[name] = value;
+}
+//# sourceMappingURL=eas-env.service.js.map

package/build/services/publish/eas-env.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eas-env.service.js","sourceRoot":"","sources":["../../../src/services/publish/eas-env.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,WAAmB,EACnB,WAAmB;IAEnB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,YAAY,CACV,KAAK,EACL;YACE,UAAU;YACV,eAAe;YACf,WAAW;YACX,mBAAmB;YACnB,QAAQ;YACR,IAAI;SACL,EACD,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CACtD,CAAC;QACF,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA2B,CAAC;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,WAAmB;IACnD,MAAM,CAAC,GAAG,KAA4D,CAAC;IACvE,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QACrB,OAAO,IAAI,KAAK,CACd,sEAAsE,CACvE,CAAC;IACJ,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IACpD,IAAI,MAAM,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACrD,OAAO,IAAI,KAAK,CACd,4EAA4E,CAC7E,CAAC;IACJ,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC7B,OAAO,IAAI,KAAK,CACd,gFAAgF,CACjF,CAAC;IACJ,OAAO,IAAI,KAAK,CACd,8BAA8B,WAAW,aAAa,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,WAAW,CACzB,WAAmB,EACnB,WAAmB,EACnB,MAA0C,OAAO,CAAC,GAAG;IAErD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CACxC,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,CACrC;QACC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AACnD,CAAC","sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { mkdtempSync, readFileSync, rmSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { parseEnv } from \"node:util\";\n\n/**\n * An EAS environment's variables, as `eas env:pull` gives them. Pulled into a temp folder outside\n * the project and deleted after. Secret-visibility variables never leave EAS servers: `env:pull`\n * writes them as comments, so they are missing here.\n */\nexport function pullEasEnv(\n  projectRoot: string,\n  environment: string,\n): Record<string, string> {\n  const dir = mkdtempSync(join(tmpdir(), \"preview-eas-env-\"));\n  const file = join(dir, \".env\");\n  try {\n    execFileSync(\n      \"eas\",\n      [\n        \"env:pull\",\n        \"--environment\",\n        environment,\n        \"--non-interactive\",\n        \"--path\",\n        file,\n      ],\n      { cwd: projectRoot, encoding: \"utf8\", stdio: \"pipe\" },\n    );\n    return parseEnv(readFileSync(file, \"utf8\")) as Record<string, string>;\n  } catch (error) {\n    throw easError(error, environment);\n  } finally {\n    rmSync(dir, { recursive: true, force: true });\n  }\n}\n\nfunction easError(error: unknown, environment: string): Error {\n  const e = error as { code?: string; stdout?: string; stderr?: string };\n  if (e.code === \"ENOENT\")\n    return new Error(\n      \"--environment needs eas-cli: npm install -g eas-cli, then eas login.\",\n    );\n  const output = `${e.stdout ?? \"\"}${e.stderr ?? \"\"}`;\n  if (output.includes(\"An Expo user account is required\"))\n    return new Error(\n      \"--environment needs an Expo login: run eas login, or set EXPO_TOKEN in CI.\",\n    );\n  if (output.includes(\"eas init\"))\n    return new Error(\n      \"--environment needs the project linked to EAS: run eas init in the app's root.\",\n    );\n  return new Error(\n    `eas env:pull --environment ${environment} failed:\\n${output.trim() || String(error)}`,\n  );\n}\n\n/** Adds the EAS values to `env`; a variable already set there (the shell's) wins. */\nexport function applyEasEnv(\n  projectRoot: string,\n  environment: string,\n  env: Record<string, string | undefined> = process.env,\n) {\n  for (const [name, value] of Object.entries(\n    pullEasEnv(projectRoot, environment),\n  ))\n    if (env[name] === undefined) env[name] = value;\n}\n"]}

package/build/services/registry/registry.service.d.ts

@@ -0,0 +1,27 @@
+import { type Server } from "node:http";
+import { type RegisteredServer } from "../../constants/dev-preview-servers/dev-preview-servers.const";
+/** The registry's memory: servers by id, each dropped once it misses its heartbeats. */
+export declare class ServerList {
+    private readonly ttlMs;
+    private entries;
+    constructor(ttlMs?: number);
+    upsert(server: RegisteredServer, now: number): void;
+    remove(id: string): void;
+    /** The live servers, after dropping the ones whose heartbeat stopped. */
+    alive(now: number): RegisteredServer[];
+}
+/**
+ * `GET /servers` lists the live servers; `POST /servers` registers one or renews its heartbeat;
+ * `DELETE /servers/<id>` removes one. Plain HTTP, so the app reads it with `fetch` and `curl`
+ * shows it too. Once it has been empty for `idleExitMs`, `onIdle` is called.
+ */
+export declare function createRegistry(options?: {
+    ttlMs?: number;
+    idleExitMs?: number;
+    onIdle?: () => void;
+    now?: () => number;
+}): {
+    server: Server;
+    list: ServerList;
+};
+//# sourceMappingURL=registry.service.d.ts.map

package/build/services/registry/registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.service.d.ts","sourceRoot":"","sources":["../../../src/services/registry/registry.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5E,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,+DAA+D,CAAC;AAIvE,wFAAwF;AACxF,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,OAAO,CAA4B;gBAEd,KAAK,SAAgB;IAElD,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM;IAI5C,MAAM,CAAC,EAAE,EAAE,MAAM;IAIjB,yEAAyE;IACzE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,EAAE;CAQvC;AAUD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACf,GACL;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CA+CtC"}

package/build/services/registry/registry.service.js

@@ -0,0 +1,89 @@
+import { createServer } from "node:http";
+import { SERVER_TTL_MS, } from "../../constants/dev-preview-servers/dev-preview-servers.const";
+/** The registry's memory: servers by id, each dropped once it misses its heartbeats. */
+export class ServerList {
+    ttlMs;
+    entries = new Map();
+    constructor(ttlMs = SERVER_TTL_MS) {
+        this.ttlMs = ttlMs;
+    }
+    upsert(server, now) {
+        this.entries.set(server.id, { server, lastSeen: now });
+    }
+    remove(id) {
+        this.entries.delete(id);
+    }
+    /** The live servers, after dropping the ones whose heartbeat stopped. */
+    alive(now) {
+        for (const [id, entry] of this.entries) {
+            if (now - entry.lastSeen > this.ttlMs)
+                this.entries.delete(id);
+        }
+        return [...this.entries.values()]
+            .map((e) => e.server)
+            .sort((a, b) => a.port - b.port);
+    }
+}
+const readBody = (req) => new Promise((resolve, reject) => {
+    let body = "";
+    req.on("data", (chunk) => (body += chunk));
+    req.on("end", () => resolve(body));
+    req.on("error", reject);
+});
+/**
+ * `GET /servers` lists the live servers; `POST /servers` registers one or renews its heartbeat;
+ * `DELETE /servers/<id>` removes one. Plain HTTP, so the app reads it with `fetch` and `curl`
+ * shows it too. Once it has been empty for `idleExitMs`, `onIdle` is called.
+ */
+export function createRegistry(options = {}) {
+    const now = options.now ?? Date.now;
+    const list = new ServerList(options.ttlMs);
+    let emptySince = now();
+    const server = createServer(async (req, res) => {
+        const send = (status, body) => {
+            res.writeHead(status, {
+                "content-type": "application/json",
+                "cache-control": "no-store",
+            });
+            res.end(body === undefined ? "" : JSON.stringify(body));
+        };
+        try {
+            if (req.method === "GET" && req.url === "/servers") {
+                send(200, { servers: list.alive(now()) });
+            }
+            else if (req.method === "POST" && req.url === "/servers") {
+                const entry = JSON.parse(await readBody(req));
+                if (typeof entry.id !== "string" || typeof entry.port !== "number") {
+                    send(400, { error: "id and port are required" });
+                    return;
+                }
+                list.upsert(entry, now());
+                send(204);
+            }
+            else if (req.method === "DELETE" && req.url?.startsWith("/servers/")) {
+                list.remove(decodeURIComponent(req.url.slice("/servers/".length)));
+                send(204);
+            }
+            else {
+                send(404, { error: "not found" });
+            }
+        }
+        catch (error) {
+            send(400, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+    if (options.onIdle) {
+        const timer = setInterval(() => {
+            if (list.alive(now()).length > 0)
+                emptySince = now();
+            else if (now() - emptySince > (options.idleExitMs ?? 30000))
+                options.onIdle?.();
+        }, 1000);
+        timer.unref();
+        server.on("close", () => clearInterval(timer));
+    }
+    return { server, list };
+}
+//# sourceMappingURL=registry.service.js.map

package/build/services/registry/registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.service.js","sourceRoot":"","sources":["../../../src/services/registry/registry.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { createServer, type IncomingMessage, type Server } from \"node:http\";\n\nimport {\n  type RegisteredServer,\n  SERVER_TTL_MS,\n} from \"../../constants/dev-preview-servers/dev-preview-servers.const\";\n\ntype Entry = { server: RegisteredServer; lastSeen: number };\n\n/** The registry's memory: servers by id, each dropped once it misses its heartbeats. */\nexport class ServerList {\n  private entries = new Map<string, Entry>();\n\n  constructor(private readonly ttlMs = SERVER_TTL_MS) {}\n\n  upsert(server: RegisteredServer, now: number) {\n    this.entries.set(server.id, { server, lastSeen: now });\n  }\n\n  remove(id: string) {\n    this.entries.delete(id);\n  }\n\n  /** The live servers, after dropping the ones whose heartbeat stopped. */\n  alive(now: number): RegisteredServer[] {\n    for (const [id, entry] of this.entries) {\n      if (now - entry.lastSeen > this.ttlMs) this.entries.delete(id);\n    }\n    return [...this.entries.values()]\n      .map((e) => e.server)\n      .sort((a, b) => a.port - b.port);\n  }\n}\n\nconst readBody = (req: IncomingMessage) =>\n  new Promise<string>((resolve, reject) => {\n    let body = \"\";\n    req.on(\"data\", (chunk) => (body += chunk));\n    req.on(\"end\", () => resolve(body));\n    req.on(\"error\", reject);\n  });\n\n/**\n * `GET /servers` lists the live servers; `POST /servers` registers one or renews its heartbeat;\n * `DELETE /servers/<id>` removes one. Plain HTTP, so the app reads it with `fetch` and `curl`\n * shows it too. Once it has been empty for `idleExitMs`, `onIdle` is called.\n */\nexport function createRegistry(\n  options: {\n    ttlMs?: number;\n    idleExitMs?: number;\n    onIdle?: () => void;\n    now?: () => number;\n  } = {},\n): { server: Server; list: ServerList } {\n  const now = options.now ?? Date.now;\n  const list = new ServerList(options.ttlMs);\n  let emptySince = now();\n\n  const server = createServer(async (req, res) => {\n    const send = (status: number, body?: unknown) => {\n      res.writeHead(status, {\n        \"content-type\": \"application/json\",\n        \"cache-control\": \"no-store\",\n      });\n      res.end(body === undefined ? \"\" : JSON.stringify(body));\n    };\n    try {\n      if (req.method === \"GET\" && req.url === \"/servers\") {\n        send(200, { servers: list.alive(now()) });\n      } else if (req.method === \"POST\" && req.url === \"/servers\") {\n        const entry = JSON.parse(await readBody(req)) as RegisteredServer;\n        if (typeof entry.id !== \"string\" || typeof entry.port !== \"number\") {\n          send(400, { error: \"id and port are required\" });\n          return;\n        }\n        list.upsert(entry, now());\n        send(204);\n      } else if (req.method === \"DELETE\" && req.url?.startsWith(\"/servers/\")) {\n        list.remove(decodeURIComponent(req.url.slice(\"/servers/\".length)));\n        send(204);\n      } else {\n        send(404, { error: \"not found\" });\n      }\n    } catch (error) {\n      send(400, {\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  });\n\n  if (options.onIdle) {\n    const timer = setInterval(() => {\n      if (list.alive(now()).length > 0) emptySince = now();\n      else if (now() - emptySince > (options.idleExitMs ?? 30000))\n        options.onIdle?.();\n    }, 1000);\n    timer.unref();\n    server.on(\"close\", () => clearInterval(timer));\n  }\n  return { server, list };\n}\n"]}

package/build/services/s3/s3.service.d.ts

@@ -0,0 +1,59 @@
+import { Credentials } from "../../utils/s3/sigv4.util";
+/** Any S3-compatible bucket: AWS S3, Cloudflare R2, MinIO and others. Path-style URLs. */
+export type S3Config = {
+    endpoint: string;
+    /** Left out when `endpoint` already is the bucket's base, as for the app's unsigned reads. */
+    bucket?: string;
+    /** Folder inside the bucket that everything goes under, so several apps can share one bucket. */
+    prefix?: string;
+    region: string;
+    /** Write key in the CLI, read-only key in the app. Without one, requests go unsigned. */
+    credentials?: Credentials;
+    /** Sent with every request, such as a header a proxy or tunnel in front of the bucket wants. */
+    headers?: Record<string, string>;
+};
+/** MinIO and R2 accept it too, so a region is only needed for AWS buckets elsewhere. */
+export declare const DEFAULT_REGION = "us-east-1";
+/**
+ * Splits one URL, `<endpoint>/<bucket>[/<prefix>]`, so a single setting says where everything
+ * lives: `http://localhost:9000/previews-public`, `https://<account>.r2.cloudflarestorage.com/previews/my-app`.
+ */
+export declare function parseBucketUrl(value: string): Pick<S3Config, "endpoint" | "bucket" | "prefix">;
+export declare const objectUrl: (config: S3Config, key: string) => string;
+export declare class S3Error extends Error {
+    readonly status: number;
+    readonly key: string;
+    constructor(status: number, key: string, body: string);
+}
+type Request = {
+    method: string;
+    key?: string;
+    query?: Record<string, string>;
+    body?: Uint8Array | string;
+    headers?: Record<string, string>;
+};
+export declare function s3Fetch(config: S3Config, request: Request): Promise<Response>;
+/** Null when the object does not exist. The ETag is what a conditional put needs. */
+export declare function getJson<T>(config: S3Config, key: string): Promise<{
+    data: T;
+    etag: string | null;
+} | null>;
+/**
+ * Something in front of the bucket answered instead of it: most often a private tunnel or proxy
+ * sending a login page. Say what came back and from where, instead of a bare JSON parse error.
+ */
+export declare function notJsonMessage(url: string, res: Response, body: string): string;
+/**
+ * False when a condition failed (someone else wrote first), so the caller can read again and
+ * retry. `etag: null` means "only if it does not exist yet".
+ */
+export declare function putObject(config: S3Config, key: string, body: Uint8Array | string, options?: {
+    contentType?: string;
+    etag?: string | null;
+}): Promise<boolean>;
+export declare function exists(config: S3Config, key: string): Promise<boolean>;
+export declare function deleteObject(config: S3Config, key: string): Promise<void>;
+/** Every key under the prefix (ListObjectsV2, following continuation tokens). */
+export declare function listKeys(config: S3Config, prefix: string): Promise<string[]>;
+export {};
+//# sourceMappingURL=s3.service.d.ts.map

package/build/services/s3/s3.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.service.d.ts","sourceRoot":"","sources":["../../../src/services/s3/s3.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIZ,MAAM,2BAA2B,CAAC;AAEnC,0FAA0F;AAC1F,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,cAAc,cAAc,CAAC;AAM1C;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAiBlD;AAUD,eAAO,MAAM,SAAS,GAAI,QAAQ,QAAQ,EAAE,KAAK,MAAM,WACO,CAAC;AAE/D,qBAAa,OAAQ,SAAQ,KAAK;IAE9B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM;gBADX,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM;CAIf;AAED,KAAK,OAAO,GAAG;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAsB,OAAO,CAC3B,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED,qFAAqF;AACrF,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CAWlD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC3D,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK5E;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAIf;AAUD,iFAAiF;AACjF,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB"}