@rippling/rippling-sdk 0.2.0-alpha.109 → 0.2.0-alpha.110

package/lib/manifest/definitions/agent.d.mts

@@ -0,0 +1,51 @@
+import { ACPAgent, type ACPAgentProps, type ACPAgentSourceFile } from "../acp-agent.mjs";
+import type { RipplingSDK } from "../../../client.mjs";
+import type { RequestOptions } from "../../../internal/request-options.mjs";
+import type { SessionCreateParams, SessionListParams, SessionCreateResponse, SessionListResponse, SessionListResponsesPageCursorURL } from "../../../resources/agents/sessions/sessions.mjs";
+import type { AgentRetrieveResponse } from "../../../resources/agents/agents.mjs";
+import type { APIPromise } from "../../../core/api-promise.mjs";
+import type { PagePromise } from "../../../core/pagination.mjs";
+export type DefinedAgentProps = {
+    apiName: `${string}__c`;
+} & ((ACPAgentProps & {
+    source?: never;
+}) | (Omit<ACPAgentProps, 'files' | 'entrypoint'> & {
+    source: URL;
+    files?: never;
+    entrypoint?: never;
+}));
+/** Authenticated agent resources supplied per call. */
+export interface AgentOperationsContext {
+    readonly agents: {
+        readonly retrieve: RipplingSDK['agents']['retrieve'];
+        readonly sessions: Pick<RipplingSDK['agents']['sessions'], 'create' | 'list'>;
+    };
+}
+export interface AgentSessions {
+    create(ctx: AgentOperationsContext, params: Omit<SessionCreateParams, 'agent_id'>, options?: RequestOptions): APIPromise<SessionCreateResponse>;
+    list(ctx: AgentOperationsContext, params?: SessionListParams, options?: RequestOptions): PagePromise<SessionListResponsesPageCursorURL, SessionListResponse>;
+}
+export interface AgentOperations {
+    retrieve(ctx: AgentOperationsContext, options?: RequestOptions): APIPromise<AgentRetrieveResponse>;
+    sessions: AgentSessions;
+}
+export interface AgentClient {
+    retrieve(options?: RequestOptions): APIPromise<AgentRetrieveResponse>;
+    sessions: {
+        create(params: Omit<SessionCreateParams, 'agent_id'>, options?: RequestOptions): APIPromise<SessionCreateResponse>;
+        list(params?: SessionListParams, options?: RequestOptions): PagePromise<SessionListResponsesPageCursorURL, SessionListResponse>;
+    };
+}
+export declare function defineAgent(props: DefinedAgentProps): DefinedAgent;
+export declare class DefinedAgent extends ACPAgent {
+    private _source;
+    readonly retrieve: (ctx: AgentOperationsContext, options?: RequestOptions) => APIPromise<AgentRetrieveResponse>;
+    readonly sessions: AgentSessions;
+    constructor(props: DefinedAgentProps);
+    get source(): URL | undefined;
+    /** Replaces inline files or a file-backed source with the supplied files and entrypoint. */
+    setSource(files: ACPAgentSourceFile[], entrypoint: string): this;
+}
+/** @internal Forward client helpers to the definition operations. */
+export declare function createAgentClient(ctx: AgentOperationsContext, definition: ACPAgent): AgentClient;
+//# sourceMappingURL=agent.d.mts.map

package/lib/manifest/definitions/agent.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.mts","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/agent.ts"],"names":[],"mappings":"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"}

package/lib/manifest/definitions/agent.d.ts

