@kottera/tera-web 0.0.0-stage → 0.1.0-rc.2

package/dist/generated/workorder.js

@@ -0,0 +1,74 @@
+// Code generated by cmd/internal/genwebtypes from sdk/workorder/schema/v1/; DO NOT EDIT.
+// Regenerate with `make web-types` (ADR-162 D4 item 1).
+/**
+ * Every type this module declares, mapped to the repository path of the schema
+ * it was generated from.
+ */
+export const WORK_ORDER_SCHEMAS = {
+    WorkOrderAcknowledgeParams: "sdk/workorder/schema/v1/acknowledge.params.json",
+    WorkOrderAcknowledgeResult: "sdk/workorder/schema/v1/acknowledge.result.json",
+    WorkOrderAnswerParams: "sdk/workorder/schema/v1/answer.params.json",
+    WorkOrderAnswerResult: "sdk/workorder/schema/v1/answer.result.json",
+    WorkOrderCancelParams: "sdk/workorder/schema/v1/cancel.params.json",
+    WorkOrderCancelResult: "sdk/workorder/schema/v1/cancel.result.json",
+    WorkOrderCohortSetParams: "sdk/workorder/schema/v1/cohort_set.params.json",
+    WorkOrderCohortSetResult: "sdk/workorder/schema/v1/cohort_set.result.json",
+    WorkOrderCompleteParams: "sdk/workorder/schema/v1/complete.params.json",
+    WorkOrderCompleteResult: "sdk/workorder/schema/v1/complete.result.json",
+    WorkOrderCreateParams: "sdk/workorder/schema/v1/create.params.json",
+    WorkOrderCreateResult: "sdk/workorder/schema/v1/create.result.json",
+    WorkOrderCreateChildParams: "sdk/workorder/schema/v1/create_child.params.json",
+    WorkOrderCreateChildResult: "sdk/workorder/schema/v1/create_child.result.json",
+    WorkOrderEditParams: "sdk/workorder/schema/v1/edit.params.json",
+    WorkOrderEditResult: "sdk/workorder/schema/v1/edit.result.json",
+    WorkOrderEventsParams: "sdk/workorder/schema/v1/events.params.json",
+    WorkOrderEventsResult: "sdk/workorder/schema/v1/events.result.json",
+    WorkOrderFailParams: "sdk/workorder/schema/v1/fail.params.json",
+    WorkOrderFailResult: "sdk/workorder/schema/v1/fail.result.json",
+    WorkOrderForceFailParams: "sdk/workorder/schema/v1/force_fail.params.json",
+    WorkOrderForceFailResult: "sdk/workorder/schema/v1/force_fail.result.json",
+    WorkOrderGetParams: "sdk/workorder/schema/v1/get.params.json",
+    WorkOrderGetResult: "sdk/workorder/schema/v1/get.result.json",
+    WorkOrderGuideParams: "sdk/workorder/schema/v1/guide.params.json",
+    WorkOrderGuideResult: "sdk/workorder/schema/v1/guide.result.json",
+    WorkOrderHistoryParams: "sdk/workorder/schema/v1/history.params.json",
+    WorkOrderHistoryResult: "sdk/workorder/schema/v1/history.result.json",
+    WorkOrderHistoryUnblockParams: "sdk/workorder/schema/v1/history_unblock.params.json",
+    WorkOrderHistoryUnblockResult: "sdk/workorder/schema/v1/history_unblock.result.json",
+    WorkOrderHumanAskParams: "sdk/workorder/schema/v1/human.ask.params.json",
+    WorkOrderHumanAskResult: "sdk/workorder/schema/v1/human.ask.result.json",
+    WorkOrderInterruptParams: "sdk/workorder/schema/v1/interrupt.params.json",
+    WorkOrderInterruptResult: "sdk/workorder/schema/v1/interrupt.result.json",
+    WorkOrderListParams: "sdk/workorder/schema/v1/list.params.json",
+    WorkOrderListResult: "sdk/workorder/schema/v1/list.result.json",
+    WorkOrderListOffTeraParams: "sdk/workorder/schema/v1/list_off_tera.params.json",
+    WorkOrderListOffTeraResult: "sdk/workorder/schema/v1/list_off_tera.result.json",
+    WorkOrderPauseParams: "sdk/workorder/schema/v1/pause.params.json",
+    WorkOrderPauseResult: "sdk/workorder/schema/v1/pause.result.json",
+    WorkOrderPrioritizeParams: "sdk/workorder/schema/v1/prioritize.params.json",
+    WorkOrderPrioritizeResult: "sdk/workorder/schema/v1/prioritize.result.json",
+    WorkOrderProgressParams: "sdk/workorder/schema/v1/progress.params.json",
+    WorkOrderProgressResult: "sdk/workorder/schema/v1/progress.result.json",
+    WorkOrderRecallParams: "sdk/workorder/schema/v1/recall.params.json",
+    WorkOrderRecallResult: "sdk/workorder/schema/v1/recall.result.json",
+    WorkOrderRefileParams: "sdk/workorder/schema/v1/refile.params.json",
+    WorkOrderRefileResult: "sdk/workorder/schema/v1/refile.result.json",
+    WorkOrderRelateParams: "sdk/workorder/schema/v1/relate.params.json",
+    WorkOrderRelateResult: "sdk/workorder/schema/v1/relate.result.json",
+    WorkOrderReleaseParams: "sdk/workorder/schema/v1/release.params.json",
+    WorkOrderReleaseResult: "sdk/workorder/schema/v1/release.result.json",
+    WorkOrderRepinParams: "sdk/workorder/schema/v1/repin.params.json",
+    WorkOrderRepinResult: "sdk/workorder/schema/v1/repin.result.json",
+    WorkOrderRepostParams: "sdk/workorder/schema/v1/repost.params.json",
+    WorkOrderRepostResult: "sdk/workorder/schema/v1/repost.result.json",
+    WorkOrderRetryParams: "sdk/workorder/schema/v1/retry.params.json",
+    WorkOrderRetryResult: "sdk/workorder/schema/v1/retry.result.json",
+    WorkOrderSubmitResultParams: "sdk/workorder/schema/v1/submit_result.params.json",
+    WorkOrderSubmitResultResult: "sdk/workorder/schema/v1/submit_result.result.json",
+    WorkOrderTakeParams: "sdk/workorder/schema/v1/take.params.json",
+    WorkOrderTakeResult: "sdk/workorder/schema/v1/take.result.json",
+    WorkOrderTransitionParams: "sdk/workorder/schema/v1/transition.params.json",
+    WorkOrderTransitionResult: "sdk/workorder/schema/v1/transition.result.json",
+    WorkOrderTreeParams: "sdk/workorder/schema/v1/tree.params.json",
+    WorkOrderTreeResult: "sdk/workorder/schema/v1/tree.result.json",
+};

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { ROUTE_PREFIX, routePath } from "./routes.ts";
+export { TeraClient, KitRequestError, UNRECOGNIZED_RESPONSE, type FeedOptions, type InvokeVerdict, type KitErrorBody, type TeraClientOptions, type UploadOptions, type UploadProgress, type UploadRequest, type VerbRefusal, } from "./client.ts";
+export { BASE_DELAY_MS, MAX_DELAY_MS, REPLAY_LIMIT, REPLAY_WINDOW_MS, HEARTBEAT_GRACE_MS, REAUTHENTICATE_EVENT, FeedConnection, browserSignals, defaultOrderKey, type Clock, type FeedConnectionOptions, type FeedConnectionPhase, type FeedConnectionState, type FeedFrame, type FeedLoss, type FeedSignal, type FeedSignals, } from "./feed/connection.ts";
+export { FeedOpenError, SSEParser, fetchOpener, isRefusal, type FeedOpener, type SSEEvent } from "./feed/sse.ts";
+export type * from "./generated/feed.ts";
+export type * from "./generated/kit.ts";
+export type * from "./generated/workorder.ts";
+export type * from "./generated/workorder-events.ts";
+export { FEED_SCHEMAS } from "./generated/feed.ts";
+export { KIT_ROUTE_PREFIX, KIT_ROUTE_TABLE, KIT_SCHEMAS, KIT_SIGNOUT_PATH } from "./generated/kit.ts";
+export { WORK_ORDER_SCHEMAS } from "./generated/workorder.ts";
+export { WORK_ORDER_EVENT_SCHEMAS } from "./generated/workorder-events.ts";

