@slotform/api 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +50 -2
  3. package/dist/client.d.ts +16 -0
  4. package/dist/client.d.ts.map +1 -0
  5. package/dist/client.js +98 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/error.d.ts +2 -0
  8. package/dist/error.d.ts.map +1 -0
  9. package/dist/error.js +2 -0
  10. package/dist/error.js.map +1 -0
  11. package/dist/index.d.ts +153 -0
  12. package/dist/index.d.ts.map +1 -0
  13. package/dist/index.js +640 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/lib/chosen.d.ts +12 -0
  16. package/dist/lib/chosen.d.ts.map +1 -0
  17. package/dist/lib/chosen.js +18 -0
  18. package/dist/lib/chosen.js.map +1 -0
  19. package/dist/lib/cursor.d.ts +68 -0
  20. package/dist/lib/cursor.d.ts.map +1 -0
  21. package/dist/lib/cursor.js +220 -0
  22. package/dist/lib/cursor.js.map +1 -0
  23. package/dist/lib/limits.d.ts +4 -0
  24. package/dist/lib/limits.d.ts.map +1 -0
  25. package/dist/lib/limits.js +10 -0
  26. package/dist/lib/limits.js.map +1 -0
  27. package/dist/lib/local-origin.d.ts +2 -0
  28. package/dist/lib/local-origin.d.ts.map +1 -0
  29. package/dist/lib/local-origin.js +17 -0
  30. package/dist/lib/local-origin.js.map +1 -0
  31. package/dist/lib/slugify.d.ts +4 -0
  32. package/dist/lib/slugify.d.ts.map +1 -0
  33. package/dist/lib/slugify.js +26 -0
  34. package/dist/lib/slugify.js.map +1 -0
  35. package/dist/lib/window.d.ts +52 -0
  36. package/dist/lib/window.d.ts.map +1 -0
  37. package/dist/lib/window.js +70 -0
  38. package/dist/lib/window.js.map +1 -0
  39. package/dist/mcp-path.d.ts +2 -0
  40. package/dist/mcp-path.d.ts.map +1 -0
  41. package/dist/mcp-path.js +3 -0
  42. package/dist/mcp-path.js.map +1 -0
  43. package/dist/mcp.d.ts +15 -0
  44. package/dist/mcp.d.ts.map +1 -0
  45. package/dist/mcp.js +5 -0
  46. package/dist/mcp.js.map +1 -0
  47. package/dist/node/barrel.d.ts +3 -0
  48. package/dist/node/barrel.d.ts.map +1 -0
  49. package/dist/node/barrel.js +70 -0
  50. package/dist/node/barrel.js.map +1 -0
  51. package/dist/node/codegen.d.ts +10 -0
  52. package/dist/node/codegen.d.ts.map +1 -0
  53. package/dist/node/codegen.js +132 -0
  54. package/dist/node/codegen.js.map +1 -0
  55. package/dist/node/procedure-codegen.d.ts +14 -0
  56. package/dist/node/procedure-codegen.d.ts.map +1 -0
  57. package/dist/node/procedure-codegen.js +95 -0
  58. package/dist/node/procedure-codegen.js.map +1 -0
  59. package/dist/node/schema-child.d.ts +2 -0
  60. package/dist/node/schema-child.d.ts.map +1 -0
  61. package/dist/node/schema-child.js +31 -0
  62. package/dist/node/schema-child.js.map +1 -0
  63. package/dist/node/schema-source.d.ts +3 -0
  64. package/dist/node/schema-source.d.ts.map +1 -0
  65. package/dist/node/schema-source.js +33 -0
  66. package/dist/node/schema-source.js.map +1 -0
  67. package/dist/node/server-client.d.ts +19 -0
  68. package/dist/node/server-client.d.ts.map +1 -0
  69. package/dist/node/server-client.js +45 -0
  70. package/dist/node/server-client.js.map +1 -0
  71. package/dist/node/types.d.ts +42 -0
  72. package/dist/node/types.d.ts.map +1 -0
  73. package/dist/node/types.js +13 -0
  74. package/dist/node/types.js.map +1 -0
  75. package/dist/not-found.d.ts +2 -0
  76. package/dist/not-found.d.ts.map +1 -0
  77. package/dist/not-found.js +6 -0
  78. package/dist/not-found.js.map +1 -0
  79. package/dist/procedure.d.ts +188 -0
  80. package/dist/procedure.d.ts.map +1 -0
  81. package/dist/procedure.js +392 -0
  82. package/dist/procedure.js.map +1 -0
  83. package/dist/query-invalidation.d.ts +20 -0
  84. package/dist/query-invalidation.d.ts.map +1 -0
  85. package/dist/query-invalidation.js +66 -0
  86. package/dist/query-invalidation.js.map +1 -0
  87. package/dist/schema.d.ts +32 -0
  88. package/dist/schema.d.ts.map +1 -0
  89. package/dist/schema.js +103 -0
  90. package/dist/schema.js.map +1 -0
  91. package/dist/types.d.ts +30 -0
  92. package/dist/types.d.ts.map +1 -0
  93. package/dist/types.js +2 -0
  94. package/dist/types.js.map +1 -0
  95. package/dist/wire.d.ts +11 -0
  96. package/dist/wire.d.ts.map +1 -0
  97. package/dist/wire.js +26 -0
  98. package/dist/wire.js.map +1 -0
  99. package/dist/worker/guards.d.ts +6 -0
  100. package/dist/worker/guards.d.ts.map +1 -0
  101. package/dist/worker/guards.js +29 -0
  102. package/dist/worker/guards.js.map +1 -0
  103. package/dist/worker/index.d.ts +57 -0
  104. package/dist/worker/index.d.ts.map +1 -0
  105. package/dist/worker/index.js +418 -0
  106. package/dist/worker/index.js.map +1 -0
  107. package/dist/worker/mcp.d.ts +28 -0
  108. package/dist/worker/mcp.d.ts.map +1 -0
  109. package/dist/worker/mcp.js +361 -0
  110. package/dist/worker/mcp.js.map +1 -0
  111. package/dist/worker/request-log.d.ts +10 -0
  112. package/dist/worker/request-log.d.ts.map +1 -0
  113. package/dist/worker/request-log.js +37 -0
  114. package/dist/worker/request-log.js.map +1 -0
  115. package/guide/add-a-procedure.md +42 -0
  116. package/guide/background.md +86 -0
  117. package/guide/client.md +93 -0
  118. package/guide/config.md +85 -0
  119. package/guide/mcp.md +68 -0
  120. package/guide/middleware.md +79 -0
  121. package/guide/procedures.md +95 -0
  122. package/guide/utilities.md +135 -0
  123. package/package.json +120 -3
  124. package/src/client.ts +129 -0
  125. package/src/error.ts +1 -0
  126. package/src/index.ts +787 -0
  127. package/src/lib/chosen.ts +31 -0
  128. package/src/lib/cursor.ts +354 -0
  129. package/src/lib/limits.ts +10 -0
  130. package/src/lib/local-origin.ts +18 -0
  131. package/src/lib/slugify.ts +29 -0
  132. package/src/lib/window.ts +155 -0
  133. package/src/mcp-path.ts +2 -0
  134. package/src/mcp.ts +30 -0
  135. package/src/node/barrel.ts +77 -0
  136. package/src/node/codegen.ts +173 -0
  137. package/src/node/procedure-codegen.ts +131 -0
  138. package/src/node/schema-child.ts +31 -0
  139. package/src/node/schema-source.ts +45 -0
  140. package/src/node/server-client.ts +67 -0
  141. package/src/node/types.ts +64 -0
  142. package/src/not-found.ts +6 -0
  143. package/src/procedure.ts +935 -0
  144. package/src/query-invalidation.ts +106 -0
  145. package/src/schema.ts +133 -0
  146. package/src/types.ts +72 -0
  147. package/src/wire.ts +34 -0
  148. package/src/worker/guards.ts +37 -0
  149. package/src/worker/index.ts +681 -0
  150. package/src/worker/mcp.ts +470 -0
  151. package/src/worker/request-log.ts +50 -0
