@fabriktor/fx 0.0.38 → 0.0.40

package/dist/src/feed/feed.d.ts

@@ -1,10 +1,17 @@
-import { type FeedObject, type FeedPost, type OperationResult, type RPFeedPull } from "@fabriktor/schema";
+import { type FeedFavorite, type FeedObject, type FeedPost, type FeedReaction, type OperationResult, type RPFeedPull } from "@fabriktor/schema";
 import type { FeedOperator, OperationResultOf, StorageUploadFile } from "@fabriktor/client";
 import { type PullSession, type PullSessionErrorHandler } from "../core/pull.js";
+import { type SearchPage } from "../core/search.js";
 import { type StorageFXOperator, type StoragePersonalBoxUploadResult } from "../storage/storage.js";
 type FeedPullOptions = Parameters<FeedOperator["pull"]>[0];
-type FeedPostInsert = Parameters<FeedOperator["insertOneFeedPost"]>[0]["in"];
-type FeedReactionInsert = Parameters<FeedOperator["insertOneFeedReaction"]>[0]["in"];
+type FeedPostInsertOptions = Parameters<FeedOperator["insertOneFeedPost"]>[0];
+type FeedPostReplaceOptions = Parameters<FeedOperator["replaceOneFeedPost"]>[0];
+type FeedReactionInsertOptions = Parameters<FeedOperator["insertOneFeedReaction"]>[0];
+type FeedReactionReplaceOptions = Parameters<FeedOperator["replaceOneFeedReaction"]>[0];
+type FeedFavoriteInsertOptions = Parameters<FeedOperator["insertOneFeedFavorite"]>[0];
+type FeedFavoriteReplaceOptions = Parameters<FeedOperator["replaceOneFeedFavorite"]>[0];
+type FeedPostInsert = FeedPostInsertOptions["in"];
+type FeedReactionInsert = FeedReactionInsertOptions["in"];
 export declare const FeedAction: {
     readonly Reaction: "reaction";
     readonly Favorite: "favorite";
@@ -23,6 +30,18 @@ export declare const FeedMediaPostStatus: {
 };
 export type FeedMediaPostStatus = (typeof FeedMediaPostStatus)[keyof typeof FeedMediaPostStatus];
 export type FeedReactionType = FeedReactionInsert["reaction_type"];
+export type CreateFeedPostOptions = FeedPostInsertOptions;
+export type ReplaceFeedPostOptions = FeedPostReplaceOptions;
+export type CreateFeedReactionOptions = FeedReactionInsertOptions;
+export type ReplaceFeedReactionOptions = FeedReactionReplaceOptions;
+export type CreateFeedFavoriteOptions = FeedFavoriteInsertOptions;
+export type ReplaceFeedFavoriteOptions = FeedFavoriteReplaceOptions;
+export type SearchFeedPostsOptions = {
+    q?: string;
+    page?: number;
+    per_page?: number;
+};
+export type SearchFeedPostsPage = SearchPage<FeedPost>;
 export type FeedPullContext = Pick<FeedPullOptions, "contact_ids" | "pull_type" | "entity_id" | "research">;
 export type FeedTextPostContent = Pick<FeedPostInsert, "text">;
 export type FeedMediaPostInput = Pick<FeedPostInsert, "text" | "visibility">;
@@ -117,6 +136,13 @@ export type CreateFeedPostWithMediaResult = {
     error: unknown;
 };
 export interface FeedFXOperator {
+    createFeedPost(opts: CreateFeedPostOptions): Promise<FeedPost>;
+    replaceFeedPost(opts: ReplaceFeedPostOptions): Promise<FeedPost>;
+    searchFeedPosts(opts: SearchFeedPostsOptions): Promise<SearchFeedPostsPage>;
+    createFeedReaction(opts: CreateFeedReactionOptions): Promise<FeedReaction>;
+    replaceFeedReaction(opts: ReplaceFeedReactionOptions): Promise<FeedReaction>;
+    createFeedFavorite(opts: CreateFeedFavoriteOptions): Promise<FeedFavorite>;
+    replaceFeedFavorite(opts: ReplaceFeedFavoriteOptions): Promise<FeedFavorite>;
     startSession(opts: StartFeedSessionOptions): Promise<FeedSession>;
     addReaction(opts: AddFeedReactionOptions): Promise<OperationResult>;
     removeReaction(opts: RemoveFeedReactionOptions): Promise<OperationResult>;
@@ -139,6 +165,13 @@ export declare class FeedFX implements FeedFXOperator {
     private removed_actions;
     private action_ids;
     constructor(opts: FeedFXOptions);
+    createFeedPost(opts: CreateFeedPostOptions): Promise<FeedPost>;
+    replaceFeedPost(opts: ReplaceFeedPostOptions): Promise<FeedPost>;
+    searchFeedPosts(opts: SearchFeedPostsOptions): Promise<SearchFeedPostsPage>;
+    createFeedReaction(opts: CreateFeedReactionOptions): Promise<FeedReaction>;
+    replaceFeedReaction(opts: ReplaceFeedReactionOptions): Promise<FeedReaction>;
+    createFeedFavorite(opts: CreateFeedFavoriteOptions): Promise<FeedFavorite>;
+    replaceFeedFavorite(opts: ReplaceFeedFavoriteOptions): Promise<FeedFavorite>;
     startSession(opts: StartFeedSessionOptions): Promise<FeedSession>;
     addReaction(opts: AddFeedReactionOptions): Promise<OperationResult>;
     removeReaction(opts: RemoveFeedReactionOptions): Promise<OperationResult>;
@@ -152,6 +185,9 @@ export declare class FeedFX implements FeedFXOperator {
     createReplyWithMedia(opts: CreateFeedReplyWithMediaOptions): Promise<CreateFeedPostWithMediaResult>;
     createReferenceWithMedia(opts: CreateFeedReferenceWithMediaOptions): Promise<CreateFeedPostWithMediaResult>;
     private createMediaPost;
+    private findFeedPost;
+    private findFeedReaction;
+    private findFeedFavorite;
     private runAction;
     private hasAction;
     private actionID;

package/dist/src/feed/feed.js

@@ -5,11 +5,16 @@
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
 import { All, ColStorageFeed, PullTypeKeepAlive, ZeroID, } from "@fabriktor/schema";
 import { errResolveFailed, errValidation } from "../core/err.js";
+import { requiredOperationID, resolvedID } from "../core/id.js";
 import { newPullSession, } from "../core/pull.js";
+import { runSearch } from "../core/search.js";
 import { StorageUploadModeration, } from "../storage/storage.js";
 const newFeedSessionToken = "";
 const resourceFeedSessionToken = "feed_session_token";
 const resourceFeedPostID = "feed_post_id";
+const resourceFeedPost = "feed_post";
+const resourceFeedReaction = "feed_reaction";
+const resourceFeedFavorite = "feed_favorite";
 const resourceFeedObject = "feed_object";
 const msgKeepAliveIntervalInvalid = "Keep-alive interval must be a finite number greater than zero.";
 const msgFeedSessionClosed = "Feed session is closed.";
@@ -17,6 +22,11 @@ const msgFeedPullInProgress = "A feed pull is already in progress.";
 const msgFeedSessionTokenMissing = "Feed pull response did not contain a session token.";
 const msgFeedPostIDMissing = "Feed post does not contain an ID.";
 const msgFeedCreatedPostIDMissing = "Created feed post response did not contain an ID.";
+const msgFeedPostMissing = "Feed post could not be resolved after the mutation.";
+const msgCreatedFeedReactionIDMissing = "Created feed reaction response did not contain an ID.";
+const msgFeedReactionResolveMissing = "Feed reaction could not be resolved after the mutation.";
+const msgCreatedFeedFavoriteIDMissing = "Created feed favorite response did not contain an ID.";
+const msgFeedFavoriteResolveMissing = "Feed favorite could not be resolved after the mutation.";
 const msgFeedActionInProgress = "This feed action is already in progress for the post.";
 const msgFeedReactionAlreadyExists = "A reaction already exists for this post.";
 const msgFeedReactionMissing = "No reaction exists for this post.";
@@ -63,6 +73,42 @@ export class FeedFX {
         this.removed_actions = new Map();
         this.action_ids = new Map();
     }
+    async createFeedPost(opts) {
+        const out = await this.feed.insertOneFeedPost(opts);
+        const id = requiredOperationID(out, msgFeedCreatedPostIDMissing);
+        return await this.findFeedPost(id);
+    }
+    async replaceFeedPost(opts) {
+        await this.feed.replaceOneFeedPost(opts);
+        return await this.findFeedPost(opts.id);
+    }
+    async searchFeedPosts(opts) {
+        return await runSearch({
+            search: (searchOpts) => this.feed.searchManyFeedPosts(searchOpts),
+            query: {},
+            q: opts.q,
+            page: opts.page,
+            per_page: opts.per_page,
+        });
+    }
+    async createFeedReaction(opts) {
+        const out = await this.feed.insertOneFeedReaction(opts);
+        const id = requiredOperationID(out, msgCreatedFeedReactionIDMissing);
+        return await this.findFeedReaction(id);
+    }
+    async replaceFeedReaction(opts) {
+        await this.feed.replaceOneFeedReaction(opts);
+        return await this.findFeedReaction(opts.id);
+    }
+    async createFeedFavorite(opts) {
+        const out = await this.feed.insertOneFeedFavorite(opts);
+        const id = requiredOperationID(out, msgCreatedFeedFavoriteIDMissing);
+        return await this.findFeedFavorite(id);
+    }
+    async replaceFeedFavorite(opts) {
+        await this.feed.replaceOneFeedFavorite(opts);
+        return await this.findFeedFavorite(opts.id);
+    }
     async startSession(opts) {
         const { on_error, ...context } = opts;
         const initial = await this.feed.pull({
@@ -432,6 +478,45 @@ export class FeedFX {
             objects,
         };
     }
+    async findFeedPost(id) {
+        const out = await this.feed.findOneFeedPost({
+            id,
+        });
+        const post = out.value;
+        if (post === undefined) {
+            throw errResolveFailed({
+                resource: resourceFeedPost,
+                msg: msgFeedPostMissing,
+            });
+        }
+        return post;
+    }
+    async findFeedReaction(id) {
+        const out = await this.feed.findOneFeedReaction({
+            id,
+        });
+        const reaction = out.value;
+        if (reaction === undefined) {
+            throw errResolveFailed({
+                resource: resourceFeedReaction,
+                msg: msgFeedReactionResolveMissing,
+            });
+        }
+        return reaction;
+    }
+    async findFeedFavorite(id) {
+        const out = await this.feed.findOneFeedFavorite({
+            id,
+        });
+        const favorite = out.value;
+        if (favorite === undefined) {
+            throw errResolveFailed({
+                resource: resourceFeedFavorite,
+                msg: msgFeedFavoriteResolveMissing,
+            });
+        }
+        return favorite;
+    }
     async runAction(post_id, action, fn) {
         if (this.isActionRunning(post_id, action)) {
             throw errValidation({
@@ -582,13 +667,6 @@ function selfActionID(post, action) {
             return resolvedID(post.self?.reference_id);
     }
 }
-function resolvedID(v) {
-    const out = resolvedValue(v);
-    if (out === undefined || out === ZeroID) {
-        return undefined;
-    }
-    return out;
-}
 function resolvedValue(v) {
     const out = v?.trim();
     if (out === undefined || out.length === 0) {

package/dist/src/fulfillments/fulfillments.d.ts

@@ -0,0 +1,32 @@
+import type { FulfillmentsOperator } from "@fabriktor/client";
+import { type FulfillOrder } from "@fabriktor/schema";
+import { type SearchPage } from "../core/search.js";
+type FulfillOrderInsertOptions = Parameters<FulfillmentsOperator["insertOneFulfillOrder"]>[0];
+type FulfillOrderReplaceOptions = Parameters<FulfillmentsOperator["replaceOneFulfillOrder"]>[0];
+export type CreateFulfillOrderOptions = FulfillOrderInsertOptions;
+export type ReplaceFulfillOrderOptions = FulfillOrderReplaceOptions;
+export type SearchFulfillOrdersOptions = {
+    owner_id: string;
+    q?: string;
+    page?: number;
+    per_page?: number;
+};
+export type SearchFulfillOrdersPage = SearchPage<FulfillOrder>;
+export type FulfillmentsFXOptions = {
+    fulfillments: FulfillmentsOperator;
+};
+export interface FulfillmentsFXOperator {
+    createFulfillOrder(opts: CreateFulfillOrderOptions): Promise<FulfillOrder>;
+    replaceFulfillOrder(opts: ReplaceFulfillOrderOptions): Promise<FulfillOrder>;
+    searchFulfillOrders(opts: SearchFulfillOrdersOptions): Promise<SearchFulfillOrdersPage>;
+}
+export declare class FulfillmentsFX implements FulfillmentsFXOperator {
+    private fulfillments;
+    constructor(opts: FulfillmentsFXOptions);
+    createFulfillOrder(opts: CreateFulfillOrderOptions): Promise<FulfillOrder>;
+    replaceFulfillOrder(opts: ReplaceFulfillOrderOptions): Promise<FulfillOrder>;
+    searchFulfillOrders(opts: SearchFulfillOrdersOptions): Promise<SearchFulfillOrdersPage>;
+    private findFulfillOrder;
+}
+export declare function newFulfillmentsFX(opts: FulfillmentsFXOptions): FulfillmentsFX;
+export {};

package/dist/src/fulfillments/fulfillments.js

@@ -0,0 +1,54 @@
+// Copyright (C) Fabriktor, Inc. 2025-present.
+//
+// Licensed under the Apache License, Version 2.0 (the "License"); you may
+// not use this file except in compliance with the License. You may obtain
+// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+import { OwnerIDKey } from "@fabriktor/schema";
+import { errResolveFailed } from "../core/err.js";
+import { requiredOperationID } from "../core/id.js";
+import { runSearch } from "../core/search.js";
+const resourceFulfillOrder = "fulfill_order";
+const msgCreatedFulfillOrderIDMissing = "Created fulfill order response did not contain an ID.";
+const msgFulfillOrderMissing = "Fulfill order could not be resolved after the mutation.";
+export class FulfillmentsFX {
+    fulfillments;
+    constructor(opts) {
+        this.fulfillments = opts.fulfillments;
+    }
+    async createFulfillOrder(opts) {
+        const out = await this.fulfillments.insertOneFulfillOrder(opts);
+        const id = requiredOperationID(out, msgCreatedFulfillOrderIDMissing);
+        return await this.findFulfillOrder(id);
+    }
+    async replaceFulfillOrder(opts) {
+        await this.fulfillments.replaceOneFulfillOrder(opts);
+        return await this.findFulfillOrder(opts.id);
+    }
+    async searchFulfillOrders(opts) {
+        return await runSearch({
+            search: (searchOpts) => this.fulfillments.searchManyFulfillOrders(searchOpts),
+            query: {
+                [OwnerIDKey]: opts.owner_id,
+            },
+            q: opts.q,
+            page: opts.page,
+            per_page: opts.per_page,
+        });
+    }
+    async findFulfillOrder(id) {
+        const out = await this.fulfillments.findOneFulfillOrder({
+            id,
+        });
+        const fulfill_order = out.value;
+        if (fulfill_order === undefined) {
+            throw errResolveFailed({
+                resource: resourceFulfillOrder,
+                msg: msgFulfillOrderMissing,
+            });
+        }
+        return fulfill_order;
+    }
+}
+export function newFulfillmentsFX(opts) {
+    return new FulfillmentsFX(opts);
+}

package/dist/src/fx.d.ts

@@ -1,10 +1,11 @@
-import type { BillableOperator, CallsOperator, ChatOperator, ConnectionsOperator, ContactsOperator, FeedOperator, JobsOperator, MarketplaceOperator, MemosOperator, NotificationsOperator, PaymentsOperator, PayrollsOperator, PreferencesOperator, PrivacyOperator, RoutesOperator, StorageOperator, TimesheetsOperator, TmpPhonesOperator, TmpUsernamesOperator, UsersOperator } from "@fabriktor/client";
+import type { BillableOperator, CallsOperator, ChatOperator, ConnectionsOperator, ContactsOperator, FeedOperator, FulfillmentsOperator, JobsOperator, MarketplaceOperator, MemosOperator, NotificationsOperator, PaymentsOperator, PayrollsOperator, PreferencesOperator, PrivacyOperator, RoutesOperator, StorageOperator, TimesheetsOperator, TmpPhonesOperator, TmpUsernamesOperator, UsersOperator } from "@fabriktor/client";
 import type { AuthOperator } from "./auth/auth.js";
 import type { BillableFX, BillableFXOperator } from "./billable/billable.js";
 import type { CallsFX, CallsFXOperator } from "./calls/calls.js";
 import type { ChatFX, ChatFXOperator } from "./chat/chat.js";
 import type { ContactsFX, ContactsFXOperator } from "./contacts/contacts.js";
 import type { FeedFX, FeedFXOperator } from "./feed/feed.js";
+import type { FulfillmentsFX, FulfillmentsFXOperator } from "./fulfillments/fulfillments.js";
 import type { JobsFX, JobsFXOperator } from "./jobs/jobs.js";
 import type { MarketplaceFX, MarketplaceFXOperator } from "./marketplace/marketplace.js";
 import type { MemosFX, MemosFXOperator } from "./memos/memos.js";
@@ -26,6 +27,7 @@ export type FXOptions = {
     connections: ConnectionsOperator;
     contacts: ContactsOperator;
     feed: FeedOperator;
+    fulfillments: FulfillmentsOperator;
     jobs: JobsOperator;
     marketplace: MarketplaceOperator;
     memos: MemosOperator;
@@ -57,6 +59,7 @@ export interface FXOperator {
     chat: ChatFXOperator;
     contacts: ContactsFXOperator;
     feed: FeedFXOperator;
+    fulfillments: FulfillmentsFXOperator;
     jobs: JobsFXOperator;
     marketplace: MarketplaceFXOperator;
     memos: MemosFXOperator;
@@ -77,6 +80,7 @@ export declare class FX implements FXOperator {
     chat: ChatFX;
     contacts: ContactsFX;
     feed: FeedFX;
+    fulfillments: FulfillmentsFX;
     jobs: JobsFX;
     marketplace: MarketplaceFX;
     memos: MemosFX;

package/dist/src/fx.js

@@ -3,12 +3,13 @@
 // Licensed under the Apache License, Version 2.0 (the "License"); you may
 // not use this file except in compliance with the License. You may obtain
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
-import { newBillableClient, newCallsClient, newChatClient, newConnectionsClient, newContactsClient, newFeedClient, newHTTPClient, newJobsClient, newMarketplaceClient, newMemosClient, newNotificationsClient, newPaymentsClient, newPayrollsClient, newPreferencesClient, newPrivacyClient, newRoutesClient, newStorageClient, newTimesheetsClient, newTmpPhonesClient, newTmpUsernamesClient, newUsersClient, } from "@fabriktor/client";
+import { newBillableClient, newCallsClient, newChatClient, newConnectionsClient, newContactsClient, newFeedClient, newFulfillmentsClient, newHTTPClient, newJobsClient, newMarketplaceClient, newMemosClient, newNotificationsClient, newPaymentsClient, newPayrollsClient, newPreferencesClient, newPrivacyClient, newRoutesClient, newStorageClient, newTimesheetsClient, newTmpPhonesClient, newTmpUsernamesClient, newUsersClient, } from "@fabriktor/client";
 import { newBillableFX } from "./billable/billable.js";
 import { newCallsFX } from "./calls/calls.js";
 import { newChatFX } from "./chat/chat.js";
 import { newContactsFX } from "./contacts/contacts.js";
 import { newFeedFX } from "./feed/feed.js";
+import { newFulfillmentsFX } from "./fulfillments/fulfillments.js";
 import { newJobsFX } from "./jobs/jobs.js";
 import { newMarketplaceFX } from "./marketplace/marketplace.js";
 import { newMemosFX } from "./memos/memos.js";
@@ -28,6 +29,7 @@ export class FX {
     chat;
     contacts;
     feed;
+    fulfillments;
     jobs;
     marketplace;
     memos;
@@ -55,6 +57,9 @@ export class FX {
         this.contacts = newContactsFX({
             contacts: opts.contacts,
         });
+        this.fulfillments = newFulfillmentsFX({
+            fulfillments: opts.fulfillments,
+        });
         this.jobs = newJobsFX({
             jobs: opts.jobs,
         });
@@ -146,6 +151,11 @@ export function newDefaultFX(opts) {
             base_url: opts.base_url,
             get_token,
         }),
+        fulfillments: newFulfillmentsClient({
+            http,
+            base_url: opts.base_url,
+            get_token,
+        }),
         jobs: newJobsClient({
             http,
             base_url: opts.base_url,

package/dist/src/index.d.ts

@@ -4,9 +4,11 @@ export * from "./calls/calls.js";
 export * from "./chat/chat.js";
 export * from "./contacts/contacts.js";
 export * from "./core/err.js";
+export * from "./core/id.js";
 export * from "./core/pull.js";
 export * from "./core/search.js";
 export * from "./feed/feed.js";
+export * from "./fulfillments/fulfillments.js";
 export * from "./fx.js";
 export * from "./jobs/jobs.js";
 export * from "./marketplace/marketplace.js";

package/dist/src/index.js

@@ -4,9 +4,11 @@ export * from "./calls/calls.js";
 export * from "./chat/chat.js";
 export * from "./contacts/contacts.js";
 export * from "./core/err.js";
+export * from "./core/id.js";
 export * from "./core/pull.js";
 export * from "./core/search.js";
 export * from "./feed/feed.js";
+export * from "./fulfillments/fulfillments.js";
 export * from "./fx.js";
 export * from "./jobs/jobs.js";
 export * from "./marketplace/marketplace.js";

package/dist/src/jobs/jobs.d.ts

@@ -1,13 +1,34 @@
-import { type Job, type Location, type OperationResult, type RPJobsFindOverlaps } from "@fabriktor/schema";
+import { type Job, type JobProgram, type Location, type OperationResult, type RPJobsFindOverlaps } from "@fabriktor/schema";
 import type { JobsOperator, OperationResultOf } from "@fabriktor/client";
+import { type SearchPage } from "../core/search.js";
 type JobInsert = Parameters<JobsOperator["insertOneJob"]>[0]["in"];
 type JobProgramInsert = Parameters<JobsOperator["insertOneJobProgram"]>[0]["in"];
 type LocationInsert = Parameters<JobsOperator["insertOneLocation"]>[0]["in"];
+type LocationInsertOptions = Parameters<JobsOperator["insertOneLocation"]>[0];
+type LocationReplaceOptions = Parameters<JobsOperator["replaceOneLocation"]>[0];
+type JobProgramReplaceOptions = Parameters<JobsOperator["replaceOneJobProgram"]>[0];
+type JobReplaceOptions = Parameters<JobsOperator["replaceOneJob"]>[0];
+type SearchJobRecordsOptions = {
+    owner_id: string;
+    q?: string;
+    page?: number;
+    per_page?: number;
+};
 export declare const JobProgramCreateMode: {
     readonly Scheduled: "scheduled";
     readonly Immediate: "immediate";
 };
 export type JobProgramCreateMode = (typeof JobProgramCreateMode)[keyof typeof JobProgramCreateMode];
+export type CreateLocationOptions = LocationInsertOptions;
+export type ReplaceLocationOptions = LocationReplaceOptions;
+export type ReplaceJobProgramOptions = JobProgramReplaceOptions;
+export type ReplaceJobOptions = JobReplaceOptions;
+export type SearchLocationsOptions = SearchJobRecordsOptions;
+export type SearchJobProgramsOptions = SearchJobRecordsOptions;
+export type SearchJobsOptions = SearchJobRecordsOptions;
+export type SearchLocationsPage = SearchPage<Location>;
+export type SearchJobProgramsPage = SearchPage<JobProgram>;
+export type SearchJobsPage = SearchPage<Job>;
 export type JobsFXOptions = {
     jobs: JobsOperator;
     now?: () => globalThis.Date;
@@ -24,12 +45,18 @@ export type CreateJobProgramOptions = {
     in: CreateJobProgramInput;
     location: Location;
 };
-export type CreateJobProgramResult = {
+export type CreateLocationJobProgramResult = {
     mode: typeof JobProgramCreateMode.Scheduled;
     create: OperationResult;
 } | {
     mode: typeof JobProgramCreateMode.Immediate;
 };
+export type CreateJobProgramResult = {
+    mode: typeof JobProgramCreateMode.Scheduled;
+    job_program: JobProgram;
+} | {
+    mode: typeof JobProgramCreateMode.Immediate;
+};
 export type FindLocationOverlapsInput = Pick<LocationInsert, "y" | "m" | "d" | "h" | "min" | "tz" | "end_date">;
 export type FindLocationOverlapsOptions = {
     in: FindLocationOverlapsInput;
@@ -52,8 +79,17 @@ export type SetLocationMembersOptions = {
     current_members: string[];
 };
 export interface JobsFXOperator {
-    createJob(opts: CreateJobOptions): Promise<OperationResult>;
+    createLocation(opts: CreateLocationOptions): Promise<Location>;
+    replaceLocation(opts: ReplaceLocationOptions): Promise<Location>;
+    searchLocations(opts: SearchLocationsOptions): Promise<SearchLocationsPage>;
+    replaceJobProgram(opts: ReplaceJobProgramOptions): Promise<JobProgram>;
+    searchJobPrograms(opts: SearchJobProgramsOptions): Promise<SearchJobProgramsPage>;
+    replaceJob(opts: ReplaceJobOptions): Promise<Job>;
+    searchJobs(opts: SearchJobsOptions): Promise<SearchJobsPage>;
+    createJob(opts: CreateJobOptions): Promise<Job>;
+    createLocationJob(opts: CreateJobOptions): Promise<OperationResult>;
     createJobProgram(opts: CreateJobProgramOptions): Promise<CreateJobProgramResult>;
+    createLocationJobProgram(opts: CreateJobProgramOptions): Promise<CreateLocationJobProgramResult>;
     findLocationOverlaps(opts: FindLocationOverlapsOptions): Promise<OperationResultOf<RPJobsFindOverlaps>>;
     addJobForeman(opts: AddJobForemanOptions): Promise<OperationResult>;
     removeJobMember(opts: RemoveJobMemberOptions): Promise<OperationResult>;
@@ -63,12 +99,24 @@ export declare class JobsFX implements JobsFXOperator {
     private jobs;
     private now;
     constructor(opts: JobsFXOptions);
-    createJob(opts: CreateJobOptions): Promise<OperationResult>;
+    createLocation(opts: CreateLocationOptions): Promise<Location>;
+    replaceLocation(opts: ReplaceLocationOptions): Promise<Location>;
+    searchLocations(opts: SearchLocationsOptions): Promise<SearchLocationsPage>;
+    replaceJobProgram(opts: ReplaceJobProgramOptions): Promise<JobProgram>;
+    searchJobPrograms(opts: SearchJobProgramsOptions): Promise<SearchJobProgramsPage>;
+    replaceJob(opts: ReplaceJobOptions): Promise<Job>;
+    searchJobs(opts: SearchJobsOptions): Promise<SearchJobsPage>;
+    createJob(opts: CreateJobOptions): Promise<Job>;
+    createLocationJob(opts: CreateJobOptions): Promise<OperationResult>;
     createJobProgram(opts: CreateJobProgramOptions): Promise<CreateJobProgramResult>;
+    createLocationJobProgram(opts: CreateJobProgramOptions): Promise<CreateLocationJobProgramResult>;
     findLocationOverlaps(opts: FindLocationOverlapsOptions): Promise<OperationResultOf<RPJobsFindOverlaps>>;
     addJobForeman(opts: AddJobForemanOptions): Promise<OperationResult>;
     removeJobMember(opts: RemoveJobMemberOptions): Promise<OperationResult>;
     setLocationMembers(opts: SetLocationMembersOptions): Promise<OperationResult>;
+    private findLocation;
+    private findJobProgram;
+    private findJob;
 }
 export declare function newJobsFX(opts: JobsFXOptions): JobsFX;
 export {};

package/dist/src/jobs/jobs.js

@@ -3,8 +3,10 @@
 // Licensed under the Apache License, Version 2.0 (the "License"); you may
 // not use this file except in compliance with the License. You may obtain
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
-import { LocationTypePersistent, Pending, Started, Terminated, ZeroID, } from "@fabriktor/schema";
-import { errRequired, errValidation } from "../core/err.js";
+import { LocationTypePersistent, Pending, Started, OwnerIDKey, Terminated, ZeroID, } from "@fabriktor/schema";
+import { errRequired, errResolveFailed, errValidation, } from "../core/err.js";
+import { requiredOperationID, resolvedID } from "../core/id.js";
+import { runSearch } from "../core/search.js";
 const msgJobIDRequired = "Job ID is required.";
 const msgLocationIDRequired = "Location ID is required.";
 const msgMemberIDRequired = "Member ID is required.";
@@ -20,6 +22,15 @@ const msgLocationMemberAssigned = "Cannot remove a location member while they ar
 const msgDateInvalid = "Date contains an invalid UTC value.";
 const msgLocationRangeInvalid = "Location contains an invalid scheduled time span.";
 const msgTimezoneInvalid = "Program timezone is invalid.";
+const resourceLocation = "location";
+const resourceJobProgram = "job_program";
+const resourceJob = "job";
+const msgCreatedLocationIDMissing = "Created location response did not contain an ID.";
+const msgCreatedJobProgramIDMissing = "Created job program response did not contain an ID.";
+const msgCreatedJobIDMissing = "Created job response did not contain an ID.";
+const msgLocationMissing = "Location could not be resolved after the mutation.";
+const msgJobProgramMissing = "Job program could not be resolved after the mutation.";
+const msgJobMissing = "Job could not be resolved after the mutation.";
 export const JobProgramCreateMode = {
     Scheduled: "scheduled",
     Immediate: "immediate",
@@ -31,7 +42,62 @@ export class JobsFX {
         this.jobs = opts.jobs;
         this.now = opts.now ?? (() => new globalThis.Date());
     }
+    async createLocation(opts) {
+        const out = await this.jobs.insertOneLocation(opts);
+        const id = requiredOperationID(out, msgCreatedLocationIDMissing);
+        return await this.findLocation(id);
+    }
+    async replaceLocation(opts) {
+        await this.jobs.replaceOneLocation(opts);
+        return await this.findLocation(opts.id);
+    }
+    async searchLocations(opts) {
+        return await runSearch({
+            search: (searchOpts) => this.jobs.searchManyLocations(searchOpts),
+            query: {
+                [OwnerIDKey]: opts.owner_id,
+            },
+            q: opts.q,
+            page: opts.page,
+            per_page: opts.per_page,
+        });
+    }
+    async replaceJobProgram(opts) {
+        await this.jobs.replaceOneJobProgram(opts);
+        return await this.findJobProgram(opts.id);
+    }
+    async searchJobPrograms(opts) {
+        return await runSearch({
+            search: (searchOpts) => this.jobs.searchManyJobPrograms(searchOpts),
+            query: {
+                [OwnerIDKey]: opts.owner_id,
+            },
+            q: opts.q,
+            page: opts.page,
+            per_page: opts.per_page,
+        });
+    }
+    async replaceJob(opts) {
+        await this.jobs.replaceOneJob(opts);
+        return await this.findJob(opts.id);
+    }
+    async searchJobs(opts) {
+        return await runSearch({
+            search: (searchOpts) => this.jobs.searchManyJobs(searchOpts),
+            query: {
+                [OwnerIDKey]: opts.owner_id,
+            },
+            q: opts.q,
+            page: opts.page,
+            per_page: opts.per_page,
+        });
+    }
     async createJob(opts) {
+        const out = await this.createLocationJob(opts);
+        const id = requiredOperationID(out, msgCreatedJobIDMissing);
+        return await this.findJob(id);
+    }
+    async createLocationJob(opts) {
         const location_id = requiredID(opts.location.id, "location", msgLocationIDRequired);
         const foremen = normalizeIDs(opts.in.foremen);
         const current_members = unionIDs(opts.in.current_members, foremen);
@@ -58,6 +124,19 @@ export class JobsFX {
         });
     }
     async createJobProgram(opts) {
+        const out = await this.createLocationJobProgram(opts);
+        if (out.mode === JobProgramCreateMode.Immediate) {
+            return {
+                mode: JobProgramCreateMode.Immediate,
+            };
+        }
+        const id = requiredOperationID(out.create, msgCreatedJobProgramIDMissing);
+        return {
+            mode: JobProgramCreateMode.Scheduled,
+            job_program: await this.findJobProgram(id),
+        };
+    }
+    async createLocationJobProgram(opts) {
         const job_location_id = requiredID(opts.location.id, "location", msgLocationIDRequired);
         const job_foremen = normalizeIDs(opts.in.job_foremen);
         const job_current_members = unionIDs(opts.in.job_current_members, job_foremen);
@@ -200,6 +279,45 @@ export class JobsFX {
             },
         });
     }
+    async findLocation(id) {
+        const out = await this.jobs.findOneLocation({
+            id,
+        });
+        const location = out.value;
+        if (location === undefined) {
+            throw errResolveFailed({
+                resource: resourceLocation,
+                msg: msgLocationMissing,
+            });
+        }
+        return location;
+    }
+    async findJobProgram(id) {
+        const out = await this.jobs.findOneJobProgram({
+            id,
+        });
+        const job_program = out.value;
+        if (job_program === undefined) {
+            throw errResolveFailed({
+                resource: resourceJobProgram,
+                msg: msgJobProgramMissing,
+            });
+        }
+        return job_program;
+    }
+    async findJob(id) {
+        const out = await this.jobs.findOneJob({
+            id,
+        });
+        const job = out.value;
+        if (job === undefined) {
+            throw errResolveFailed({
+                resource: resourceJob,
+                msg: msgJobMissing,
+            });
+        }
+        return job;
+    }
 }
 export function newJobsFX(opts) {
     return new JobsFX(opts);
@@ -347,13 +465,6 @@ function requiredID(v, field, msg) {
     }
     return out;
 }
-function resolvedID(v) {
-    const out = v?.trim();
-    if (out === undefined || out === "" || out === ZeroID) {
-        return undefined;
-    }
-    return out;
-}
 function normalizeIDs(ids) {
     const seen = new Set();
     const out = [];