@nakafa/aksara-contracts 0.27.0

package/dist/transport/group.js

@@ -0,0 +1,47 @@
+import { Schema } from "effect";
+import { ReleaseIdSchema } from "#contracts/ids";
+import { StageArtifactBatchRequestSchema, StageItemBatchRequestSchema, StageProjectionBatchRequestSchema, StageRollbackProjectionBatchRequestSchema, StageRouteBatchRequestSchema, } from "#contracts/transport/batch";
+import { MAX_STAGE_GROUP_COUNT } from "#contracts/transport/limits";
+import { StageTryoutRuntimeBundleRequestSchema } from "#contracts/transport/runtime";
+import { StageSnapshotBatchRequestSchema, StageSnapshotRequestSchema, } from "#contracts/transport/snapshot";
+/** One existing safe transaction carried inside an authenticated group. */
+export const StageOperationSchema = Schema.Union([
+    StageArtifactBatchRequestSchema,
+    StageItemBatchRequestSchema,
+    StageProjectionBatchRequestSchema,
+    StageRollbackProjectionBatchRequestSchema,
+    StageRouteBatchRequestSchema,
+    StageSnapshotRequestSchema,
+    StageSnapshotBatchRequestSchema,
+    StageTryoutRuntimeBundleRequestSchema,
+]);
+const StageGroupFields = {
+    releaseId: ReleaseIdSchema,
+    requests: Schema.NonEmptyArray(StageOperationSchema).pipe(Schema.check(Schema.isMaxLength(MAX_STAGE_GROUP_COUNT))),
+};
+/** Requires every grouped transaction to belong to the outer release. */
+function hasBoundRequests(input) {
+    return input.requests.every((request) => request.releaseId === input.releaseId);
+}
+/** Canonical target input for one bounded authenticated request group. */
+export const StageGroupInputSchema = Schema.Struct(StageGroupFields).pipe(Schema.check(Schema.makeFilter(hasBoundRequests, {
+    message: "Expected every staged request to share one release identity.",
+})));
+/** Carries multiple safe staging transactions through one HTTP exchange. */
+export const StageGroupRequestSchema = Schema.Struct({
+    ...StageGroupFields,
+    operation: Schema.Literal("stageGroup"),
+}).pipe(Schema.check(Schema.makeFilter(hasBoundRequests, {
+    message: "Expected every staged request to share one release identity.",
+})));
+/** Confirms that every transaction in one grouped request completed. */
+export const StageGroupReceiptSchema = Schema.Struct({
+    releaseId: ReleaseIdSchema,
+    requestCount: Schema.Finite.pipe(Schema.check(Schema.isInt()), Schema.check(Schema.isBetween({ maximum: MAX_STAGE_GROUP_COUNT, minimum: 1 }))),
+});
+/** Returns bounded completion evidence for one authenticated group. */
+export const StageGroupSuccessSchema = Schema.Struct({
+    ok: Schema.Literal(true),
+    operation: Schema.Literal("stageGroup"),
+    value: StageGroupReceiptSchema,
+});

package/dist/transport/limits.d.ts

@@ -0,0 +1,30 @@
+/** Maximum complete HTTP request body accepted by publication ingress. */
+export declare const MAX_PUBLICATION_REQUEST_BYTES: number;
+/** Maximum complete HTTP response body accepted from publication ingress. */
+export declare const MAX_PUBLICATION_RESPONSE_BYTES: number;
+/** Maximum complete signed-artifact batch accepted by publication ingress. */
+export declare const MAX_ARTIFACT_BATCH_BYTES: number;
+/** Maximum measured artifacts below transaction compute and write ceilings. */
+export declare const MAX_ARTIFACT_BATCH_COUNT = 128;
+/** Maximum complete ordered-item batch accepted by publication ingress. */
+export declare const MAX_ITEM_BATCH_BYTES: number;
+/** Maximum ordered release items accepted by one staging transaction. */
+export declare const MAX_ITEM_BATCH_COUNT = 64;
+/** Maximum complete ordered-route batch accepted by publication ingress. */
+export declare const MAX_ROUTE_BATCH_BYTES: number;
+/** Maximum ordered route items accepted by one staging transaction. */
+export declare const MAX_ROUTE_BATCH_COUNT = 64;
+/** Maximum complete projection batch accepted by publication ingress. */
+export declare const MAX_PROJECTION_BATCH_BYTES: number;
+/** Maximum canonical projections accepted by one staging transaction. */
+export declare const MAX_PROJECTION_BATCH_COUNT = 64;
+/** Maximum complete structured-snapshot batch accepted by publication ingress. */
+export declare const MAX_SNAPSHOT_BATCH_BYTES: number;
+/** Maximum structured snapshot rows accepted by one staging transaction. */
+export declare const MAX_SNAPSHOT_BATCH_COUNT = 64;
+/** Maximum complete grouped staging body below the Node action argument cap. */
+export declare const MAX_STAGE_GROUP_BYTES: number;
+/** Maximum safe staging transactions executed by one authenticated action. */
+export declare const MAX_STAGE_GROUP_COUNT = 64;
+/** Maximum compact material heads returned by one authoritative page. */
+export declare const MAX_HEAD_PAGE_COUNT = 500;

package/dist/transport/limits.js

@@ -0,0 +1,30 @@
+/** Maximum complete HTTP request body accepted by publication ingress. */
+export const MAX_PUBLICATION_REQUEST_BYTES = 5 * 1024 * 1024;
+/** Maximum complete HTTP response body accepted from publication ingress. */
+export const MAX_PUBLICATION_RESPONSE_BYTES = 5 * 1024 * 1024;
+/** Maximum complete signed-artifact batch accepted by publication ingress. */
+export const MAX_ARTIFACT_BATCH_BYTES = 4 * 1024 * 1024;
+/** Maximum measured artifacts below transaction compute and write ceilings. */
+export const MAX_ARTIFACT_BATCH_COUNT = 128;
+/** Maximum complete ordered-item batch accepted by publication ingress. */
+export const MAX_ITEM_BATCH_BYTES = 512 * 1024;
+/** Maximum ordered release items accepted by one staging transaction. */
+export const MAX_ITEM_BATCH_COUNT = 64;
+/** Maximum complete ordered-route batch accepted by publication ingress. */
+export const MAX_ROUTE_BATCH_BYTES = MAX_ITEM_BATCH_BYTES;
+/** Maximum ordered route items accepted by one staging transaction. */
+export const MAX_ROUTE_BATCH_COUNT = MAX_ITEM_BATCH_COUNT;
+/** Maximum complete projection batch accepted by publication ingress. */
+export const MAX_PROJECTION_BATCH_BYTES = 4 * 1024 * 1024;
+/** Maximum canonical projections accepted by one staging transaction. */
+export const MAX_PROJECTION_BATCH_COUNT = 64;
+/** Maximum complete structured-snapshot batch accepted by publication ingress. */
+export const MAX_SNAPSHOT_BATCH_BYTES = 4 * 1024 * 1024;
+/** Maximum structured snapshot rows accepted by one staging transaction. */
+export const MAX_SNAPSHOT_BATCH_COUNT = 64;
+/** Maximum complete grouped staging body below the Node action argument cap. */
+export const MAX_STAGE_GROUP_BYTES = 4 * 1024 * 1024 + 512 * 1024;
+/** Maximum safe staging transactions executed by one authenticated action. */
+export const MAX_STAGE_GROUP_COUNT = 64;
+/** Maximum compact material heads returned by one authoritative page. */
+export const MAX_HEAD_PAGE_COUNT = 500;