@vibesdotdev/docs 0.0.0-stage → 1.0.0-rc.2

package/dist/documents/presentations/state-machine.js

@@ -0,0 +1,158 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { PresentationRequestSchema } from "./schemas/index.js";
+export class PresentationTransitionError extends CapabilityError {
+    transitionCode;
+    constructor(transitionCode, message) {
+        super(message, 'CONFLICT', {
+            reason: `presentation-transition-${transitionCode.toLowerCase().replace(/_/g, '-')}`
+        });
+        this.name = 'PresentationTransitionError';
+        this.transitionCode = transitionCode;
+    }
+}
+const terminalStatuses = new Set([
+    'declined',
+    'expired',
+    'withdrawn',
+    'completed',
+    'failed'
+]);
+export const PRESENTATION_REQUEST_EXPIRABLE_STATUSES = [
+    'pending',
+    'accepted',
+    'presenting'
+];
+const expirableStatuses = new Set(PRESENTATION_REQUEST_EXPIRABLE_STATUSES);
+function fail(code, message) {
+    throw new PresentationTransitionError(code, message);
+}
+function transitionRevision(request, expectedRevision, at) {
+    if (request.revision !== expectedRevision) {
+        fail('REVISION_CONFLICT', `presentation request revision ${request.revision} does not match expected ${expectedRevision}`);
+    }
+    if (terminalStatuses.has(request.status)) {
+        fail('INVALID_TRANSITION', `presentation request is already ${request.status}`);
+    }
+    if (expirableStatuses.has(request.status) && Date.parse(request.expiresAt) <= at.getTime()) {
+        fail('REQUEST_EXPIRED', 'presentation request lifetime has expired');
+    }
+    return request;
+}
+function requireSelectedSurface(request, surfaceId) {
+    if (request.selectedSurfaceId !== surfaceId) {
+        fail('SURFACE_MISMATCH', 'presentation transition came from a different surface');
+    }
+}
+export function transitionPresentationRequest(value, transition, at = new Date()) {
+    const request = PresentationRequestSchema.parse(value);
+    const expectedRevision = transition.kind === 'expire' ? transition.expectedRevision : transition.input.expectedRevision;
+    if (transition.kind !== 'expire' && transition.input.requestId !== request.id) {
+        fail('REQUEST_MISMATCH', 'presentation transition targets a different request');
+    }
+    if (transition.kind === 'expire') {
+        if (request.revision !== expectedRevision) {
+            fail('REVISION_CONFLICT', `presentation request revision ${request.revision} does not match expected ${expectedRevision}`);
+        }
+        if (!expirableStatuses.has(request.status)) {
+            fail('INVALID_TRANSITION', `cannot expire a ${request.status} presentation request`);
+        }
+        if (Date.parse(request.expiresAt) > at.getTime()) {
+            fail('INVALID_TRANSITION', 'presentation request has not reached its expiry');
+        }
+        return PresentationRequestSchema.parse({
+            ...request,
+            status: 'expired',
+            revision: request.revision + 1,
+            updatedAt: at.toISOString(),
+            completedAt: at.toISOString()
+        });
+    }
+    transitionRevision(request, expectedRevision, at);
+    if (transition.kind === 'respond') {
+        if (request.status !== 'pending') {
+            fail('INVALID_TRANSITION', `cannot respond to a ${request.status} presentation request`);
+        }
+        const accepted = transition.input.decision === 'accept';
+        return PresentationRequestSchema.parse({
+            ...request,
+            status: accepted ? 'accepted' : 'declined',
+            selectedSurfaceId: transition.input.surfaceId,
+            revision: request.revision + 1,
+            updatedAt: at.toISOString(),
+            respondedAt: at.toISOString(),
+            completedAt: accepted ? null : at.toISOString(),
+            note: transition.input.note ?? null
+        });
+    }
+    if (transition.kind === 'start') {
+        if (request.status !== 'accepted') {
+            fail('INVALID_TRANSITION', `cannot start a ${request.status} presentation request`);
+        }
+        requireSelectedSurface(request, transition.input.surfaceId);
+        return PresentationRequestSchema.parse({
+            ...request,
+            status: 'presenting',
+            revision: request.revision + 1,
+            updatedAt: at.toISOString(),
+            presentingAt: at.toISOString()
+        });
+    }
+    if (transition.kind === 'finish') {
+        if (request.status !== 'presenting' &&
+            !(request.status === 'accepted' && transition.input.outcome === 'failed')) {
+            fail('INVALID_TRANSITION', `cannot finish a ${request.status} presentation request`);
+        }
+        requireSelectedSurface(request, transition.input.surfaceId);
+        return PresentationRequestSchema.parse({
+            ...request,
+            status: transition.input.outcome,
+            revision: request.revision + 1,
+            updatedAt: at.toISOString(),
+            completedAt: at.toISOString(),
+            note: transition.input.note ?? request.note
+        });
+    }
+    if (!['pending', 'accepted', 'presenting'].includes(request.status)) {
+        fail('INVALID_TRANSITION', `cannot withdraw a ${request.status} presentation request`);
+    }
+    return PresentationRequestSchema.parse({
+        ...request,
+        status: 'withdrawn',
+        revision: request.revision + 1,
+        updatedAt: at.toISOString(),
+        completedAt: at.toISOString(),
+        note: transition.input.note ?? request.note
+    });
+}
+/**
+ * Project an elapsed active request into its durable terminal state.
+ *
+ * Providers call this on authoritative reads before filtering or returning a
+ * request, then persist the revision-fenced result. Keeping the policy in the
+ * package state machine prevents each host from inventing a different notion
+ * of "active".
+ */
+export function reconcilePresentationRequestExpiry(value, at = new Date()) {
+    const request = PresentationRequestSchema.parse(value);
+    if (!expirableStatuses.has(request.status) || Date.parse(request.expiresAt) > at.getTime()) {
+        return request;
+    }
+    return transitionPresentationRequest(request, { kind: 'expire', expectedRevision: request.revision }, at);
+}
+export function assertPresentationReviewMatchesRequest(value, submission, at = new Date()) {
+    const request = reconcilePresentationRequestExpiry(PresentationRequestSchema.parse(value), at);
+    if (submission.requestId !== request.id) {
+        fail('REQUEST_MISMATCH', 'presentation review targets a different request');
+    }
+    if (request.status !== 'presenting') {
+        fail('INVALID_TRANSITION', 'review can only be submitted while a request is presenting');
+    }
+    requireSelectedSurface(request, submission.surfaceId);
+    const expectedRevision = request.target.revision;
+    if (submission.targetRevision !== undefined &&
+        expectedRevision !== undefined &&
+        submission.targetRevision !== expectedRevision) {
+        fail('TARGET_REVISION_MISMATCH', 'presentation review does not match the presented target revision');
+    }
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/documents/presentations/state-machine.js.map

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

package/dist/documents/presentations/storage/index.d.ts

@@ -0,0 +1,3 @@
+export * from './records.ts';
+export * from './owner-app.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/documents/presentations/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/documents/presentations/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/documents/presentations/storage/index.js

@@ -0,0 +1,3 @@
+export * from "./records.js";
+export * from "./owner-app.js";
+//# sourceMappingURL=index.js.map

package/dist/documents/presentations/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/documents/presentations/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/documents/presentations/storage/owner-app.d.ts

@@ -0,0 +1,12 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { StorageRecordInterface } from '@vibesdotdev/storage/interfaces/record';
+import { type StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+/**
+ * Resolve an owner-app record through the runtime's cloud-api adapter.
+ *
+ * Feature code owns the descriptor but never imports an adapter package. The
+ * composition root decides whether storage.cloud-api exists; callers fail
+ * closed with an actionable message when it does not.
+ */
+export declare function resolvePresentationOwnerAppRecord<T>(runtime: VibesRuntime, descriptor: StorageRecordDescriptorInput): Promise<StorageRecordInterface<T>>;
+//# sourceMappingURL=owner-app.d.ts.map

package/dist/documents/presentations/storage/owner-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-app.d.ts","sourceRoot":"","sources":["../../../../src/documents/presentations/storage/owner-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,EAGN,KAAK,4BAA4B,EACjC,MAAM,qCAAqC,CAAC;AAkB7C;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CAAC,CAAC,EACxD,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,4BAA4B,GACtC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAwBpC"}

package/dist/documents/presentations/storage/owner-app.js

@@ -0,0 +1,43 @@
+import { StorageRecordDescriptorSchema } from '@vibesdotdev/storage/schemas/record';
+import { StorageCloudApiAdapterConfigSchema } from '@vibesdotdev/storage/schemas/manifest-descriptor';
+function remoteOnlyDescriptor(input) {
+    return StorageRecordDescriptorSchema.parse({
+        ...input,
+        allowedAdapters: ['storage.cloud-api'],
+        defaultAdapter: 'storage.cloud-api',
+        persistence: {
+            mode: 'remote-only',
+            localAdapters: [],
+            remoteAdapters: ['storage.cloud-api']
+        }
+    });
+}
+/**
+ * Resolve an owner-app record through the runtime's cloud-api adapter.
+ *
+ * Feature code owns the descriptor but never imports an adapter package. The
+ * composition root decides whether storage.cloud-api exists; callers fail
+ * closed with an actionable message when it does not.
+ */
+export async function resolvePresentationOwnerAppRecord(runtime, descriptor) {
+    if (!runtime.hasKind('storage/adapter')) {
+        throw new Error("Presentations owner-app access requires the 'storage/adapter' runtime kind.");
+    }
+    const adapter = await runtime
+        .query('storage/adapter')
+        .withId('storage.cloud-api')
+        .enabled()
+        .resolve();
+    if (!adapter) {
+        throw new Error("Presentations owner-app access requires the 'storage.cloud-api' adapter.");
+    }
+    // The cloud-api adapter resolves origins, the service token and the caller
+    // bearer on the runtime it is configured with; hand it the caller's runtime.
+    // Bound with the record's own cloud fields (owner app) under its id, so the
+    // adapter-wide binding is never left ownerless.
+    const record = remoteOnlyDescriptor(descriptor);
+    const cloudFields = StorageCloudApiAdapterConfigSchema.partial().parse(record.adapterConfig?.['storage.cloud-api'] ?? {});
+    adapter.configure({ ...cloudFields, runtime, recordId: record.id });
+    return adapter.record(record);
+}
+//# sourceMappingURL=owner-app.js.map

package/dist/documents/presentations/storage/owner-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-app.js","sourceRoot":"","sources":["../../../../src/documents/presentations/storage/owner-app.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,6BAA6B,EAG7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,kCAAkC,EAAE,MAAM,kDAAkD,CAAC;AAEtG,SAAS,oBAAoB,CAC5B,KAAmC;IAEnC,OAAO,6BAA6B,CAAC,KAAK,CAAC;QAC1C,GAAG,KAAK;QACR,eAAe,EAAE,CAAC,mBAAmB,CAAC;QACtC,cAAc,EAAE,mBAAmB;QACnC,WAAW,EAAE;YACZ,IAAI,EAAE,aAAa;YACnB,aAAa,EAAE,EAAE;YACjB,cAAc,EAAE,CAAC,mBAAmB,CAAC;SACrC;KACD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACtD,OAAqB,EACrB,UAAwC;IAExC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACd,6EAA6E,CAC7E,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,OAAO;SAC3B,KAAK,CAAoD,iBAAiB,CAAC;SAC3E,MAAM,CAAC,mBAAmB,CAAC;SAC3B,OAAO,EAAE;SACT,OAAO,EAAE,CAAC;IACZ,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACd,0EAA0E,CAC1E,CAAC;IACH,CAAC;IACD,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,gDAAgD;IAChD,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,kCAAkC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1H,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,OAAO,CAAC,MAAM,CAAI,MAAM,CAAC,CAAC;AAClC,CAAC"}