photon-msg 0.0.0-stage → 0.1.0

package/dist/upload.js

@@ -0,0 +1,119 @@
+/**
+ * Attachment upload.
+ *
+ * The endpoint takes `multipart/related` with exactly two parts: a JSON
+ * descriptor followed by the raw bytes. We talk to it with fetch directly rather
+ * than through the SDK, because the SDK's upload method expects a
+ * pre-serialized body and would otherwise fight us over the content type.
+ */
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { randomUUID } from "node:crypto";
+import { CliError, EXIT, usageError } from "./errors.js";
+const DEFAULT_BASE_URL = "https://api.photon.codes";
+const TYPES = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    heic: "image/heic",
+    pdf: "application/pdf",
+    mp3: "audio/mpeg",
+    m4a: "audio/mp4",
+    wav: "audio/wav",
+    ogg: "audio/ogg",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    txt: "text/plain",
+};
+/** Best-effort content type from a filename extension. */
+export function contentTypeFor(filename) {
+    const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+    return TYPES[ext] ?? "application/octet-stream";
+}
+/**
+ * Builds the `multipart/related` body by hand so the framing is exactly what the
+ * API documents: two parts, no extra headers. (The API rejects unsupported
+ * content-type parameters and part headers, which is why nothing else is added.)
+ */
+export function buildMultipartRelated({ descriptor, bytes, contentType, boundary, }) {
+    const encoder = new TextEncoder();
+    const head = `--${boundary}\r\n` +
+        "Content-Type: application/json\r\n" +
+        "\r\n" +
+        `${JSON.stringify(descriptor)}\r\n` +
+        `--${boundary}\r\n` +
+        `Content-Type: ${contentType}\r\n` +
+        "\r\n";
+    const tail = `\r\n--${boundary}--\r\n`;
+    const headBytes = encoder.encode(head);
+    const tailBytes = encoder.encode(tail);
+    const body = new Uint8Array(headBytes.length + bytes.length + tailBytes.length);
+    body.set(headBytes, 0);
+    body.set(bytes, headBytes.length);
+    body.set(tailBytes, headBytes.length + bytes.length);
+    return body;
+}
+/** Loads bytes from a local path or an http(s) URL. */
+async function loadSource(source, fetchImpl) {
+    if (/^https?:\/\//i.test(source)) {
+        const response = await fetchImpl(source);
+        if (!response.ok) {
+            throw new CliError(`Could not download ${source}: HTTP ${response.status}`);
+        }
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        return { bytes, filename: basename(new URL(source).pathname) || "download" };
+    }
+    try {
+        const bytes = new Uint8Array(await readFile(source));
+        return { bytes, filename: basename(source) };
+    }
+    catch (error) {
+        throw usageError(`Could not read ${source}: ${error.message}`);
+    }
+}
+/** Creates an uploader bound to one project. Returns an attachment ID. */
+export function createUploader({ apiKey, projectId, baseUrl = DEFAULT_BASE_URL, fetch: fetchImpl = globalThis.fetch, timeoutMs, }) {
+    return async function upload(source, { contentType } = {}) {
+        const { bytes, filename } = await loadSource(source, fetchImpl);
+        if (bytes.length === 0)
+            throw usageError(`${source} is empty.`);
+        const resolvedType = contentType ?? contentTypeFor(filename);
+        const boundary = `photonmsg${randomUUID().replaceAll("-", "")}`;
+        const descriptor = { contentType: resolvedType, sizeBytes: bytes.length, filename };
+        const body = buildMultipartRelated({ descriptor, bytes, contentType: resolvedType, boundary });
+        const url = new URL(`/v1/projects/${projectId}/attachments`, baseUrl).toString();
+        const response = await fetchImpl(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "content-type": `multipart/related; boundary=${boundary}`,
+                "content-length": String(body.length),
+                "idempotency-key": `photon-msg:upload:${randomUUID()}`,
+            },
+            body,
+            ...(timeoutMs ? { signal: AbortSignal.timeout(timeoutMs) } : {}),
+        });
+        const text = await response.text();
+        let payload;
+        try {
+            payload = text ? JSON.parse(text) : {};
+        }
+        catch {
+            payload = { raw: text };
+        }
+        if (!response.ok) {
+            const detail = payload.detail ?? payload.title ?? text.slice(0, 200);
+            throw new CliError(`Attachment upload failed (HTTP ${response.status}): ${detail}`, {
+                exitCode: response.status === 401 ? EXIT.AUTH : response.status === 403 ? EXIT.FORBIDDEN : EXIT.FAILURE,
+                ...(payload.code ? { code: payload.code } : {}),
+            });
+        }
+        const id = payload.id ?? payload.attachmentId ?? payload.attachment?.id;
+        if (!id)
+            throw new CliError("Upload succeeded but the response carried no attachment ID.");
+        return id;
+    };
+}
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "photon-msg",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Command-line client for sending and reading messages through the Photon API",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "photon-msg": "dist/bin.js",
+    "pmsg": "dist/bin.js"
+  },
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build:test": "tsc -p tsconfig.test.json",
+    "test": "npm run build:test && node --test \".test-build/test/*.test.js\"",
+    "test:watch": "npm run build:test && node --test --watch \".test-build/test/*.test.js\"",
+    "clean": "rm -rf dist .test-build",
+    "prepublishOnly": "npm run clean && npm run build",
+    "smoke": "npm run build && node dist/bin.js --help"
+  },
+  "keywords": [
+    "photon",
+    "imessage",
+    "sms",
+    "messaging",
+    "cli"
+  ],
+  "dependencies": {
+    "@photon-ai/api": "^0.6.0"
+  },
+  "types": "dist/index.d.ts",
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}