@tpmjs/tools-sprites-checkpoint-create 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,68 @@
+# @tpmjs/sprites-checkpoint-create
+
+Create a point-in-time snapshot (checkpoint) of a sprite's filesystem state for later restoration.
+
+## Installation
+
+```bash
+npm install @tpmjs/sprites-checkpoint-create
+```
+
+## Requirements
+
+- `SPRITES_TOKEN` environment variable - Get your token from https://sprites.dev
+
+## Usage
+
+```typescript
+import { spritesCheckpointCreateTool } from '@tpmjs/sprites-checkpoint-create';
+
+const result = await spritesCheckpointCreateTool.execute({
+  name: 'my-sandbox',
+  checkpointName: 'before-experiment'
+});
+
+console.log(result);
+// {
+//   id: 'chk_abc123',
+//   name: 'before-experiment',
+//   createdAt: '2024-01-15T10:30:00Z',
+//   size: 52428800
+// }
+```
+
+## Input Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | `string` | Yes | Name of the sprite to checkpoint |
+| `checkpointName` | `string` | No | Optional human-readable name for the checkpoint |
+
+## Output
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique checkpoint identifier (use this for restore) |
+| `name` | `string?` | Human-readable checkpoint name if provided |
+| `createdAt` | `string` | ISO 8601 timestamp of creation |
+| `size` | `number?` | Checkpoint size in bytes |
+
+## Use Cases
+
+- Save state before risky operations
+- Create restore points for experiments
+- Backup filesystem before installing packages
+- Version control for sprite state
+
+## Error Handling
+
+The tool throws errors in these cases:
+- `SPRITES_TOKEN` environment variable is not set
+- Sprite not found (HTTP 404)
+- Invalid or expired API token (HTTP 401)
+- Network timeout (120 second limit for large checkpoints)
+- API errors with descriptive messages
+
+## License
+
+MIT

package/dist/index.js

@@ -42,7 +42,7 @@ var spritesCheckpointCreateTool = tool({
         body.name = checkpointName;
       }
       response = await fetch(
-        `${SPRITES_API_BASE}/sprites/${encodeURIComponent(name)}/checkpoints`,
+        `${SPRITES_API_BASE}/sprites/${encodeURIComponent(name)}/checkpoint`,
         {
           method: "POST",
           headers: {
@@ -76,17 +76,40 @@ var spritesCheckpointCreateTool = tool({
         `Failed to create checkpoint for sprite "${name}": HTTP ${response.status} - ${errorText}`
       );
     }
-    let data;
+    let text;
     try {
-      data = await response.json();
+      text = await response.text();
     } catch {
-      throw new Error("Failed to parse response from Sprites API");
+      throw new Error("Failed to read response from Sprites API");
+    }
+    const lines = text.trim().split("\n").filter((line) => line.trim());
+    let checkpointData = null;
+    for (const line of lines) {
+      try {
+        const parsed = JSON.parse(line);
+        if (parsed.id || parsed.checkpoint_id) {
+          checkpointData = parsed;
+        }
+        if (parsed.error) {
+          throw new Error(`Checkpoint creation failed: ${parsed.error}`);
+        }
+      } catch (parseError) {
+        if (parseError instanceof SyntaxError) continue;
+        throw parseError;
+      }
+    }
+    if (!checkpointData) {
+      try {
+        checkpointData = JSON.parse(text);
+      } catch {
+        throw new Error(`Failed to parse checkpoint response. Raw response: ${text.slice(0, 200)}`);
+      }
     }
     return {
-      id: data.id || "",
-      name: data.name || checkpointName,
-      createdAt: data.createdAt || data.created_at || (/* @__PURE__ */ new Date()).toISOString(),
-      size: data.size
+      id: checkpointData.id || checkpointData.checkpoint_id || "",
+      name: checkpointData.name || checkpointName,
+      createdAt: checkpointData.createdAt || checkpointData.created_at || (/* @__PURE__ */ new Date()).toISOString(),
+      size: checkpointData.size
     };
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tpmjs/tools-sprites-checkpoint-create",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Create a point-in-time snapshot of a sprite's filesystem state for later restoration",
   "type": "module",
   "keywords": [
@@ -20,10 +20,16 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  },
   "devDependencies": {
+    "@tpmjs/tsconfig": "workspace:*",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "@tpmjs/tsconfig": "0.0.0"
+    "typescript": "^5.9.3"
   },
   "publishConfig": {
     "access": "public"
@@ -67,11 +73,5 @@
   },
   "dependencies": {
     "ai": "6.0.23"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "type-check": "tsc --noEmit",
-    "clean": "rm -rf dist .turbo"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024-2025 TPMJS
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.