@spawndotfamily/sdk 0.2.7

package/dist/cli/run.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+// The local npm script executes the TypeScript source directly; the packaged
+// bin executes the JavaScript emitted by tsc.
+const entry = import.meta.url.endsWith('/run.ts') ? './index.ts' : './index.js';
+const { main } = await import(__rewriteRelativeImportExtension(entry));
+const processValue = globalThis.process;
+if (!processValue)
+    throw new Error('The publishing CLI requires Node.js.');
+processValue.exitCode = await main();
+export {};

package/dist/cli/upload-client.d.ts

@@ -0,0 +1,84 @@
+import type { FetchLike, PublishConfig } from './api.ts';
+/** The worker contract fixes every upload chunk at eight mebibytes. */
+export declare const CHUNK_BYTES = 8388608;
+/** Safety ceiling for client-side inspection; the platform's default admission is 1 GB. */
+export declare const STREAM_MAX_TOTAL_BYTES = 8000000000;
+export declare const STREAM_MAX_FILE_BYTES = 8000000000;
+export declare const STREAM_MAX_HTML_BYTES = 1000000;
+export declare const STREAM_MAX_FILES = 1000;
+export declare const STREAM_MAX_TRAVERSED_ENTRIES = 10000;
+export declare const STREAM_MAX_DIRECTORY_DEPTH = 64;
+export declare const STREAM_MAX_RETRIES = 3;
+type NodeStat = {
+    ino: number;
+    dev: number;
+    size: number;
+    mtimeMs?: number;
+    ctimeMs?: number;
+    isDirectory(): boolean;
+    isFile(): boolean;
+    isSymbolicLink(): boolean;
+};
+type NodeFileHandle = {
+    fd: number;
+    read(buffer: Uint8Array, offset: number, length: number, position: number | null): Promise<{
+        bytesRead: number;
+    }>;
+    stat(): Promise<NodeStat>;
+    close(): Promise<void>;
+};
+export type StreamingBuildFile = {
+    path: string;
+    bytes: number;
+    sha256: string;
+};
+export type StreamingBuildManifest = {
+    entry: 'index.html';
+    files: StreamingBuildFile[];
+    sourceCommit?: string;
+};
+export type StreamingBuild = StreamingBuildManifest & {
+    bytes: number;
+};
+export type UploadProgress = Record<string, unknown>;
+export type StreamingPublishOptions = {
+    sourceCommit?: string;
+    onProgress?: (progress: UploadProgress) => void;
+    retries?: number;
+    retryDelayMs?: number;
+    sleep?: (milliseconds: number) => Promise<void>;
+};
+type FileSnapshot = {
+    ino: number;
+    dev: number;
+    size: number;
+    mtimeMs?: number;
+    ctimeMs?: number;
+};
+type PreparedBuildFile = StreamingBuildFile & {
+    absolutePath: string;
+    snapshot: FileSnapshot;
+    chunkSha256: string[];
+};
+type PreparedBuild = StreamingBuild & {
+    root: string;
+    rootSnapshot: FileSnapshot;
+    preparedFiles: PreparedBuildFile[];
+};
+export declare function inspectBrowserBuild(directory: string, sourceCommit?: string): Promise<StreamingBuild>;
+/**
+ * Prepare a local build once for the development launcher. The returned
+ * descriptors retain the canonical root and inspection snapshots so serving
+ * can reopen and verify the same files without rebuilding paths from the
+ * caller's input directory.
+ */
+export declare function inspectBrowserBuildForLocal(directory: string, sourceCommit?: string): Promise<PreparedBuild>;
+/** Derive the only worker origin accepted when credentials omit an explicit one. */
+export declare function deriveUploadOrigin(platformOrigin: string): string;
+/** Reopen a prepared local file and verify its retained root, metadata, and digest before serving it. */
+export declare function openValidatedBuildFile(build: PreparedBuild, file: PreparedBuildFile, cache?: {
+    snapshot?: FileSnapshot;
+    validation?: Promise<void>;
+}): Promise<NodeFileHandle>;
+export declare function publishBrowserDirectory(config: PublishConfig, directory: string, sourceCommit?: string, fetchImplementation?: FetchLike, options?: StreamingPublishOptions): Promise<Record<string, unknown>>;
+export {};