@@ -0,0 +1,66 @@
1
+ import { SLOTFORM_READS_HEADER, SLOTFORM_WRITES_HEADER } from "./wire.js";
2
+ // Declared reads of a query outside the API: docs/architecture/plugins/api.md, "Cache invalidation".
3
+ function declaredReads(meta) {
4
+ const reads = meta?.reads;
5
+ return Array.isArray(reads) &&
6
+ reads.every((entity) => typeof entity === "string")
7
+ ? reads
8
+ : undefined;
9
+ }
10
+ function splitHeaderValue(value) {
11
+ return value
12
+ .split(",")
13
+ .map((entity) => entity.trim())
14
+ .filter((entity) => entity.length > 0);
15
+ }
16
+ // The "todos/list" pathKey sits at index 0 of the `[path, options]` tuple
17
+ // `@orpc/tanstack-query` produces for both query and mutation keys.
18
+ function pathKeyFromOperationKey(key) {
19
+ if (!key)
20
+ return undefined;
21
+ const path = key[0];
22
+ if (!Array.isArray(path) || !path.every((seg) => typeof seg === "string")) {
23
+ return undefined;
24
+ }
25
+ return path.join("/");
26
+ }
27
+ // The registry the client and the query plugin's query client share: docs/architecture/plugins/api.md, "Client". It assumes one client and one user per isolate.
28
+ const entries = new Map();
29
+ /** Parses `x-slotform-reads` / `x-slotform-writes` off `headers` for `pathKey`. An absent header leaves that side untouched. */
30
+ export function captureEntityHeaders(pathKey, headers) {
31
+ const reads = headers.get(SLOTFORM_READS_HEADER);
32
+ const writes = headers.get(SLOTFORM_WRITES_HEADER);
33
+ if (reads === null && writes === null)
34
+ return;
35
+ const entry = entries.get(pathKey) ?? { reads: [], writes: [] };
36
+ if (reads !== null)
37
+ entry.reads = splitHeaderValue(reads);
38
+ if (writes !== null)
39
+ entry.writes = splitHeaderValue(writes);
40
+ entries.set(pathKey, entry);
41
+ }
42
+ /** Invalidates every cached query whose recorded or declared (`meta.reads`) reads intersect `writes`. */
43
+ export function invalidateForWrites(queryClient, writes) {
44
+ if (writes.length === 0)
45
+ return;
46
+ const writeSet = new Set(writes);
47
+ queryClient.invalidateQueries({
48
+ predicate: (query) => {
49
+ const pathKey = pathKeyFromOperationKey(query.queryKey);
50
+ const reads = declaredReads(query.meta) ??
51
+ (pathKey ? entries.get(pathKey)?.reads : undefined);
52
+ return reads?.some((entity) => writeSet.has(entity)) ?? false;
53
+ },
54
+ });
55
+ }
56
+ /** Looks up the writes recorded for `mutationKey`'s pathKey and invalidates for them. No-op when nothing was recorded. */
57
+ export function handleMutationSuccess(queryClient, mutationKey) {
58
+ const pathKey = pathKeyFromOperationKey(mutationKey);
59
+ if (!pathKey)
60
+ return;
61
+ const writes = entries.get(pathKey)?.writes;
62
+ if (!writes || writes.length === 0)
63
+ return;
64
+ invalidateForWrites(queryClient, writes);
65
+ }
66
+ //# sourceMappingURL=query-invalidation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-invalidation.js","sourceRoot":"","sources":["../src/query-invalidation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import { z } from "zod";
2
+ export type { ZodObject, ZodRawShape, ZodType } from "zod";
3
+ export { z } from "zod";
4
+ /** Rows a mutation acts on, as a Table's `choose` hands them over: the ids ticked, or every row a read's query matches but the ids unticked. */
5
+ export type Selector<Q = unknown> = {
6
+ ids: string[];
7
+ } | {
8
+ query: Q;
9
+ except: string[];
10
+ };
11
+ /** The schema of a `Selector` over a read's query: `selector(listQuery)`, the object schema the list procedure's input extends. A mutation takes it as a field (`.input(z.object({ tasks: selector(listQuery) }))`) and resolves it with `chosenWhere` from `@slotform/api/lib/chosen`. */
12
+ export declare function selector<Q extends z.ZodType>(query: Q): z.ZodUnion<readonly [z.ZodObject<{
13
+ ids: z.ZodArray<z.ZodString>;
14
+ }, z.core.$strict>, z.ZodObject<{
15
+ query: Q;
16
+ except: z.ZodDefault<z.ZodArray<z.ZodString>>;
17
+ }, z.core.$strict>]>;
18
+ /** A JSON Schema (draft 2020-12) object. */
19
+ export type JsonSchema = {
20
+ type?: string;
21
+ } & Record<string, unknown>;
22
+ /** One procedure as the client reads it: its input as JSON Schema (`null` when the input is not an object), whether it reads or writes, and the input key its scope adds (`organizationId`, null when it has none), which the client fills from the route's scope. */
23
+ export interface ProcedureSchema {
24
+ input: JsonSchema | null;
25
+ kind: "query" | "mutation";
26
+ scope: string | null;
27
+ }
28
+ /** A procedure's zod input as the JSON Schema of an object, dates as `date-time` strings; an input of `undefined` or `void`, or none, is the empty object. Throws when a part has no JSON Schema form or the input is not an object. */
29
+ export declare function inputJsonSchema(schema: z.ZodType | undefined): JsonSchema;
30
+ /** Every procedure of a router, by dotted path: what `slotform generate` writes to `.slotform/schema.ts`. An input of `undefined` or `void`, or none, is the empty object; an input that is not an object (a union) is `null`; a procedure that cannot be converted throws, naming its path. */
31
+ export declare function routerSchema(routes: unknown): Record<string, ProcedureSchema>;
32
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gJAAgJ;AAChJ,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAC7B;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElC,2RAA2R;AAC3R,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;;;;;qBAOrD;AAED,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErE,sQAAsQ;AACtQ,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AA4CD,wOAAwO;AACxO,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,UAAU,CAMzE;AAgBD,gSAAgS;AAChS,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAoC7E"}
package/dist/schema.js ADDED
@@ -0,0 +1,103 @@
1
+ import { z } from "zod";
2
+ export { z } from "zod";
3
+ /** The schema of a `Selector` over a read's query: `selector(listQuery)`, the object schema the list procedure's input extends. A mutation takes it as a field (`.input(z.object({ tasks: selector(listQuery) }))`) and resolves it with `chosenWhere` from `@slotform/api/lib/chosen`. */
4
+ export function selector(query) {
5
+ return z.union([
6
+ z.object({ ids: z.array(z.string().min(1)) }).strict(),
7
+ z
8
+ .object({ query, except: z.array(z.string().min(1)).default([]) })
9
+ .strict(),
10
+ ]);
11
+ }
12
+ // The kinds of schema JSON Schema cannot hold, which `toJSONSchema` would
13
+ // turn into `{}` under `unrepresentable: "any"`. A `z.date()` is the one
14
+ // exception, a `date-time` string.
15
+ const UNREPRESENTABLE = new Set([
16
+ "bigint",
17
+ "symbol",
18
+ "undefined",
19
+ "void",
20
+ "nan",
21
+ "map",
22
+ "set",
23
+ "custom",
24
+ "function",
25
+ "promise",
26
+ ]);
27
+ function jsonSchema(schema) {
28
+ return z.toJSONSchema(schema, {
29
+ target: "draft-2020-12",
30
+ io: "input",
31
+ unrepresentable: "any",
32
+ override: ({ zodSchema, jsonSchema }) => {
33
+ const type = zodSchema._zod.def.type;
34
+ if (type === "date") {
35
+ jsonSchema.type = "string";
36
+ jsonSchema.format = "date-time";
37
+ }
38
+ else if (UNREPRESENTABLE.has(type)) {
39
+ throw new Error(`a ${type} has no JSON Schema form`);
40
+ }
41
+ },
42
+ });
43
+ }
44
+ // An input of `undefined` or `void`, or none, is the empty object.
45
+ function inputSchemaOf(schema) {
46
+ if (schema === undefined)
47
+ return { type: "object" };
48
+ const type = schema._zod.def.type;
49
+ return type === "undefined" || type === "void"
50
+ ? { type: "object" }
51
+ : jsonSchema(schema);
52
+ }
53
+ /** A procedure's zod input as the JSON Schema of an object, dates as `date-time` strings; an input of `undefined` or `void`, or none, is the empty object. Throws when a part has no JSON Schema form or the input is not an object. */
54
+ export function inputJsonSchema(schema) {
55
+ const json = inputSchemaOf(schema);
56
+ if (json.type !== "object") {
57
+ throw new Error("its input is not an object schema");
58
+ }
59
+ return json;
60
+ }
61
+ function isProcedure(node) {
62
+ return (typeof node === "object" &&
63
+ node !== null &&
64
+ typeof node["~orpc"] === "object" &&
65
+ node["~orpc"] !== null);
66
+ }
67
+ /** Every procedure of a router, by dotted path: what `slotform generate` writes to `.slotform/schema.ts`. An input of `undefined` or `void`, or none, is the empty object; an input that is not an object (a union) is `null`; a procedure that cannot be converted throws, naming its path. */
68
+ export function routerSchema(routes) {
69
+ const out = {};
70
+ const walk = (node, path) => {
71
+ const name = path.join(".");
72
+ if (isProcedure(node)) {
73
+ const def = node["~orpc"];
74
+ const schema = def.inputSchema;
75
+ try {
76
+ const json = inputSchemaOf(schema);
77
+ const { kind, scope } = (def.meta ?? {});
78
+ if (kind !== "query" && kind !== "mutation") {
79
+ throw new Error("it has no kind (not built by `procedure`)");
80
+ }
81
+ const { $schema: _, ...input } = json;
82
+ out[name] = {
83
+ input: input.type === "object" ? input : null,
84
+ kind,
85
+ scope: scope ?? null,
86
+ };
87
+ }
88
+ catch (error) {
89
+ const reason = error instanceof Error ? error.message : String(error);
90
+ throw new Error(`${name}: ${reason}`);
91
+ }
92
+ return;
93
+ }
94
+ if (typeof node === "object" && node !== null) {
95
+ for (const [key, child] of Object.entries(node)) {
96
+ walk(child, [...path, key]);
97
+ }
98
+ }
99
+ };
100
+ walk(routes, []);
101
+ return out;
102
+ }
103
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,2RAA2R;AAC3R,MAAM,UAAU,QAAQ,CAAsB,KAAQ;IACrD,OAAO,CAAC,CAAC,KAAK,CAAC;QACd,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QACtD,CAAC;aACC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;aACjE,MAAM,EAAE;KACV,CAAC,CAAC;AACJ,CAAC;AAYD,0EAA0E;AAC1E,yEAAyE;AACzE,mCAAmC;AACnC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC/B,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,QAAQ;IACR,UAAU;IACV,SAAS;CACT,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,MAAiB;IACpC,OAAO,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,eAAe;QACvB,EAAE,EAAE,OAAO;QACX,eAAe,EAAE,KAAK;QACtB,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACrC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACrB,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;gBAC3B,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC;YACjC,CAAC;iBAAM,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YACtD,CAAC;QACF,CAAC;KACD,CAAe,CAAC;AAClB,CAAC;AAED,mEAAmE;AACnE,SAAS,aAAa,CAAC,MAA6B;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAClC,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM;QAC7C,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC;AAED,wOAAwO;AACxO,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC5D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAOD,SAAS,WAAW,CAAC,IAAa;IACjC,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,OAAQ,IAAc,CAAC,OAAO,CAAC,KAAK,QAAQ;QAC3C,IAAc,CAAC,OAAO,CAAC,KAAK,IAAI,CACjC,CAAC;AACH,CAAC;AAED,gSAAgS;AAChS,MAAM,UAAU,YAAY,CAAC,MAAe;IAC3C,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,IAAc,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,WAAoC,CAAC;YACxD,IAAI,CAAC;gBACJ,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;gBACnC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAGtC,CAAC;gBACF,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC7C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAC9D,CAAC;gBACD,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,GAAG;oBACX,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;oBAC7C,IAAI;oBACJ,KAAK,EAAE,KAAK,IAAI,IAAI;iBACpB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,OAAO;QACR,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC;AACZ,CAAC"}
@@ -0,0 +1,30 @@
1
+ import type { Client } from "@orpc/client";
2
+ export interface Procedure<TInput = unknown, TOutput = unknown, TScope extends string = string> {
3
+ readonly __brand: "Procedure";
4
+ readonly __input: TInput;
5
+ readonly __output: TOutput;
6
+ readonly __scope: TScope;
7
+ }
8
+ export type Router = {
9
+ [key: string]: Procedure<unknown, unknown> | Router;
10
+ };
11
+ type ClientCall<TInput, TOutput> = Client<Record<never, never>, TInput, TOutput, Error>;
12
+ export type RouterClient<T> = {
13
+ [K in keyof T]: T[K] extends Procedure<infer TIn, infer TOut> ? ClientCall<TIn, TOut> : T[K] extends Record<string, unknown> ? RouterClient<T[K]> : never;
14
+ };
15
+ type ScopeOptional<TIn, TScope extends string> = [TScope] extends [never] ? TIn : TIn extends object ? Omit<TIn, TScope> & Partial<Pick<TIn, TScope & keyof TIn>> extends infer R ? Record<never, never> extends R ? R | undefined : R : never : TIn;
16
+ export type ScopedRouterClient<T> = {
17
+ [K in keyof T]: T[K] extends Procedure<infer TIn, infer TOut, infer TScope> ? ClientCall<ScopeOptional<TIn, TScope>, TOut> : T[K] extends Record<string, unknown> ? ScopedRouterClient<T[K]> : never;
18
+ };
19
+ export interface EnvValidation {
20
+ minLength?: number;
21
+ url?: boolean;
22
+ devLocalhost?: boolean;
23
+ }
24
+ export interface EnvSpec {
25
+ name: string;
26
+ devDefault: string;
27
+ validate?: EnvValidation;
28
+ }
29
+ export {};
30
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,SAAS,CACzB,MAAM,GAAG,OAAO,EAChB,OAAO,GAAG,OAAO,EACjB,MAAM,SAAS,MAAM,GAAG,MAAM;IAE9B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,MAAM,MAAM,GAAG;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CACpD,CAAC;AAMF,KAAK,UAAU,CAAC,MAAM,EAAE,OAAO,IAAI,MAAM,CACxC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACpB,MAAM,EACN,OAAO,EACP,KAAK,CACL,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,IAAI,CAAC,GAC1D,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GACrB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,KAAK;CACT,CAAC;AAKF,KAAK,aAAa,CAAC,GAAG,EAAE,MAAM,SAAS,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GACtE,GAAG,GACH,GAAG,SAAS,MAAM,GACjB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GACzE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,GAC7B,CAAC,GAAG,SAAS,GACb,CAAC,GACF,KAAK,GACN,GAAG,CAAC;AAIR,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG,EAAE,MAAM,IAAI,EAAE,MAAM,MAAM,CAAC,GACxE,UAAU,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,GAC5C,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACxB,KAAK;CACT,CAAC;AAGF,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAGD,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC;CACzB"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
package/dist/wire.d.ts ADDED
@@ -0,0 +1,11 @@
1
+ export declare const SLOTFORM_READS_HEADER = "x-slotform-reads";
2
+ export declare const SLOTFORM_WRITES_HEADER = "x-slotform-writes";
3
+ export declare const SLOTFORM_NOT_FOUND_HEADER = "x-slotform-not-found";
4
+ export declare const SLOTFORM_EXPOSED_HEADERS: readonly ["x-slotform-reads", "x-slotform-writes", "x-slotform-not-found"];
5
+ export declare const ENTITY_NAME_RE: RegExp;
6
+ export declare const ORG_RULES_PATH: readonly ["auth", "orgRules"];
7
+ export declare const SCOPE_ROUTES_PATH: readonly ["auth", "scope"];
8
+ export declare const LISTENER_ENV = "SLOTFORM_LISTENER";
9
+ export declare const ORIGIN_ENV = "SLOTFORM_ORIGIN";
10
+ export declare function listenerOrigin(env: unknown): string | null;
11
+ //# sourceMappingURL=wire.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAG1D,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAGhE,eAAO,MAAM,wBAAwB,4EAI3B,CAAC;AAGX,eAAO,MAAM,cAAc,QAAsB,CAAC;AAGlD,eAAO,MAAM,cAAc,YAAI,MAAM,EAAE,UAAU,CAAU,CAAC;AAG5D,eAAO,MAAM,iBAAiB,YAAI,MAAM,EAAE,OAAO,CAAU,CAAC;AAG5D,eAAO,MAAM,YAAY,sBAAsB,CAAC;AAChD,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAG5C,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK1D"}
package/dist/wire.js ADDED
@@ -0,0 +1,26 @@
1
+ // Wire contract: docs/architecture/plugins/api.md, "Wire contract". Import-free so a client bundle never pulls in `procedure.ts`.
2
+ export const SLOTFORM_READS_HEADER = "x-slotform-reads";
3
+ export const SLOTFORM_WRITES_HEADER = "x-slotform-writes";
4
+ // Not found: docs/architecture/plugins/api.md, "Not found".
5
+ export const SLOTFORM_NOT_FOUND_HEADER = "x-slotform-not-found";
6
+ // Exposed headers: docs/architecture/plugins/api.md, "Entity headers".
7
+ export const SLOTFORM_EXPOSED_HEADERS = [
8
+ SLOTFORM_READS_HEADER,
9
+ SLOTFORM_WRITES_HEADER,
10
+ SLOTFORM_NOT_FOUND_HEADER,
11
+ ];
12
+ // Entity names: docs/architecture/plugins/api.md, "Entities".
13
+ export const ENTITY_NAME_RE = /^[A-Za-z0-9_.-]+$/;
14
+ // Org-rules path: docs/architecture/plugins/api.md, "Framework-owned paths".
15
+ export const ORG_RULES_PATH = ["auth", "orgRules"];
16
+ // Scope lookups path: docs/architecture/plugins/api.md, "Framework-owned paths".
17
+ export const SCOPE_ROUTES_PATH = ["auth", "scope"];
18
+ // Listener contract: docs/architecture/plugins/api.md, "Listener contract".
19
+ export const LISTENER_ENV = "SLOTFORM_LISTENER";
20
+ export const ORIGIN_ENV = "SLOTFORM_ORIGIN";
21
+ // The origin the request's listener serves, or null when the env names none.
22
+ export function listenerOrigin(env) {
23
+ const value = env?.[ORIGIN_ENV];
24
+ return typeof value === "string" && value !== "" ? value : null;
25
+ }
26
+ //# sourceMappingURL=wire.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wire.js","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,kIAAkI;AAClI,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AACxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAE1D,4DAA4D;AAC5D,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE,uEAAuE;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACvC,qBAAqB;IACrB,sBAAsB;IACtB,yBAAyB;CAChB,CAAC;AAEX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAElD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,UAAU,CAAU,CAAC;AAE5D,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAU,CAAC;AAE5D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,GAAY;IAC1C,MAAM,KAAK,GAAI,GAAkD,EAAE,CAClE,UAAU,CACV,CAAC;IACF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { Context } from "hono";
2
+ export declare const RATE_LIMITER_RPC = "RATE_LIMITER_RPC";
3
+ export declare const ORIGINS_VAR = "__slotformOrigins";
4
+ export declare function ipLimited(c: Context, ctx: Record<string, unknown>): Promise<boolean>;
5
+ export declare function isForbiddenOrigin(c: Context): boolean;
6
+ //# sourceMappingURL=guards.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/worker/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAGnD,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAG/C,wBAAsB,SAAS,CAC9B,CAAC,EAAE,OAAO,EACV,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,OAAO,CAAC,OAAO,CAAC,CAOlB;AAGD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAarD"}
@@ -0,0 +1,29 @@
1
+ import { extractIp } from "../procedure.js";
2
+ // The `/rpc` limiter's binding name, the contract with the `cloudflare` plugin: docs/architecture/plugins/api.md, "Rate limiting".
3
+ export const RATE_LIMITER_RPC = "RATE_LIMITER_RPC";
4
+ // The Hono variable the worker sets to a request's effective CORS allow-list.
5
+ export const ORIGINS_VAR = "__slotformOrigins";
6
+ // The blanket per-IP `/rpc` limiter: docs/architecture/plugins/api.md, "Rate limiting". True when the limiter refuses.
7
+ export async function ipLimited(c, ctx) {
8
+ const limiter = c.env?.[RATE_LIMITER_RPC];
9
+ if (!limiter || ctx._devMode)
10
+ return false;
11
+ const result = await limiter.limit({ key: extractIp(c.req.raw.headers) });
12
+ return !result.success;
13
+ }
14
+ // The CSRF guard for raw routes: docs/architecture/plugins/api.md, "At runtime".
15
+ export function isForbiddenOrigin(c) {
16
+ const origin = c.req.header("origin");
17
+ if (!origin)
18
+ return false;
19
+ const allowed = c.get(ORIGINS_VAR);
20
+ // Wildcard CORS admits every origin; the guard must agree with the CORS
21
+ // layer instead of judging all real browser origins forbidden.
22
+ if (allowed?.includes("*"))
23
+ return false;
24
+ if (!allowed) {
25
+ throw new Error("isForbiddenOrigin: no origin list on this request. Register the middleware with .useAfterContext() (src/worker/middleware.context.ts), not .use().");
26
+ }
27
+ return !allowed.includes(origin);
28
+ }
29
+ //# sourceMappingURL=guards.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/worker/guards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyB,MAAM,iBAAiB,CAAC;AAEnE,mIAAmI;AACnI,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE/C,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC9B,CAAU,EACV,GAA4B;IAE5B,MAAM,OAAO,GAAI,CAAC,CAAC,GAAkD,EAAE,CACtE,gBAAgB,CACgB,CAAC;IAClC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1E,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,CAAU;IAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAyB,CAAC;IAC3D,wEAAwE;IACxE,+DAA+D;IAC/D,IAAI,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACd,oJAAoJ,CACpJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}
@@ -0,0 +1,57 @@
1
+ import type { RuntimePlugin } from "@slotform/cli/runtime";
2
+ import { type Context, type MiddlewareHandler } from "hono";
3
+ import type { McpDefinition } from "../mcp.ts";
4
+ import { type JobBatch, type JobScheduledEvent } from "../procedure.ts";
5
+ export { isForbiddenOrigin, RATE_LIMITER_RPC } from "./guards.ts";
6
+ export interface WorkerExport<TRouter extends Record<string, unknown> = Record<string, unknown>> {
7
+ fetch: (request: Request, env: unknown, ctx: unknown) => Response | Promise<Response>;
8
+ checkEnv: (env: unknown) => void;
9
+ jobContext: (env: unknown, ctx?: unknown) => Promise<Record<string, unknown>>;
10
+ queue?: (batch: JobBatch, env: unknown, ctx: unknown) => Promise<void>;
11
+ scheduled?: (controller: JobScheduledEvent, env: unknown, ctx: unknown) => Promise<void>;
12
+ _router: TRouter;
13
+ }
14
+ export interface AppBuilder<TContext extends Record<string, unknown>, TPluginRoutes extends Record<string, unknown> = Record<never, never>> {
15
+ use<TName extends string, TProvides extends Record<string, unknown>, TRoutes extends Record<string, unknown>>(plugin: RuntimePlugin<TName, TContext, TProvides, TRoutes>): AppBuilder<TContext & TProvides, TPluginRoutes & TRoutes>;
16
+ use(middleware: MiddlewareHandler): AppBuilder<TContext, TPluginRoutes>;
17
+ use<TExtra extends Record<string, unknown>>(fn: (ctx: TContext) => TExtra | Promise<TExtra>): AppBuilder<TContext & TExtra, TPluginRoutes>;
18
+ useAfterContext(middleware: MiddlewareHandler): AppBuilder<TContext, TPluginRoutes>;
19
+ handler<TRoutes extends Record<string, unknown>>(consumerRoutes?: TRoutes, mount?: HandlerMount): WorkerExport<TPluginRoutes & TRoutes>;
20
+ }
21
+ export type HandlerMount = {
22
+ queue?: JobQueueHandler;
23
+ scheduled?: JobScheduledHandler;
24
+ } & ({
25
+ mcp: McpDefinition;
26
+ name: string;
27
+ } | {
28
+ mcp?: never;
29
+ name?: never;
30
+ });
31
+ type JobQueueHandler = (batch: JobBatch<any>, context: never) => Promise<void>;
32
+ type JobScheduledHandler = (event: JobScheduledEvent, context: never) => Promise<void>;
33
+ export type BaseContext<TEnv = unknown> = {
34
+ env: TEnv;
35
+ httpRequest: Request;
36
+ reqHeaders: Headers;
37
+ resHeaders: Headers;
38
+ executionCtx: {
39
+ waitUntil(promise: Promise<unknown>): void;
40
+ };
41
+ [key: string]: unknown;
42
+ };
43
+ export interface EnvCheckSpec {
44
+ name: string;
45
+ minLength?: number;
46
+ url?: boolean;
47
+ devLocalhost?: boolean;
48
+ }
49
+ export interface ApiWorkerOptions {
50
+ cors?: string[];
51
+ devCors?: string[];
52
+ prefix?: `/${string}`;
53
+ envChecks?: EnvCheckSpec[];
54
+ }
55
+ export default function createWorker<TEnv = unknown>(options?: ApiWorkerOptions): AppBuilder<BaseContext<TEnv>>;
56
+ export declare function slotformContext<TContext extends Record<string, unknown> = BaseContext>(c: Context): TContext;
57
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,KAAK,OAAO,EAAQ,KAAK,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAKlE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAEN,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,YAAY,CAC5B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,KAAK,EAAE,CACN,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO,KACR,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElC,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAEjC,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE9E,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,SAAS,CAAC,EAAE,CACX,UAAU,EAAE,iBAAiB,EAC7B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO,KACR,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACjB;AAqFD,MAAM,WAAW,UAAU,CAC1B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;IAEpE,GAAG,CACF,KAAK,SAAS,MAAM,EACpB,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEvC,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,GACxD,UAAU,CAAC,QAAQ,GAAG,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;IAE7D,GAAG,CAAC,UAAU,EAAE,iBAAiB,GAAG,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAExE,GAAG,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC7C,UAAU,CAAC,QAAQ,GAAG,MAAM,EAAE,aAAa,CAAC,CAAC;IAEhD,eAAe,CACd,UAAU,EAAE,iBAAiB,GAC3B,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAKvC,OAAO,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,cAAc,CAAC,EAAE,OAAO,EACxB,KAAK,CAAC,EAAE,YAAY,GAClB,YAAY,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC;CACzC;AAID,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAChC,GAAG,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAE3E,KAAK,eAAe,GAAG,CAEtB,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,EACpB,OAAO,EAAE,KAAK,KACV,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,KAAK,mBAAmB,GAAG,CAC1B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,KAAK,KACV,OAAO,CAAC,IAAI,CAAC,CAAC;AAInB,MAAM,MAAM,WAAW,CAAC,IAAI,GAAG,OAAO,IAAI;IACzC,GAAG,EAAE,IAAI,CAAC;IAEV,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IAGpB,YAAY,EAAE;QAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAC7D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AAGF,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAGhB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AA4DD,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,IAAI,GAAG,OAAO,EAClD,OAAO,CAAC,EAAE,gBAAgB,GACxB,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAM/B;AAqYD,wBAAgB,eAAe,CAC9B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,EACrD,CAAC,EAAE,OAAO,GAAG,QAAQ,CAQtB"}