primitive-functions 0.2.0-alpha.0 → 0.2.0-alpha.10

package/index.js

@@ -24,11 +24,99 @@ const NOT_PROVIDED =
 export const SDK_STUB_VERSION = "0.0.1";
 
 /**
- * Declare a function's handler. The platform copy returns the handler wrapped
- * with its invocation context; this one refuses, loudly.
+ * Declare a function's handler — `defineFunction(handler)` or the keyed
+ * `defineFunction("<key>", handler)`. The platform copy returns the handler
+ * wrapped with its invocation context; this one refuses, loudly, whichever
+ * shape it is called with.
  */
-export function defineFunction() {
+export function defineFunction(_keyOrHandler, _maybeHandler) {
   throw new Error(NOT_PROVIDED);
 }
 
-export default { SDK_STUB_VERSION, defineFunction };
+/**
+ * The platform's cap on a registered query's cache TTL. The stub carries the
+ * value rather than throwing, because it is a constant an author may read at
+ * module scope while type-checking outside a sandbox.
+ */
+export const MAX_QUERY_CACHE_TTL_MS = 60000;
+
+/**
+ * Register a named query or mutation (#3187). Same reason as above: an ESM
+ * named import of an export a module does not have is a LINK error, so the
+ * stub must declare every export the platform copy has — and refuse.
+ */
+export function defineQuery() {
+  throw new Error(NOT_PROVIDED);
+}
+
+export function defineMutation() {
+  throw new Error(NOT_PROVIDED);
+}
+
+/** Bounded-concurrency map. The platform copy implements it; this refuses. */
+export function pMap() {
+  throw new Error(NOT_PROVIDED);
+}
+
+/** A time-ordered ULID, minted by the platform copy. */
+export function ulid() {
+  throw new Error(NOT_PROVIDED);
+}
+
+/**
+ * The per-family durable step policies. The stub carries an empty shape rather
+ * than throwing: it is read at module scope by code that only type-checks.
+ */
+export const PMAP_DEFAULT_CONCURRENCY = 8;
+
+/**
+ * The per-family durable step policies. The stub carries the SHAPE and empty
+ * values: an author may read `stepPolicy.email` at module scope while
+ * type-checking outside a sandbox, and throwing there would break a build that
+ * never runs a function. The platform copy carries the runners' real numbers.
+ */
+export const stepPolicy = {
+  email: null,
+  llm: null,
+  gemini: null,
+  database: null,
+};
+
+/**
+ * The runtime refusal's error class — #3482.
+ *
+ * Carried rather than thrown from: a function narrows a `catch` with
+ * `instanceof FunctionRuntimeError`, and a class that threw on construction
+ * would break a build that only type-checks. The platform copy is the one that
+ * is ever really thrown.
+ */
+export class FunctionRuntimeError extends Error {
+  constructor(message, runtime, required) {
+    super(message);
+    this.name = "FUNCTION_RUNTIME_REFUSED";
+    this.runtime = runtime;
+    this.required = required;
+  }
+}
+
+/**
+ * Refuse the runtime this function was not written for — #3482.
+ *
+ * The platform copy compares the required runtime against the one the isolate
+ * declared. This one refuses, loudly, like every other function here: an
+ * assertion answered outside a sandbox would be answering about nothing.
+ */
+export function assertRuntime() {
+  throw new Error(NOT_PROVIDED);
+}
+
+export default {
+  SDK_STUB_VERSION,
+  defineFunction,
+  defineQuery,
+  defineMutation,
+  pMap,
+  ulid,
+  assertRuntime,
+  FunctionRuntimeError,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primitive-functions",
-  "version": "0.2.0-alpha.0",
+  "version": "0.2.0-alpha.10",
   "description": "The module a Primitive server function imports. Supplied by the platform at invoke time; reserved here so the name is ours before the runtime lands.",
   "license": "UNLICENSED",
   "author": "Primitive LLC",