package/dist/index.js

@@ -0,0 +1,12 @@
+// @kottera/tera-web — the browser half of a UI over tera (ADR-162 D4).
+//
+// Framework-free, with no runtime dependencies: it carries no UI component,
+// because the framework is the author's.
+export { ROUTE_PREFIX, routePath } from "./routes.js";
+export { TeraClient, KitRequestError, UNRECOGNIZED_RESPONSE, } from "./client.js";
+export { BASE_DELAY_MS, MAX_DELAY_MS, REPLAY_LIMIT, REPLAY_WINDOW_MS, HEARTBEAT_GRACE_MS, REAUTHENTICATE_EVENT, FeedConnection, browserSignals, defaultOrderKey, } from "./feed/connection.js";
+export { FeedOpenError, SSEParser, fetchOpener, isRefusal } from "./feed/sse.js";
+export { FEED_SCHEMAS } from "./generated/feed.js";
+export { KIT_ROUTE_PREFIX, KIT_ROUTE_TABLE, KIT_SCHEMAS, KIT_SIGNOUT_PATH } from "./generated/kit.js";
+export { WORK_ORDER_SCHEMAS } from "./generated/workorder.js";
+export { WORK_ORDER_EVENT_SCHEMAS } from "./generated/workorder-events.js";

package/dist/routes.d.ts

@@ -0,0 +1,10 @@
+/** The prefix every kit route is served under. */
+export declare const ROUTE_PREFIX = "/tera/v1/";
+/**
+ * routePath builds a kit route's path from its segments, each encoded as one
+ * path segment: a capability or feed name holding `/` stays one segment rather
+ * than becoming two. An empty segment, `.` or `..` is refused: each would
+ * address a different route than the caller named, since a URL resolver
+ * collapses the dot segments and encoding does not change them.
+ */
+export declare function routePath(...segments: string[]): string;

package/dist/routes.js

@@ -0,0 +1,32 @@
+// The browser routes a plugin's webui kit serves, all under one reserved
+// prefix on the plugin's origin (ADR-162 D3). The prefix is not `/_tera/`,
+// which tera's reverse proxy keeps for its own paths and never forwards.
+//
+// The route table itself is declared once, in Go, under sdk/plugin/webui, and
+// generated into ./generated/kit.ts. What is here is how a path is built from
+// it.
+import { KIT_ROUTE_PREFIX } from "./generated/kit.js";
+/** The prefix every kit route is served under. */
+export const ROUTE_PREFIX = KIT_ROUTE_PREFIX;
+/**
+ * routePath builds a kit route's path from its segments, each encoded as one
+ * path segment: a capability or feed name holding `/` stays one segment rather
+ * than becoming two. An empty segment, `.` or `..` is refused: each would
+ * address a different route than the caller named, since a URL resolver
+ * collapses the dot segments and encoding does not change them.
+ */
+export function routePath(...segments) {
+    if (segments.length === 0) {
+        throw new TypeError("routePath: at least one segment is required");
+    }
+    const parts = segments.map((segment, i) => {
+        if (segment === "") {
+            throw new TypeError(`routePath: segment ${i} is empty`);
+        }
+        if (segment === "." || segment === "..") {
+            throw new TypeError(`routePath: segment ${i} is a dot segment (${segment})`);
+        }
+        return encodeURIComponent(segment);
+    });
+    return ROUTE_PREFIX + parts.join("/");
+}

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@kottera/tera-web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-rc.2",
+  "description": "The browser half of a UI over tera: a framework-free client for the /tera/v1/ routes a plugin's webui kit serves (ADR-162 D4).",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kottera/sdk.git",
+    "directory": "web"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "NOTICE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "node --test --test-reporter=tap \"src/**/*.test.ts\""
+  }
+}