@odla-ai/chapter 0.38.1 → 0.39.1

package/dist/worker/index.d.cts

@@ -113,6 +113,28 @@ interface ResolvedMemberContent {
     } | null;
 }
 
+/** Optional private Builder Library shared across Built Not Found and Chapters. */
+interface ChapterBuilderLibrary {
+    /** Keep local admin authoring enabled. Defaults to true. */
+    localAuthoring?: boolean;
+    /** Signed sources this app accepts. Hub sources are Chapters; Chapter sources are Built Not Found. */
+    sources?: readonly {
+        sourceId: string;
+        /** Vault key holding the dedicated Builder Library edge secret. */
+        secretName?: string;
+    }[];
+}
+interface ResolvedBuilderLibrarySource {
+    sourceId: string;
+    secretName: string;
+}
+/** Validated Builder Library settings carried on a resolved Chapter. */
+interface ResolvedBuilderLibrary {
+    enabled: true;
+    localAuthoring: boolean;
+    sources: readonly ResolvedBuilderLibrarySource[];
+}
+
 /** Scalar kinds accepted by the Chapter schema adapter. */
 type AttrType = "string" | "number" | "boolean" | "json";
 /** One odla-db attribute: its type and index/uniqueness/optionality flags. */
@@ -544,6 +566,8 @@ interface ChapterConfig {
     signupControl?: ChapterSignupControl;
     /** Authenticated parent + chapter member pages with server-enforced tier access. */
     memberContent?: ChapterMemberContent;
+    /** Private docs, Brand asset references, and links for authorized site-building agents. */
+    builderLibrary?: ChapterBuilderLibrary;
     /** Enable a public, host-rendered formation application workflow. */
     formation?: LeaderFormationConfig;
     thesis?: unknown;
@@ -642,6 +666,8 @@ interface Chapter {
     signupControl: ResolvedSignupControl | null;
     /** Null unless the standard authenticated member-content surface is enabled. */
     memberContent: ResolvedMemberContent | null;
+    /** Null unless the private scoped Builder Library is enabled. */
+    builderLibrary: ResolvedBuilderLibrary | null;
     /** Resolved public formation intake contract (disabled when omitted). */
     formation: ResolvedLeaderFormation;
     /** Resolved CRM engine (from `defineCrm`). */
@@ -1006,6 +1032,106 @@ interface MemberContentDeliveryOptions {
 /** Deliver one exact revision. Durable retry and approval remain Parent concerns. */
 declare function deliverMemberContent(options: MemberContentDeliveryOptions): Promise<MemberContentReceipt>;
 
+/** Versioned contract for private Builder Library source material. */
+declare const BUILDER_LIBRARY_SCHEMA_VERSION: 1;
+/** Authority kind attached to one complete Builder Library document. */
+type BuilderLibrarySourceType = "chapter" | "built_not_found";
+/** Stable authority identity attached to a Builder Library document. */
+interface BuilderLibrarySource {
+    type: BuilderLibrarySourceType;
+    appId: string;
+}
+/** Exact app deployment that a signed Builder Library revision targets. */
+interface BuilderLibraryTarget {
+    appId: string;
+    environment: string;
+}
+/** Exactly one visibility scope. There are deliberately no groups or audience arrays. */
+type BuilderLibraryScope = {
+    kind: "chapter";
+    chapterId: string;
+} | {
+    kind: "built_not_found";
+} | {
+    kind: "global";
+};
+/** Supported private source-material representations. */
+type BuilderLibraryResourceKind = "document" | "note" | "link" | "inspiration" | "image" | "file";
+/** Explicit authoring lifecycle; only published resources enter agent manifests. */
+type BuilderLibraryResourceStatus = "draft" | "published" | "archived";
+/** Durable Brand identity only; URLs, bytes, and storage credentials never enter a manifest. */
+interface BuilderLibraryBrandAssetRef {
+    bookId: string;
+    assetId: string;
+    filename?: string;
+}
+/** Immutable origin recorded when Built Not Found promotes Chapter material. */
+interface BuilderLibraryPromotionProvenance {
+    chapterId: string;
+    resourceId: string;
+    resourceRevision: number;
+    documentRevision: number;
+    promotedBy: string;
+    promotedAt: number;
+}
+/** Server-authored creation/update history for one resource. */
+interface BuilderLibraryResourceProvenance {
+    createdBy: string;
+    createdAt: number;
+    updatedBy: string;
+    updatedAt: number;
+    promotedFrom?: BuilderLibraryPromotionProvenance;
+}
+/** One bounded, revisioned private source item. */
+interface BuilderLibraryResource {
+    id: string;
+    kind: BuilderLibraryResourceKind;
+    title: string;
+    summary?: string;
+    tags: readonly string[];
+    scope: BuilderLibraryScope;
+    status: BuilderLibraryResourceStatus;
+    revision: number;
+    bodyMarkdown?: string;
+    url?: string;
+    brandAsset?: BuilderLibraryBrandAssetRef;
+    provenance: BuilderLibraryResourceProvenance;
+}
+/** Complete local or federated authoring layer. */
+interface BuilderLibraryDocument {
+    schemaVersion: typeof BUILDER_LIBRARY_SCHEMA_VERSION;
+    revision: number;
+    generatedAt: number;
+    source: BuilderLibrarySource;
+    target?: BuilderLibraryTarget;
+    resources: readonly BuilderLibraryResource[];
+}
+/** Canonical document and digest transmitted over the signed library edge. */
+interface BuilderLibraryEnvelope {
+    digest: string;
+    document: BuilderLibraryDocument;
+}
+/** Durable acknowledgement for an accepted or idempotently replayed revision. */
+interface BuilderLibraryReceipt {
+    ok: true;
+    target: BuilderLibraryTarget;
+    revision: number;
+    digest: string;
+    status: "accepted" | "replayed";
+    acknowledgedAt: number;
+}
+
+/** Inputs for one signed Builder Library peer delivery. */
+interface BuilderLibraryDeliveryOptions {
+    secret: string;
+    sender: string;
+    targetUrl: string | URL;
+    envelope: BuilderLibraryEnvelope;
+    fetch?: typeof globalThis.fetch;
+}
+/** Deliver one exact Builder Library revision over its dedicated signed edge. */
+declare function deliverBuilderLibrary(options: BuilderLibraryDeliveryOptions): Promise<BuilderLibraryReceipt>;
+
 /** Current wire version for parent-authored admission decisions. */
 declare const ADMISSION_GRANTS_SCHEMA_VERSION: 1;
 /** Whether an exact email can skip or must retain the Chapter interview. */
@@ -1132,4 +1258,4 @@ declare function chapterWorker(options: ChapterWorkerOptions): {
     fetch(req: Request, env: ChapterEnv): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type AdmissionGrantDeliveryOptions, type ChapterEnv, type ChapterWorkerOptions, type MemberContentDeliveryOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverAdmissionGrants, deliverMemberContent, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterWorkerOptions, type MemberContentDeliveryOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };

package/dist/worker/index.d.ts

@@ -113,6 +113,28 @@ interface ResolvedMemberContent {
     } | null;
 }
 
+/** Optional private Builder Library shared across Built Not Found and Chapters. */
+interface ChapterBuilderLibrary {
+    /** Keep local admin authoring enabled. Defaults to true. */
+    localAuthoring?: boolean;
+    /** Signed sources this app accepts. Hub sources are Chapters; Chapter sources are Built Not Found. */
+    sources?: readonly {
+        sourceId: string;
+        /** Vault key holding the dedicated Builder Library edge secret. */
+        secretName?: string;
+    }[];
+}
+interface ResolvedBuilderLibrarySource {
+    sourceId: string;
+    secretName: string;
+}
+/** Validated Builder Library settings carried on a resolved Chapter. */
+interface ResolvedBuilderLibrary {
+    enabled: true;
+    localAuthoring: boolean;
+    sources: readonly ResolvedBuilderLibrarySource[];
+}
+
 /** Scalar kinds accepted by the Chapter schema adapter. */
 type AttrType = "string" | "number" | "boolean" | "json";
 /** One odla-db attribute: its type and index/uniqueness/optionality flags. */
@@ -544,6 +566,8 @@ interface ChapterConfig {
     signupControl?: ChapterSignupControl;
     /** Authenticated parent + chapter member pages with server-enforced tier access. */
     memberContent?: ChapterMemberContent;
+    /** Private docs, Brand asset references, and links for authorized site-building agents. */
+    builderLibrary?: ChapterBuilderLibrary;
     /** Enable a public, host-rendered formation application workflow. */
     formation?: LeaderFormationConfig;
     thesis?: unknown;
@@ -642,6 +666,8 @@ interface Chapter {
     signupControl: ResolvedSignupControl | null;
     /** Null unless the standard authenticated member-content surface is enabled. */
     memberContent: ResolvedMemberContent | null;
+    /** Null unless the private scoped Builder Library is enabled. */
+    builderLibrary: ResolvedBuilderLibrary | null;
     /** Resolved public formation intake contract (disabled when omitted). */
     formation: ResolvedLeaderFormation;
     /** Resolved CRM engine (from `defineCrm`). */
@@ -1006,6 +1032,106 @@ interface MemberContentDeliveryOptions {
 /** Deliver one exact revision. Durable retry and approval remain Parent concerns. */
 declare function deliverMemberContent(options: MemberContentDeliveryOptions): Promise<MemberContentReceipt>;
 
+/** Versioned contract for private Builder Library source material. */
+declare const BUILDER_LIBRARY_SCHEMA_VERSION: 1;
+/** Authority kind attached to one complete Builder Library document. */
+type BuilderLibrarySourceType = "chapter" | "built_not_found";
+/** Stable authority identity attached to a Builder Library document. */
+interface BuilderLibrarySource {
+    type: BuilderLibrarySourceType;
+    appId: string;
+}
+/** Exact app deployment that a signed Builder Library revision targets. */
+interface BuilderLibraryTarget {
+    appId: string;
+    environment: string;
+}
+/** Exactly one visibility scope. There are deliberately no groups or audience arrays. */
+type BuilderLibraryScope = {
+    kind: "chapter";
+    chapterId: string;
+} | {
+    kind: "built_not_found";
+} | {
+    kind: "global";
+};
+/** Supported private source-material representations. */
+type BuilderLibraryResourceKind = "document" | "note" | "link" | "inspiration" | "image" | "file";
+/** Explicit authoring lifecycle; only published resources enter agent manifests. */
+type BuilderLibraryResourceStatus = "draft" | "published" | "archived";
+/** Durable Brand identity only; URLs, bytes, and storage credentials never enter a manifest. */
+interface BuilderLibraryBrandAssetRef {
+    bookId: string;
+    assetId: string;
+    filename?: string;
+}
+/** Immutable origin recorded when Built Not Found promotes Chapter material. */
+interface BuilderLibraryPromotionProvenance {
+    chapterId: string;
+    resourceId: string;
+    resourceRevision: number;
+    documentRevision: number;
+    promotedBy: string;
+    promotedAt: number;
+}
+/** Server-authored creation/update history for one resource. */
+interface BuilderLibraryResourceProvenance {
+    createdBy: string;
+    createdAt: number;
+    updatedBy: string;
+    updatedAt: number;
+    promotedFrom?: BuilderLibraryPromotionProvenance;
+}
+/** One bounded, revisioned private source item. */
+interface BuilderLibraryResource {
+    id: string;
+    kind: BuilderLibraryResourceKind;
+    title: string;
+    summary?: string;
+    tags: readonly string[];
+    scope: BuilderLibraryScope;
+    status: BuilderLibraryResourceStatus;
+    revision: number;
+    bodyMarkdown?: string;
+    url?: string;
+    brandAsset?: BuilderLibraryBrandAssetRef;
+    provenance: BuilderLibraryResourceProvenance;
+}
+/** Complete local or federated authoring layer. */
+interface BuilderLibraryDocument {
+    schemaVersion: typeof BUILDER_LIBRARY_SCHEMA_VERSION;
+    revision: number;
+    generatedAt: number;
+    source: BuilderLibrarySource;
+    target?: BuilderLibraryTarget;
+    resources: readonly BuilderLibraryResource[];
+}
+/** Canonical document and digest transmitted over the signed library edge. */
+interface BuilderLibraryEnvelope {
+    digest: string;
+    document: BuilderLibraryDocument;
+}
+/** Durable acknowledgement for an accepted or idempotently replayed revision. */
+interface BuilderLibraryReceipt {
+    ok: true;
+    target: BuilderLibraryTarget;
+    revision: number;
+    digest: string;
+    status: "accepted" | "replayed";
+    acknowledgedAt: number;
+}
+
+/** Inputs for one signed Builder Library peer delivery. */
+interface BuilderLibraryDeliveryOptions {
+    secret: string;
+    sender: string;
+    targetUrl: string | URL;
+    envelope: BuilderLibraryEnvelope;
+    fetch?: typeof globalThis.fetch;
+}
+/** Deliver one exact Builder Library revision over its dedicated signed edge. */
+declare function deliverBuilderLibrary(options: BuilderLibraryDeliveryOptions): Promise<BuilderLibraryReceipt>;
+
 /** Current wire version for parent-authored admission decisions. */
 declare const ADMISSION_GRANTS_SCHEMA_VERSION: 1;
 /** Whether an exact email can skip or must retain the Chapter interview. */
@@ -1132,4 +1258,4 @@ declare function chapterWorker(options: ChapterWorkerOptions): {
     fetch(req: Request, env: ChapterEnv): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type AdmissionGrantDeliveryOptions, type ChapterEnv, type ChapterWorkerOptions, type MemberContentDeliveryOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverAdmissionGrants, deliverMemberContent, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterWorkerOptions, type MemberContentDeliveryOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };