@pulse-compute/grip 0.0.0 → 1.0.0-beta.1

package/README.md

@@ -1,3 +1,45 @@
 # @pulse-compute/grip
 
-This is an inert namespace-bootstrap package. It contains no executable code.
+<!-- pulse-package-status:start -->
+> **Support tier:** Supported provider/extension surface<br>
+> **Audience:** Applications using stateless GRIP/Fanout HTTP framing and request-bound broadcast behavior.<br>
+> **Install directly:** Yes, only when the application uses GRIP/Fanout behavior.<br>
+> **Supported entry points:** `@pulse-compute/grip`<br>
+> **Stability:** The package root has bounded JavaScript and Native HTTP-framing realization plus configured Node/Fastly broadcast; /pulsewasm remains compatibility-only.<br>
+> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.1/packages/grip/)
+>
+> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.1` package policy.
+<!-- pulse-package-status:end -->
+
+The normal package root provides stateless GRIP/Fanout HTTP framing:
+
+```ts
+import { grip } from '@pulse-compute/grip'
+
+if (grip.isWebSocket(ctx.req)) {
+  return grip.handoff({ channel: 'events:demo' })
+}
+
+return grip.subscribe(new Response(null), {
+  channel: 'events:demo',
+  mode: 'stream',
+})
+```
+
+Outbound publication is the package's request-bound broadcast API and effect:
+
+```ts
+await grip.broadcast(ctx, {
+  channel: 'events:demo',
+  data: { type: 'message', value: 'hello' },
+})
+```
+
+Pulse owns no WebSocket object or connection lifecycle. An external gateway owns connections, fan-out, backpressure, and reconnection. Cross-target conformance covers the bounded JavaScript/Native framing surface and configured Node/Fastly broadcast providers. Native lowering requires supported static options and messages; unsupported expressions fail without target fallback.
+
+`@pulse-compute/grip/pulsewasm` remains a compatibility Native facade for
+existing fixtures and is not recommended for new applications. Migration
+guidance is published at
+<https://pulsecompute.io/v1.0.0-beta.1/guides/compatibility-imports/>.
+
+Broadcast configuration is provider-owned. It requires an explicit publish/control endpoint and may name a bearer-token secret reference; it never discovers an ambient endpoint or credential. Public gateway URLs and ingress routes are separate concerns. This bounded realization is included in both generally available JavaScript targets.

package/as/README.md

@@ -0,0 +1,10 @@
+# @pulse-compute/grip PulseWasm sidecar
+
+This directory contains the package-owned AssemblyScript sidecar symbols used by
+supported package-root Native lowering. The older
+`@pulse-compute/grip/pulsewasm` surface remains compatibility-only.
+
+The GRIP package owns its manifest, compiler builder, and sidecar declaration.
+Canonical TypeScript lowering now emits provider-neutral GRIP effects and the
+Fastly provider realizes them. These AssemblyScript symbols remain the focused
+compiled-sidecar boundary rather than a userland stream API.

package/as/index.as.ts

@@ -0,0 +1,28 @@
+// Package-owned AssemblyScript sidecar declaration for @pulse-compute/grip.
+//
+// These exports intentionally expose only the static ABI symbols declared by
+// pulsewasm.manifest.cjs for this first-party lowerable package. Provider and
+// runtime GRIP behavior remains outside this sidecar declaration.
+
+export function pulse_grip_hold(modePtr: usize, modeLen: i32, optionsRef: i32): i32 {
+  void modePtr;
+  void modeLen;
+  void optionsRef;
+  return 0;
+}
+
+export function pulse_grip_channel(channelPtr: usize, channelLen: i32, optionsRef: i32): i32 {
+  void channelPtr;
+  void channelLen;
+  void optionsRef;
+  return 0;
+}
+
+export function pulse_grip_publish(channelPtr: usize, channelLen: i32, messagePtr: usize, messageLen: i32, optionsRef: i32): i32 {
+  void channelPtr;
+  void channelLen;
+  void messagePtr;
+  void messageLen;
+  void optionsRef;
+  return 0;
+}

package/conformance/native.json

@@ -0,0 +1,22 @@
+{
+  "version": "pulse.package-conformance-fixture.v1",
+  "contractId": "pulse.grip",
+  "target": "native",
+  "status": "target-overlap",
+  "canonicalRoot": "@pulse-compute/grip",
+  "compatibilityRoot": "@pulse-compute/grip/pulsewasm",
+  "cases": [
+    "grip.isWebSocket",
+    "grip.subscribe",
+    "grip.handoff",
+    "grip.broadcast"
+  ],
+  "nativeRestrictions": {
+    "options": "static",
+    "messages": "static",
+    "dynamicInputs": "fail-at-exact-expression",
+    "trialLowering": false,
+    "automaticFallback": false
+  },
+  "evidence": "wasm/test/contracts/assert-grip-cross-target-conformance.cjs"
+}

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import type { PulseContext, PulseParallelEffect } from '@pulse-compute/runtime';
+export type GripRequestLike = Request | {
+    readonly method?: string;
+    readonly headers?: Headers | Readonly<Record<string, string | undefined>> | readonly (readonly [string, string])[];
+    header?(name: string): string | undefined;
+};
+export type GripSubscribeMode = 'stream' | 'response';
+export interface GripSubscriptionOptions {
+    readonly channel?: string;
+    readonly channels?: readonly string[];
+    readonly mode?: GripSubscribeMode;
+    readonly timeoutMs?: number;
+}
+export interface GripHandoffOptions extends GripSubscriptionOptions {
+    readonly status?: number;
+    readonly headers?: HeadersInit;
+    readonly body?: BodyInit | null;
+}
+export interface GripBroadcastMessage {
+    readonly channel: string;
+    readonly data: unknown;
+    readonly event?: string;
+    readonly id?: string;
+}
+export interface GripBroadcastAck {
+    readonly accepted: boolean;
+    readonly status?: number;
+    readonly messageId?: string;
+}
+/** Pure classification. Pulse never creates or owns a WebSocket object. */
+export declare function isWebSocket(request: GripRequestLike): boolean;
+/** Pure response decoration. The external GRIP gateway owns the held connection. */
+export declare function subscribe(response: Response, options: GripSubscriptionOptions): Response;
+/** Pure HTTP handoff framing for websocket-over-HTTP requests. */
+export declare function handoff(options: GripHandoffOptions): Response;
+/** The only request-bound I/O operation in the bounded GRIP API. */
+export declare function broadcast(ctx: PulseContext, message: GripBroadcastMessage): PulseParallelEffect<GripBroadcastAck>;
+export declare const grip: Readonly<{
+    isWebSocket: typeof isWebSocket;
+    subscribe: typeof subscribe;
+    handoff: typeof handoff;
+    broadcast: typeof broadcast;
+}>;
+export default grip;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGhF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IACnH,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AA2DD,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAQ7D;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,GAAG,QAAQ,CAQxF;AAED,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,QAAQ,CAQ7D;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CACvB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CAAC,gBAAgB,CAAC,CA6BvC;AAED,eAAO,MAAM,IAAI;;;;;EAKf,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/index.js

@@ -0,0 +1,135 @@
+import packageRuntime from '@pulse-compute/runtime/package';
+const gripRuntime = packageRuntime.createPackageRuntime({
+    package: '@pulse-compute/grip',
+    contractId: 'pulse.grip',
+    providerKind: 'grip',
+    operations: {
+        broadcast: {
+            kind: 'grip.broadcast',
+            capability: 'grip.broadcast',
+            result: 'ack',
+        },
+    },
+});
+function headerValue(request, name) {
+    if ('header' in request && typeof request.header === 'function')
+        return request.header(name);
+    const headers = request.headers;
+    if (!headers)
+        return undefined;
+    if (headers instanceof Headers)
+        return headers.get(name) ?? undefined;
+    if (Array.isArray(headers)) {
+        const values = headers
+            .filter(([key]) => String(key).toLowerCase() === name.toLowerCase())
+            .map(([, value]) => String(value));
+        return values.length > 0 ? values.join(', ') : undefined;
+    }
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === name.toLowerCase() && value !== undefined)
+            return String(value);
+    }
+    return undefined;
+}
+function normalizeChannels(options) {
+    const input = options.channels ?? (options.channel === undefined ? [] : [options.channel]);
+    if (!Array.isArray(input) || input.length === 0)
+        throw new TypeError('GRIP subscription requires at least one channel.');
+    const channels = input.map((value) => {
+        const channelName = String(value).trim();
+        if (!channelName)
+            throw new TypeError('GRIP channel names must be non-empty strings.');
+        if (/[,\r\n]/.test(channelName))
+            throw new TypeError('GRIP channel names may not contain commas or line breaks.');
+        return channelName;
+    });
+    return Object.freeze(channels);
+}
+function applySubscriptionHeaders(headers, options) {
+    const mode = options.mode ?? 'stream';
+    if (mode !== 'stream' && mode !== 'response')
+        throw new TypeError('GRIP subscription mode must be stream or response.');
+    headers.set('Grip-Hold', mode);
+    headers.delete('Grip-Channel');
+    headers.delete('Grip-Timeout');
+    for (const channelName of normalizeChannels(options))
+        headers.append('Grip-Channel', channelName);
+    if (options.timeoutMs !== undefined) {
+        const timeoutMs = Number(options.timeoutMs);
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0)
+            throw new TypeError('GRIP timeoutMs must be a non-negative safe integer.');
+        headers.set('Grip-Timeout', String(timeoutMs));
+    }
+    return headers;
+}
+/** Pure classification. Pulse never creates or owns a WebSocket object. */
+export function isWebSocket(request) {
+    const contentType = (headerValue(request, 'content-type') || '').toLowerCase();
+    const accept = (headerValue(request, 'accept') || '').toLowerCase();
+    const upgrade = (headerValue(request, 'upgrade') || '').toLowerCase();
+    const connection = (headerValue(request, 'connection') || '').toLowerCase();
+    return contentType.includes('application/websocket-events')
+        || accept.includes('application/websocket-events')
+        || (upgrade === 'websocket' && connection.split(',').some((value) => value.trim() === 'upgrade'));
+}
+/** Pure response decoration. The external GRIP gateway owns the held connection. */
+export function subscribe(response, options) {
+    if (!(response instanceof Response))
+        throw new TypeError('grip.subscribe requires a Web Response.');
+    const headers = applySubscriptionHeaders(new Headers(response.headers), options);
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+/** Pure HTTP handoff framing for websocket-over-HTTP requests. */
+export function handoff(options) {
+    const headers = new Headers(options.headers);
+    if (!headers.has('content-type'))
+        headers.set('Content-Type', 'application/websocket-events');
+    applySubscriptionHeaders(headers, options);
+    return new Response(options.body ?? null, {
+        status: options.status ?? 200,
+        headers,
+    });
+}
+/** The only request-bound I/O operation in the bounded GRIP API. */
+export function broadcast(ctx, message) {
+    if (!message || typeof message !== 'object' || Array.isArray(message)) {
+        throw new TypeError('grip.broadcast requires a structured message.');
+    }
+    const channelName = String(message.channel || '').trim();
+    if (!channelName || /[,\r\n]/.test(channelName)) {
+        throw new TypeError('grip.broadcast channel must be non-empty and may not contain commas or line breaks.');
+    }
+    if (!Object.prototype.hasOwnProperty.call(message, 'data') || message.data === undefined) {
+        throw new TypeError('grip.broadcast requires a JSON-compatible data value.');
+    }
+    return gripRuntime.effect(ctx, 'broadcast', {
+        channel: channelName,
+        data: message.data,
+        ...(message.event === undefined ? {} : { event: String(message.event) }),
+        ...(message.id === undefined ? {} : { id: String(message.id) }),
+    }, (value) => {
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            const record = value;
+            const status = record.status === undefined ? undefined : Number(record.status);
+            const messageId = record.messageId === undefined ? undefined : String(record.messageId);
+            return Object.freeze({
+                accepted: record.accepted !== false,
+                ...(Number.isSafeInteger(status) ? { status } : {}),
+                ...(messageId === undefined ? {} : { messageId }),
+            });
+        }
+        return Object.freeze({ accepted: value !== false });
+    });
+}
+export const grip = Object.freeze({
+    isWebSocket,
+    subscribe,
+    handoff,
+    broadcast,
+});
+export default grip;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pulsewasm.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PulseWasm lowerable facade for @pulse-compute/grip.
+ *
+ * This module is the public package-owned lowering facade. PulseWasm compilers may recognize these
+ * symbols statically and lower them to the internal `pulse.grip` library
+ * contract. They are not a JavaScript GRIP runtime.
+ */
+export type GripHoldMode = 'stream' | 'response';
+export type GripHoldOptions = {
+    readonly channels?: readonly string[] | undefined;
+    readonly timeoutMs?: number | undefined;
+    readonly headers?: HeadersInit | undefined;
+};
+export type GripChannelOptions = {
+    readonly prefix?: string | undefined;
+    readonly fanout?: boolean | undefined;
+};
+export type GripPublishOptions = {
+    readonly event?: string | undefined;
+    readonly id?: string | undefined;
+};
+import type { PulseEffect, PulseResult } from '@pulse-compute/runtime';
+export type GripHold = PulseEffect<PulseResult> & {
+    readonly kind: 'pulse.grip.hold';
+    readonly mode: GripHoldMode;
+    readonly options?: GripHoldOptions | undefined;
+};
+export type GripChannel = PulseEffect<void> & {
+    readonly kind: 'pulse.grip.channel';
+    readonly channel: string;
+    readonly options?: GripChannelOptions | undefined;
+};
+export type GripPublish = PulseEffect<PulseResult> & {
+    readonly kind: 'pulse.grip.publish';
+    readonly channel: string;
+    readonly message: string;
+    readonly options?: GripPublishOptions | undefined;
+};
+export declare class PulseWasmGripLoweringError extends Error {
+    constructor(symbol: string);
+}
+export declare function hold(mode: GripHoldMode, options?: GripHoldOptions): GripHold;
+export declare function channel(channelName: string, options?: GripChannelOptions): GripChannel;
+export declare function publish(channelName: string, message: string, options?: GripPublishOptions): GripPublish;
+export declare const grip: Readonly<{
+    hold: typeof hold;
+    channel: typeof channel;
+    publish: typeof publish;
+}>;
+export default grip;
+//# sourceMappingURL=pulsewasm.d.ts.map

package/dist/pulsewasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulsewasm.d.ts","sourceRoot":"","sources":["../src/pulsewasm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG;IAChD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG;IAC5C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG;IACnD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACnD,CAAC;AAEF,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,MAAM,EAAE,MAAM;CAM3B;AAMD,wBAAgB,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAI5E;AAED,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAItF;AAED,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAKvG;AAED,eAAO,MAAM,IAAI;;;;EAIf,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/pulsewasm.js

@@ -0,0 +1,39 @@
+/**
+ * PulseWasm lowerable facade for @pulse-compute/grip.
+ *
+ * This module is the public package-owned lowering facade. PulseWasm compilers may recognize these
+ * symbols statically and lower them to the internal `pulse.grip` library
+ * contract. They are not a JavaScript GRIP runtime.
+ */
+export class PulseWasmGripLoweringError extends Error {
+    constructor(symbol) {
+        super(`${symbol} is a PulseWasm lowerable facade and cannot run directly in JavaScript. Select a supported compiler/provider target; no direct JavaScript GRIP runtime is exported by this package.`);
+        this.name = 'PulseWasmGripLoweringError';
+    }
+}
+function lowerableOnly(symbol) {
+    throw new PulseWasmGripLoweringError(symbol);
+}
+export function hold(mode, options) {
+    void mode;
+    void options;
+    return lowerableOnly('grip.hold');
+}
+export function channel(channelName, options) {
+    void channelName;
+    void options;
+    return lowerableOnly('grip.channel');
+}
+export function publish(channelName, message, options) {
+    void channelName;
+    void message;
+    void options;
+    return lowerableOnly('grip.publish');
+}
+export const grip = Object.freeze({
+    hold,
+    channel,
+    publish,
+});
+export default grip;
+//# sourceMappingURL=pulsewasm.js.map

package/dist/pulsewasm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulsewasm.js","sourceRoot":"","sources":["../src/pulsewasm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyCH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,MAAc;QACxB,KAAK,CACH,GAAG,MAAM,qLAAqL,CAC/L,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,aAAa,CAAC,MAAqD;IAC1E,MAAM,IAAI,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAkB,EAAE,OAAyB;IAChE,KAAK,IAAI,CAAC;IACV,KAAK,OAAO,CAAC;IACb,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,WAAmB,EAAE,OAA4B;IACvE,KAAK,WAAW,CAAC;IACjB,KAAK,OAAO,CAAC;IACb,OAAO,aAAa,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,WAAmB,EAAE,OAAe,EAAE,OAA4B;IACxF,KAAK,WAAW,CAAC;IACjB,KAAK,OAAO,CAAC;IACb,KAAK,OAAO,CAAC;IACb,OAAO,aAAa,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAChC,IAAI;IACJ,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/grip.framing-contract.json

@@ -0,0 +1,76 @@
+{
+  "version": "pulse.grip-framing-contract.v1",
+  "contractId": "pulse.grip",
+  "ownership": {
+    "connectionOwner": "external-grip-gateway",
+    "pulseState": "request-only",
+    "providerEffect": "grip.broadcast",
+    "automaticFallback": false
+  },
+  "classification": {
+    "mediaType": "application/websocket-events",
+    "upgradeToken": "websocket",
+    "connectionToken": "upgrade",
+    "headerNamesCaseInsensitive": true,
+    "connectionTokensCaseInsensitive": true
+  },
+  "subscription": {
+    "modes": ["stream", "response"],
+    "channels": {
+      "minimum": 1,
+      "trim": true,
+      "ordered": true,
+      "repeatedHeader": "Grip-Channel",
+      "forbidden": ["empty", "comma", "carriage-return", "line-feed"]
+    },
+    "timeoutMs": {
+      "requiredType": "non-negative-safe-integer",
+      "header": "Grip-Timeout"
+    },
+    "holdHeader": "Grip-Hold",
+    "preserve": ["status", "statusText", "body", "headers"]
+  },
+  "handoff": {
+    "defaultStatus": 200,
+    "defaultContentType": "application/websocket-events",
+    "bodyOwnership": "caller-owned-exact-text"
+  },
+  "broadcast": {
+    "message": {
+      "required": ["channel", "data"],
+      "optional": ["event", "id"]
+    },
+    "acknowledgement": {
+      "required": ["accepted"],
+      "optional": ["status", "messageId"]
+    },
+    "requestOwned": true,
+    "cancellable": true,
+    "boundedRequest": true,
+    "boundedResponse": true,
+    "authentication": "named-secret-reference",
+    "ambientEndpoint": false,
+    "ambientCredentials": false
+  },
+  "stableFailureCodes": [
+    "PULSE_GRIP_BROADCAST_ABORTED",
+    "PULSE_GRIP_BROADCAST_AUTH_SCHEME_UNSUPPORTED",
+    "PULSE_GRIP_BROADCAST_CAPABILITY_REQUIRED",
+    "PULSE_GRIP_BROADCAST_CHANNEL_INVALID",
+    "PULSE_GRIP_BROADCAST_ENDPOINT_INVALID",
+    "PULSE_GRIP_BROADCAST_MESSAGE_INVALID",
+    "PULSE_GRIP_BROADCAST_NETWORK",
+    "PULSE_GRIP_BROADCAST_REJECTED",
+    "PULSE_GRIP_BROADCAST_REQUEST_TOO_LARGE",
+    "PULSE_GRIP_BROADCAST_RESPONSE_INVALID",
+    "PULSE_GRIP_BROADCAST_RESPONSE_TOO_LARGE",
+    "PULSE_GRIP_BROADCAST_SECRET_REFERENCE_REQUIRED",
+    "PULSE_GRIP_BROADCAST_SECRET_REQUIRED"
+  ],
+  "redaction": {
+    "safeFields": ["operation", "status", "secretRef", "maxRequestBytes", "maxResponseBytes"],
+    "secretValues": "never-recorded",
+    "authorizationHeaders": "never-recorded",
+    "providerBodies": "never-recorded-on-error"
+  }
+}

package/package.json

@@ -1,15 +1,70 @@
 {
   "name": "@pulse-compute/grip",
-  "version": "0.0.0",
-  "description": "Inert namespace bootstrap for Pulse.",
+  "version": "1.0.0-beta.1",
   "license": "Apache-2.0",
+  "engines": {
+    "node": "^22.14.0 || ^24.0.0"
+  },
+  "description": "Package-owned GRIP/Fanout lowering facade and compiler integration for Pulse.",
+  "type": "module",
+  "exports": {
+    "./pulsewasm": {
+      "types": "./dist/pulsewasm.d.ts",
+      "import": "./dist/pulsewasm.js"
+    },
+    "./pulsewasm/manifest": {
+      "require": "./pulsewasm.manifest.cjs",
+      "default": "./pulsewasm.manifest.cjs"
+    },
+    "./pulsewasm/compiler": {
+      "require": "./pulsewasm.compiler.cjs",
+      "default": "./pulsewasm.compiler.cjs"
+    },
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
   "files": [
+    "dist",
     "README.md",
+    "pulse.package.json",
+    "grip.framing-contract.json",
+    "pulsewasm.manifest.cjs",
+    "pulsewasm.compiler.cjs",
+    "as",
+    "conformance",
     "LICENSE",
     "NOTICE"
   ],
+  "pulsewasm": {
+    "manifest": "./pulsewasm.manifest.cjs"
+  },
   "publishConfig": {
-    "access": "public",
-    "tag": "bootstrap"
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pulse-compute/pulse.git",
+    "directory": "packages/grip"
+  },
+  "homepage": "https://pulsecompute.io/v1.0.0-beta.1/packages/grip/",
+  "bugs": {
+    "url": "https://github.com/pulse-compute/pulse/issues"
+  },
+  "dependencies": {
+    "@pulse-compute/runtime": "1.0.0-beta.1",
+    "@pulse-compute/wasm-contracts": "1.0.0-beta.1"
+  },
+  "pulse": {
+    "contract": "./pulse.package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run --root ../.. --config ../../vitest.config.ts packages/grip/test/**/*.test.ts"
   }
-}
+}

package/pulse.package.json

@@ -0,0 +1,73 @@
+{
+  "version": "pulse.package-contract.v1",
+  "kind": "pulse.package-contract",
+  "contractId": "pulse.grip",
+  "npmPackage": "@pulse-compute/grip",
+  "description": "Stateless GRIP/Fanout HTTP framing and request-bound broadcast package.",
+  "authoring": {
+    "namespace": "grip",
+    "import": "@pulse-compute/grip",
+    "symbols": [
+      "broadcast",
+      "handoff",
+      "isWebSocket",
+      "subscribe"
+    ]
+  },
+  "ownership": {
+    "profileFragment": "grip",
+    "helperImports": [],
+    "reExportImports": []
+  },
+  "composition": {
+    "status": "reserved",
+    "helperSymbol": "grip",
+    "profileToken": "opaque-direct-use",
+    "reasonCode": "PULSE_PACKAGE_COMPOSITION_HELPER_NOT_REALIZED"
+  },
+  "targets": {
+    "native": {
+      "status": "provider-dependent",
+      "realization": "canonical-package-lowering",
+      "lowerableSubpath": "@pulse-compute/grip",
+      "providerRequirements": [
+        "broadcaster",
+        "channel",
+        "clock",
+        "headers"
+      ],
+      "reasonCode": "PULSE_GRIP_PROVIDER_CONFIGURATION_REQUIRED"
+    },
+    "javascript": {
+      "status": "supported",
+      "realization": "javascript-package-runtime",
+      "entry": "./dist/index.js",
+      "providerRequirements": [
+        "grip.broadcast"
+      ]
+    }
+  },
+  "lowering": {
+    "manifest": "./pulsewasm.manifest.cjs",
+    "trust": "first-party",
+    "canonicalOperationVersion": "pulse.canonical-package-operation.v1",
+    "bundleVersion": "pulse.package-lowering-bundle.v1",
+    "providerRequirementVersion": "pulse.provider-requirement-record.v1"
+  },
+  "conformance": {
+    "status": "target-overlap",
+    "fixtureRoots": [
+      "./conformance"
+    ],
+    "semanticCases": [
+      "grip.broadcast",
+      "grip.handoff",
+      "grip.isWebSocket",
+      "grip.subscribe"
+    ]
+  },
+  "docs": {
+    "readme": "./README.md",
+    "contract": "./pulse.package.json"
+  }
+}