@@ -0,0 +1,51 @@
+import { ACPAgent, type ACPAgentProps, type ACPAgentSourceFile } from "../acp-agent.js";
+import type { RipplingSDK } from "../../../client.js";
+import type { RequestOptions } from "../../../internal/request-options.js";
+import type { SessionCreateParams, SessionListParams, SessionCreateResponse, SessionListResponse, SessionListResponsesPageCursorURL } from "../../../resources/agents/sessions/sessions.js";
+import type { AgentRetrieveResponse } from "../../../resources/agents/agents.js";
+import type { APIPromise } from "../../../core/api-promise.js";
+import type { PagePromise } from "../../../core/pagination.js";
+export type DefinedAgentProps = {
+    apiName: `${string}__c`;
+} & ((ACPAgentProps & {
+    source?: never;
+}) | (Omit<ACPAgentProps, 'files' | 'entrypoint'> & {
+    source: URL;
+    files?: never;
+    entrypoint?: never;
+}));
+/** Authenticated agent resources supplied per call. */
+export interface AgentOperationsContext {
+    readonly agents: {
+        readonly retrieve: RipplingSDK['agents']['retrieve'];
+        readonly sessions: Pick<RipplingSDK['agents']['sessions'], 'create' | 'list'>;
+    };
+}
+export interface AgentSessions {
+    create(ctx: AgentOperationsContext, params: Omit<SessionCreateParams, 'agent_id'>, options?: RequestOptions): APIPromise<SessionCreateResponse>;
+    list(ctx: AgentOperationsContext, params?: SessionListParams, options?: RequestOptions): PagePromise<SessionListResponsesPageCursorURL, SessionListResponse>;
+}
+export interface AgentOperations {
+    retrieve(ctx: AgentOperationsContext, options?: RequestOptions): APIPromise<AgentRetrieveResponse>;
+    sessions: AgentSessions;
+}
+export interface AgentClient {
+    retrieve(options?: RequestOptions): APIPromise<AgentRetrieveResponse>;
+    sessions: {
+        create(params: Omit<SessionCreateParams, 'agent_id'>, options?: RequestOptions): APIPromise<SessionCreateResponse>;
+        list(params?: SessionListParams, options?: RequestOptions): PagePromise<SessionListResponsesPageCursorURL, SessionListResponse>;
+    };
+}
+export declare function defineAgent(props: DefinedAgentProps): DefinedAgent;
+export declare class DefinedAgent extends ACPAgent {
+    private _source;
+    readonly retrieve: (ctx: AgentOperationsContext, options?: RequestOptions) => APIPromise<AgentRetrieveResponse>;
+    readonly sessions: AgentSessions;
+    constructor(props: DefinedAgentProps);
+    get source(): URL | undefined;
+    /** Replaces inline files or a file-backed source with the supplied files and entrypoint. */
+    setSource(files: ACPAgentSourceFile[], entrypoint: string): this;
+}
+/** @internal Forward client helpers to the definition operations. */
+export declare function createAgentClient(ctx: AgentOperationsContext, definition: ACPAgent): AgentClient;
+//# sourceMappingURL=agent.d.ts.map

package/lib/manifest/definitions/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/agent.ts"],"names":[],"mappings":"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"}

package/lib/manifest/definitions/agent.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefinedAgent = void 0;
+exports.defineAgent = defineAgent;
+exports.createAgentClient = createAgentClient;
+const acp_agent_1 = require("../acp-agent.js");
+const component_1 = require("./component.js");
+function defineAgent(props) {
+    if (props.source !== undefined && (props.files !== undefined || props.entrypoint !== undefined))
+        throw new Error('Define an agent with either source or files/entrypoint, not both.');
+    return agentComponent.register(new DefinedAgent(props), props);
+}
+class DefinedAgent extends acp_agent_1.ACPAgent {
+    constructor(props) {
+        (0, component_1.validateCustomApiName)(props.apiName);
+        if (props.source !== undefined && props.source.protocol !== 'file:')
+            throw new Error('Component source must be a file URL.');
+        super(component_1.detachedManifestScope, props.source !== undefined ? { ...props, files: [], entrypoint: 'index.ts' } : props);
+        this._source = props.source === undefined ? undefined : new URL(props.source.href);
+        const operations = createAgentOperations(this);
+        this.retrieve = operations.retrieve;
+        this.sessions = operations.sessions;
+    }
+    get source() {
+        return this._source;
+    }
+    /** Replaces inline files or a file-backed source with the supplied files and entrypoint. */
+    setSource(files, entrypoint) {
+        super.setSource(files, entrypoint);
+        this._source = undefined;
+        return this;
+    }
+}
+exports.DefinedAgent = DefinedAgent;
+/** @internal Shared with the legacy client helper, including constructor-based agent references. */
+function createAgentOperations(definition) {
+    return {
+        retrieve: (ctx, options) => ctx.agents.retrieve(definition.getApiName(), options),
+        sessions: {
+            create: (ctx, params, options) => ctx.agents.sessions.create({ ...params, agent_id: definition.getApiName() }, options),
+            list: (ctx, params, options) => ctx.agents.sessions.list(definition.getApiName(), params, options),
+        },
+    };
+}
+const agentComponent = (0, component_1.defineComponent)({
+    type: 'ACP_AGENT',
+    define: defineAgent,
+    serialize: (definition) => (0, component_1.sourceEntry)(definition.toDict(), definition.source, (config, content) => ({
+        ...config,
+        files: [{ type: 'ACP_AGENT', path: 'index.ts', content, kind: 'typescript' }],
+        entrypoint: 'index.ts',
+    })),
+});
+/** @internal Forward client helpers to the definition operations. */
+function createAgentClient(ctx, definition) {
+    const operations = createAgentOperations(definition);
+    return {
+        retrieve: (options) => operations.retrieve(ctx, options),
+        sessions: {
+            create: (params, options) => operations.sessions.create(ctx, params, options),
+            list: (params, options) => operations.sessions.list(ctx, params, options),
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map

package/lib/manifest/definitions/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/agent.ts"],"names":[],"mappings":"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"}

package/lib/manifest/definitions/agent.mjs

@@ -0,0 +1,59 @@
+import { ACPAgent } from "../acp-agent.mjs";
+import { detachedManifestScope, defineComponent, sourceEntry, validateCustomApiName } from "./component.mjs";
+export function defineAgent(props) {
+    if (props.source !== undefined && (props.files !== undefined || props.entrypoint !== undefined))
+        throw new Error('Define an agent with either source or files/entrypoint, not both.');
+    return agentComponent.register(new DefinedAgent(props), props);
+}
+export class DefinedAgent extends ACPAgent {
+    constructor(props) {
+        validateCustomApiName(props.apiName);
+        if (props.source !== undefined && props.source.protocol !== 'file:')
+            throw new Error('Component source must be a file URL.');
+        super(detachedManifestScope, props.source !== undefined ? { ...props, files: [], entrypoint: 'index.ts' } : props);
+        this._source = props.source === undefined ? undefined : new URL(props.source.href);
+        const operations = createAgentOperations(this);
+        this.retrieve = operations.retrieve;
+        this.sessions = operations.sessions;
+    }
+    get source() {
+        return this._source;
+    }
+    /** Replaces inline files or a file-backed source with the supplied files and entrypoint. */
+    setSource(files, entrypoint) {
+        super.setSource(files, entrypoint);
+        this._source = undefined;
+        return this;
+    }
+}
+/** @internal Shared with the legacy client helper, including constructor-based agent references. */
+function createAgentOperations(definition) {
+    return {
+        retrieve: (ctx, options) => ctx.agents.retrieve(definition.getApiName(), options),
+        sessions: {
+            create: (ctx, params, options) => ctx.agents.sessions.create({ ...params, agent_id: definition.getApiName() }, options),
+            list: (ctx, params, options) => ctx.agents.sessions.list(definition.getApiName(), params, options),
+        },
+    };
+}
+const agentComponent = defineComponent({
+    type: 'ACP_AGENT',
+    define: defineAgent,
+    serialize: (definition) => sourceEntry(definition.toDict(), definition.source, (config, content) => ({
+        ...config,
+        files: [{ type: 'ACP_AGENT', path: 'index.ts', content, kind: 'typescript' }],
+        entrypoint: 'index.ts',
+    })),
+});
+/** @internal Forward client helpers to the definition operations. */
+export function createAgentClient(ctx, definition) {
+    const operations = createAgentOperations(definition);
+    return {
+        retrieve: (options) => operations.retrieve(ctx, options),
+        sessions: {
+            create: (params, options) => operations.sessions.create(ctx, params, options),
+            list: (params, options) => operations.sessions.list(ctx, params, options),
+        },
+    };
+}
+//# sourceMappingURL=agent.mjs.map

package/lib/manifest/definitions/agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.mjs","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/agent.ts"],"names":[],"mappings":"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"}

package/lib/manifest/definitions/app.d.mts

@@ -0,0 +1,3 @@
+import { App, type AppProps } from "../app.mjs";
+export declare function defineApp(props: AppProps): App;
+//# sourceMappingURL=app.d.mts.map

package/lib/manifest/definitions/app.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.mts","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,mBAAe;AAE5C,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAE9C"}

package/lib/manifest/definitions/app.d.ts

@@ -0,0 +1,3 @@
+import { App, type AppProps } from "../app.js";
+export declare function defineApp(props: AppProps): App;
+//# sourceMappingURL=app.d.ts.map

package/lib/manifest/definitions/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,kBAAe;AAE5C,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAE9C"}

package/lib/manifest/definitions/app.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineApp = defineApp;
+const component_1 = require("./component.js");
+const app_1 = require("../app.js");
+function defineApp(props) {
+    return appComponent.register(new app_1.App(component_1.detachedManifestScope, props), props);
+}
+const appComponent = (0, component_1.defineComponent)({
+    type: 'CUSTOM_APP',
+    define: defineApp,
+    references: (_definition, props) => props.pages,
+});
+//# sourceMappingURL=app.js.map

package/lib/manifest/definitions/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/app.ts"],"names":[],"mappings":";;AAGA,8BAEC;AALD,8CAA+F;AAC/F,mCAA4C;AAE5C,SAAgB,SAAS,CAAC,KAAe;IACvC,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,SAAG,CAAC,iCAAqB,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,YAAY,GAA0C,IAAA,2BAAe,EAAC;IAC1E,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK;CAChD,CAAC,CAAC"}

package/lib/manifest/definitions/app.mjs

@@ -0,0 +1,11 @@
+import { defineComponent, detachedManifestScope } from "./component.mjs";
+import { App } from "../app.mjs";
+export function defineApp(props) {
+    return appComponent.register(new App(detachedManifestScope, props), props);
+}
+const appComponent = defineComponent({
+    type: 'CUSTOM_APP',
+    define: defineApp,
+    references: (_definition, props) => props.pages,
+});
+//# sourceMappingURL=app.mjs.map

package/lib/manifest/definitions/app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.mjs","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAA4B,wBAAoB;AAC/F,OAAO,EAAE,GAAG,EAAiB,mBAAe;AAE5C,MAAM,UAAU,SAAS,CAAC,KAAe;IACvC,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,qBAAqB,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,YAAY,GAA0C,eAAe,CAAC;IAC1E,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK;CAChD,CAAC,CAAC"}

package/lib/manifest/definitions/category.d.mts

@@ -0,0 +1,9 @@
+import type { CustomObjectCategoryDefinition } from "../../../core/platform/custom-objects/category.mjs";
+import { Category, type CategoryProps } from "../category.mjs";
+export type DefineCustomObjectCategoryProps<TApiName extends `${string}__c` = `${string}__c`> = CategoryProps & {
+    apiName: TApiName;
+};
+export declare function defineCategory<const TApiName extends `${string}__c`>(props: DefineCustomObjectCategoryProps<TApiName>): Category & CustomObjectCategoryDefinition<TApiName extends `${infer N}__c` ? N : never>;
+export declare const defineCustomObjectCategory: typeof defineCategory;
+export declare const categoryComponent: import("./component.mjs").ComponentDefinition<typeof defineCategory>;
+//# sourceMappingURL=category.d.mts.map

package/lib/manifest/definitions/category.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.d.mts","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/category.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,2DAAuD;AACrG,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,wBAAoB;AAG3D,MAAM,MAAM,+BAA+B,CAAC,QAAQ,SAAS,GAAG,MAAM,KAAK,GAAG,GAAG,MAAM,KAAK,IAC1F,aAAa,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;AAExC,wBAAgB,cAAc,CAAC,KAAK,CAAC,QAAQ,SAAS,GAAG,MAAM,KAAK,EAClE,KAAK,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GAC/C,QAAQ,GAAG,8BAA8B,CAAC,QAAQ,SAAS,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;AAc3F,eAAO,MAAM,0BAA0B,uBAAiB,CAAC;AAEzD,eAAO,MAAM,iBAAiB,sEAS5B,CAAC"}

package/lib/manifest/definitions/category.d.ts

@@ -0,0 +1,9 @@
+import type { CustomObjectCategoryDefinition } from "../../../core/platform/custom-objects/category.js";
+import { Category, type CategoryProps } from "../category.js";
+export type DefineCustomObjectCategoryProps<TApiName extends `${string}__c` = `${string}__c`> = CategoryProps & {
+    apiName: TApiName;
+};
+export declare function defineCategory<const TApiName extends `${string}__c`>(props: DefineCustomObjectCategoryProps<TApiName>): Category & CustomObjectCategoryDefinition<TApiName extends `${infer N}__c` ? N : never>;
+export declare const defineCustomObjectCategory: typeof defineCategory;
+export declare const categoryComponent: import("./component.js").ComponentDefinition<typeof defineCategory>;
+//# sourceMappingURL=category.d.ts.map

package/lib/manifest/definitions/category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.d.ts","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/category.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,0DAAuD;AACrG,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,uBAAoB;AAG3D,MAAM,MAAM,+BAA+B,CAAC,QAAQ,SAAS,GAAG,MAAM,KAAK,GAAG,GAAG,MAAM,KAAK,IAC1F,aAAa,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;AAExC,wBAAgB,cAAc,CAAC,KAAK,CAAC,QAAQ,SAAS,GAAG,MAAM,KAAK,EAClE,KAAK,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GAC/C,QAAQ,GAAG,8BAA8B,CAAC,QAAQ,SAAS,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;AAc3F,eAAO,MAAM,0BAA0B,uBAAiB,CAAC;AAEzD,eAAO,MAAM,iBAAiB,qEAS5B,CAAC"}

package/lib/manifest/definitions/category.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categoryComponent = exports.defineCustomObjectCategory = void 0;
+exports.defineCategory = defineCategory;
+const category_1 = require("../category.js");
+const component_1 = require("./component.js");
+function defineCategory(props) {
+    (0, component_1.validateCustomApiName)(props.apiName);
+    return exports.categoryComponent.register(Object.assign(new category_1.Category(component_1.detachedManifestScope, props), {
+        apiName: props.apiName,
+        name: props.apiName.replace(/__c$/, ''),
+        displayName: props.name,
+        description: props.description,
+    }), props);
+}
+exports.defineCustomObjectCategory = defineCategory;
+exports.categoryComponent = (0, component_1.defineComponent)({
+    type: 'CUSTOM_CATEGORY',
+    define: defineCategory,
+    serialize: (definition) => ({
+        type: 'CUSTOM_CATEGORY',
+        api_name: definition.apiName,
+        name: definition.displayName,
+        description: definition.description ?? '',
+    }),
+});
+//# sourceMappingURL=category.js.map

package/lib/manifest/definitions/category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.js","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/category.ts"],"names":[],"mappings":";;;AAUA,wCAWC;AApBD,6CAA2D;AAC3D,8CAA4F;AAQ5F,SAAgB,cAAc,CAAC,KAAoB;IACjD,IAAA,iCAAqB,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,yBAAiB,CAAC,QAAQ,CAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,mBAAQ,CAAC,iCAAqB,EAAE,KAAK,CAAC,EAAE;QACxD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,WAAW,EAAE,KAAK,CAAC,IAAI;QACvB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,EACF,KAAK,CACN,CAAC;AACJ,CAAC;AAEY,QAAA,0BAA0B,GAAG,cAAc,CAAC;AAE5C,QAAA,iBAAiB,GAAG,IAAA,2BAAe,EAAC;IAC/C,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,UAAU,CAAC,OAAO;QAC5B,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,EAAE;KAC1C,CAAC;CACH,CAAC,CAAC"}

package/lib/manifest/definitions/category.mjs

@@ -0,0 +1,23 @@
+import { Category } from "../category.mjs";
+import { detachedManifestScope, defineComponent, validateCustomApiName } from "./component.mjs";
+export function defineCategory(props) {
+    validateCustomApiName(props.apiName);
+    return categoryComponent.register(Object.assign(new Category(detachedManifestScope, props), {
+        apiName: props.apiName,
+        name: props.apiName.replace(/__c$/, ''),
+        displayName: props.name,
+        description: props.description,
+    }), props);
+}
+export const defineCustomObjectCategory = defineCategory;
+export const categoryComponent = defineComponent({
+    type: 'CUSTOM_CATEGORY',
+    define: defineCategory,
+    serialize: (definition) => ({
+        type: 'CUSTOM_CATEGORY',
+        api_name: definition.apiName,
+        name: definition.displayName,
+        description: definition.description ?? '',
+    }),
+});
+//# sourceMappingURL=category.mjs.map

package/lib/manifest/definitions/category.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.mjs","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/category.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAsB,wBAAoB;AAC3D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,wBAAoB;AAQ5F,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,iBAAiB,CAAC,QAAQ,CAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,qBAAqB,EAAE,KAAK,CAAC,EAAE;QACxD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,WAAW,EAAE,KAAK,CAAC,IAAI;QACvB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,EACF,KAAK,CACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;IAC/C,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,UAAU,CAAC,OAAO;QAC5B,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,EAAE;KAC1C,CAAC;CACH,CAAC,CAAC"}

package/lib/manifest/definitions/component.d.mts

@@ -0,0 +1,101 @@
+import type { ManifestComponentType, ManifestScope, ManifestComponent } from "../manifest-builder.mjs";
+export type ComponentType = ManifestComponentType | 'CUSTOM_OBJECT_SETTINGS' | 'CUSTOM_OBJECT_SEARCH_CONFIG';
+/** New definitions compose explicitly; legacy constructors still register through their original scopes. */
+export declare const detachedManifestScope: ManifestScope;
+/** Shared by components whose backend writers require the custom API-name suffix. */
+export declare function validateCustomApiName(apiName: string): void;
+/** Decorate only a newly created instance; the existing class and serializer stay unchanged. */
+export declare function withApiName<D extends ManifestComponent>(definition: D, apiName: string, extra?: Record<string, unknown>): D & {
+    getApiName: () => string;
+    toDict: () => {
+        api_name: string;
+        identity_format_version: 2;
+    };
+};
+/** Identifying fields belong to the component's serialized metadata. */
+export type MetadataConfig = {
+    readonly type: Exclude<ComponentType, 'CUSTOM_OBJECT_FIELD' | 'CUSTOM_OBJECT_FIELD_SECTION' | 'CUSTOM_OBJECT_ACTION' | 'CUSTOM_OBJECT_LIST_VIEW' | 'CUSTOM_OBJECT_PAGE_LAYOUT' | 'CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW' | 'CUSTOM_OBJECT_VALIDATION_RULE' | 'CUSTOM_FIELD_SECTION' | 'CUSTOM_FIELD_V2' | 'CUSTOM_OBJECT_SETTINGS' | 'CUSTOM_OBJECT_SEARCH_CONFIG'>;
+    readonly api_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_FIELD';
+    readonly custom_object_api_name: string;
+    readonly field_api_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_FIELD_SECTION';
+    readonly api_name: string;
+    readonly model_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_ACTION' | 'CUSTOM_OBJECT_LIST_VIEW' | 'CUSTOM_OBJECT_PAGE_LAYOUT';
+    readonly api_name: string;
+    readonly object_rql_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW' | 'CUSTOM_OBJECT_VALIDATION_RULE' | 'CUSTOM_FIELD_SECTION' | 'CUSTOM_FIELD_V2';
+    readonly api_name: string;
+    readonly model_rql_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_SETTINGS';
+    readonly object_rql_name: string;
+    readonly setting_id: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_SEARCH_CONFIG';
+    readonly model_rql_name: string;
+};
+export interface BuildContext {
+    bundle(entrypoint: URL): Promise<string>;
+}
+export interface MetadataEntry<W extends MetadataConfig = MetadataConfig> {
+    readonly config: W;
+    /** Generated defaults yield to authored metadata with the same type, parent, and API name. */
+    readonly fallback?: boolean;
+    readonly buildKey?: string;
+    readonly build?: (context: BuildContext) => Promise<W>;
+}
+export interface CompileContext {
+    readonly definitions: readonly object[];
+}
+type DefinitionFactory = (...args: never[]) => object;
+interface ComponentFactory<F extends DefinitionFactory> {
+    /** Wire kind used to register this adapter; does not register an API endpoint. */
+    readonly type: ComponentType;
+    /** Creates the public definition. The wrapper registers the result without adding public properties. */
+    readonly define: F;
+    /**
+     * Receives the factory result and its original arguments. Return fixed references
+     * or a callback that reads current dependencies when setters can change them.
+     */
+    references?(definition: ReturnType<F>, ...args: Parameters<F>): readonly object[] | (() => readonly object[]);
+}
+/** Use a single-definition serializer normally; batch compilers handle schema expansion and merging. */
+export type ComponentImplementation<F extends DefinitionFactory, W extends MetadataConfig> = ComponentFactory<F> & ({
+    serialize(definition: ReturnType<F>): W | MetadataEntry<W>;
+    compileBatch?: never;
+} | {
+    serialize?: never;
+    compileBatch(definitions: readonly ReturnType<F>[], context: CompileContext): readonly (W | MetadataEntry<W>)[];
+} | (ReturnType<F> extends ManifestComponent ? {
+    serialize?: never;
+    compileBatch?: never;
+} : never));
+/** Keep public declarations compact without expanding generic factories into their field unions. */
+export interface ComponentDefinition<F extends DefinitionFactory> {
+    readonly define: F;
+    /** @internal Register a constructed value, preserving its concrete generic type. */
+    register<D extends object>(definition: D, ...args: unknown[]): D;
+}
+interface RegisteredComponent {
+    readonly type: ComponentType;
+    references(): readonly object[];
+    readonly implementation: {
+        readonly batchKey: object;
+        compileBatch(definitions: readonly object[], context: CompileContext): readonly (MetadataConfig | MetadataEntry)[];
+    };
+}
+export declare function registeredComponent(definition: object): RegisteredComponent | undefined;
+/** Retains the exact factory signature, including its generic type parameters. */
+export declare function defineComponent<F extends DefinitionFactory, W extends MetadataConfig = MetadataConfig>(implementation: ComponentImplementation<F, W>): ComponentDefinition<F>;
+/** Mirror backend identity and installation-map scopes, using wire fields rather than source IDs. */
+export declare function entryKey({ config }: MetadataEntry): string;
+/** Shared source-build plumbing; each component supplies its own wire format. */
+export declare function sourceEntry<W extends MetadataConfig>(metadata: W, source: URL | undefined, build: (config: W, content: string) => W): MetadataEntry<W>;
+export {};
+//# sourceMappingURL=component.d.mts.map

package/lib/manifest/definitions/component.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.mts","sourceRoot":"","sources":["../../../src/lib/manifest/definitions/component.ts"],"names":[],"mappings":"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"}

package/lib/manifest/definitions/component.d.ts

@@ -0,0 +1,101 @@
+import type { ManifestComponentType, ManifestScope, ManifestComponent } from "../manifest-builder.js";
+export type ComponentType = ManifestComponentType | 'CUSTOM_OBJECT_SETTINGS' | 'CUSTOM_OBJECT_SEARCH_CONFIG';
+/** New definitions compose explicitly; legacy constructors still register through their original scopes. */
+export declare const detachedManifestScope: ManifestScope;
+/** Shared by components whose backend writers require the custom API-name suffix. */
+export declare function validateCustomApiName(apiName: string): void;
+/** Decorate only a newly created instance; the existing class and serializer stay unchanged. */
+export declare function withApiName<D extends ManifestComponent>(definition: D, apiName: string, extra?: Record<string, unknown>): D & {
+    getApiName: () => string;
+    toDict: () => {
+        api_name: string;
+        identity_format_version: 2;
+    };
+};
+/** Identifying fields belong to the component's serialized metadata. */
+export type MetadataConfig = {
+    readonly type: Exclude<ComponentType, 'CUSTOM_OBJECT_FIELD' | 'CUSTOM_OBJECT_FIELD_SECTION' | 'CUSTOM_OBJECT_ACTION' | 'CUSTOM_OBJECT_LIST_VIEW' | 'CUSTOM_OBJECT_PAGE_LAYOUT' | 'CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW' | 'CUSTOM_OBJECT_VALIDATION_RULE' | 'CUSTOM_FIELD_SECTION' | 'CUSTOM_FIELD_V2' | 'CUSTOM_OBJECT_SETTINGS' | 'CUSTOM_OBJECT_SEARCH_CONFIG'>;
+    readonly api_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_FIELD';
+    readonly custom_object_api_name: string;
+    readonly field_api_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_FIELD_SECTION';
+    readonly api_name: string;
+    readonly model_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_ACTION' | 'CUSTOM_OBJECT_LIST_VIEW' | 'CUSTOM_OBJECT_PAGE_LAYOUT';
+    readonly api_name: string;
+    readonly object_rql_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW' | 'CUSTOM_OBJECT_VALIDATION_RULE' | 'CUSTOM_FIELD_SECTION' | 'CUSTOM_FIELD_V2';
+    readonly api_name: string;
+    readonly model_rql_name: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_SETTINGS';
+    readonly object_rql_name: string;
+    readonly setting_id: string;
+} | {
+    readonly type: 'CUSTOM_OBJECT_SEARCH_CONFIG';
+    readonly model_rql_name: string;
+};
+export interface BuildContext {
+    bundle(entrypoint: URL): Promise<string>;
+}
+export interface MetadataEntry<W extends MetadataConfig = MetadataConfig> {
+    readonly config: W;
+    /** Generated defaults yield to authored metadata with the same type, parent, and API name. */
+    readonly fallback?: boolean;
+    readonly buildKey?: string;
+    readonly build?: (context: BuildContext) => Promise<W>;
+}
+export interface CompileContext {
+    readonly definitions: readonly object[];
+}
+type DefinitionFactory = (...args: never[]) => object;
+interface ComponentFactory<F extends DefinitionFactory> {
+    /** Wire kind used to register this adapter; does not register an API endpoint. */
+    readonly type: ComponentType;
+    /** Creates the public definition. The wrapper registers the result without adding public properties. */
+    readonly define: F;
+    /**
+     * Receives the factory result and its original arguments. Return fixed references
+     * or a callback that reads current dependencies when setters can change them.
+     */
+    references?(definition: ReturnType<F>, ...args: Parameters<F>): readonly object[] | (() => readonly object[]);
+}
+/** Use a single-definition serializer normally; batch compilers handle schema expansion and merging. */
+export type ComponentImplementation<F extends DefinitionFactory, W extends MetadataConfig> = ComponentFactory<F> & ({
+    serialize(definition: ReturnType<F>): W | MetadataEntry<W>;
+    compileBatch?: never;
+} | {
+    serialize?: never;
+    compileBatch(definitions: readonly ReturnType<F>[], context: CompileContext): readonly (W | MetadataEntry<W>)[];
+} | (ReturnType<F> extends ManifestComponent ? {
+    serialize?: never;
+    compileBatch?: never;
+} : never));
+/** Keep public declarations compact without expanding generic factories into their field unions. */
+export interface ComponentDefinition<F extends DefinitionFactory> {
+    readonly define: F;
+    /** @internal Register a constructed value, preserving its concrete generic type. */
+    register<D extends object>(definition: D, ...args: unknown[]): D;
+}
+interface RegisteredComponent {
+    readonly type: ComponentType;
+    references(): readonly object[];
+    readonly implementation: {
+        readonly batchKey: object;
+        compileBatch(definitions: readonly object[], context: CompileContext): readonly (MetadataConfig | MetadataEntry)[];
+    };
+}
+export declare function registeredComponent(definition: object): RegisteredComponent | undefined;
+/** Retains the exact factory signature, including its generic type parameters. */
+export declare function defineComponent<F extends DefinitionFactory, W extends MetadataConfig = MetadataConfig>(implementation: ComponentImplementation<F, W>): ComponentDefinition<F>;
+/** Mirror backend identity and installation-map scopes, using wire fields rather than source IDs. */
+export declare function entryKey({ config }: MetadataEntry): string;
+/** Shared source-build plumbing; each component supplies its own wire format. */
+export declare function sourceEntry<W extends MetadataConfig>(metadata: W, source: URL | undefined, build: (config: W, content: string) => W): MetadataEntry<W>;
+export {};
+//# sourceMappingURL=component.d.ts.map