@assembly-js/app-foundation 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -17,6 +17,9 @@ bullets ship. Write `[fix]`, `[behavior]` and `[action]` bullets for the app's o
 A patch release never changes what an app's build requires; a minor release may add or change a
 `bin/check-*.mjs` script. CI fails a PR that changes a check script without a minor bump over main.
 
+## 0.2.1
+- [new] Add `@assembly-js/app-foundation/scripts`, which exports `getOfflineAssembly` without `server-only`, for seed and backfill scripts that run outside Next.
+
 ## 0.2.0
 - [behavior] At the end of every turn the platform compares the operations documented in `.assembly/openapi.json` with the app's API routes and warns the build agent on its next turn about any it cannot find. Nothing in the app changes and the build is unaffected.
 

package/dist/scripts.d.ts

@@ -0,0 +1,8 @@
+import { type AssemblyAPI } from '@assembly-js/node-sdk';
+/**
+ * The script-side counterpart of `getOfflineAssembly` from `/server`: mints a
+ * short-lived app-scoped bearer from `ASSEMBLY_API_KEY` and returns a bearer-only
+ * client. There is no request here, so the viewer-identity guard `/server` applies
+ * does not exist; use this only from scripts, never from code under `app/`.
+ */
+export declare function getOfflineAssembly(): Promise<AssemblyAPI>;

package/dist/scripts.js

@@ -0,0 +1,24 @@
+// Entry point for standalone scripts (seed, backfill, one-off jobs) run with plain
+// `bun`/`node` outside Next. It must not import './server.js', './assembly' or anything
+// else that reaches `server-only` or `next/*`, which throw outside a Next bundle.
+import { assemblyApi } from '@assembly-js/node-sdk';
+import { mintBearerFromAppKey } from './mint-bearer.js';
+/**
+ * The script-side counterpart of `getOfflineAssembly` from `/server`: mints a
+ * short-lived app-scoped bearer from `ASSEMBLY_API_KEY` and returns a bearer-only
+ * client. There is no request here, so the viewer-identity guard `/server` applies
+ * does not exist; use this only from scripts, never from code under `app/`.
+ */
+export async function getOfflineAssembly() {
+    if (!process.env.ASSEMBLY_API_KEY) {
+        throw new Error('getOfflineAssembly: ASSEMBLY_API_KEY is not set — cannot mint an app-scoped bearer');
+    }
+    const minted = await mintBearerFromAppKey();
+    if (!minted) {
+        throw new Error('getOfflineAssembly: failed to mint an app-scoped bearer from the app API key');
+    }
+    return assemblyApi({
+        bearer: minted.bearer,
+        baseUrl: process.env.ASSEMBLY_API_BASE_URL || undefined,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assembly-js/app-foundation",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Versioned foundation helpers and build context for Assembly generated apps",
   "type": "module",
   "files": [
@@ -24,6 +24,10 @@
       "types": "./dist/lib-client.d.ts",
       "default": "./dist/lib-client.js"
     },
+    "./scripts": {
+      "types": "./dist/scripts.d.ts",
+      "default": "./dist/scripts.js"
+    },
     "./next": {
       "types": "./dist/next.d.ts",
       "default": "./dist/next.js"